确认TODO是否真正失效需先验证引用关系与测试覆盖，再按规范删除并留痕；直接删除可能导致空值穿透或服务异常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认TODO是否真正失效
先别急着删，Codex 生成的 TODO 往往嵌在条件分支、异常兜底或未覆盖的测试路径里，直接删除可能让 null 值穿透到 UI 层。打开终端，进入项目根目录，运行：grep -r "TODO\|FIXME" . --include="*.ts" --include="*.js" --include="*.py" -n | head -20。只看前20行，重点找带上下文的：比如 // TODO: handle empty user list → if (users.length === 0) { ... } 这类紧贴代码逻辑的注释，它们大概率还在起作用。
若某处 TODO 出现在已废弃模块（如 src/legacy/auth-v1.ts）且该文件三个月内无 git 提交记录，则标记为高优先级清理目标；若它出现在 src/api/client.ts 且最近一次修改是昨天，必须先查调用链——【跳过这步直接删，可能让下游服务返回 500 而非友好提示】。
用 Codex 定向扫描并验证引用关系
启动 Codex CLI，确保当前会话已加载目标项目（执行 /status 确认状态为 project: loaded）。输入以下指令：
方法一：基于文件路径精准定位
“请扫描 src/utils/logger.ts 中所有 TODO 注释，对每一条输出：① 所在行号 ② 是否被任何 import 或 require 语句间接引用（包括通过 re-export、类型导入、动态 import()）③ 若未被引用，列出其所在函数名及该函数是否被测试文件覆盖”。
方法二：跨文件依赖图分析（需项目含 tsconfig.json）
“生成依赖图命令：npx depcruise --exclude node_modules --include-only '^src/' --output-type dot src/utils/logger.ts | dot -Tpng -o todo-deps.png；再检查该文件中每个 TODO 行是否落在 depcruise 报告的‘unreachable’节点内”。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
注意：Codex 若返回“未发现引用”，必须手动验证——在 VS Code 中右键点击该 TODO 上方函数名 → “Find All References”，【IDE 的引用搜索比 Codex 更可靠，尤其对类型导入和字符串拼接路径】。
执行清理并强制留痕
第一步：生成带理由的清理补丁
向 Codex 输入：“基于上一步结果，为 src/utils/logger.ts 生成 file_write 补丁，仅删除被标记为‘未引用’且‘测试未覆盖’的 TODO 行；每删一行，必须在上一行插入 // REMOVED-VIA-CX-20261014: [原TODO内容]；禁止合并相邻空行。”
第二步：应用补丁并验证
Codex 返回补丁后，不要直接执行。先用 git apply --check 验证补丁可应用；再运行 npm test -- --testPathPattern=logger 确保所有 logger 相关测试仍通过；最后执行 codex exec --patch patch.json 应用修改。
第三步：提交时绑定清理依据
提交信息必须包含三要素：被删 TODO 行号、引用扫描命令输出摘要、测试覆盖率变化值。例如：chore(logger): remove unused TODO at L42,L87 via grep+depcruise scan; coverage +0.2%。
