X-Financial/document/development/2026-06-25/feature/agent-change-log-split/TODO.md

写日志技能拆分 开发 TODO

更新时间：2026-06-25

文档路径：document/development/2026-06-25/feature/agent-change-log-split/TODO.md

使用规则

• 每个 TODO 必须对应 CONCEPT.md 中的目标、能力、方案或验收点。
• 只有完成并验证后，才能把 [ ] 改成 [x]。
• 勾选时在任务后补充简短证据，例如文件、接口、命令或验证结果。
• 如果需求发生变化，先更新 CONCEPT.md，再调整本 TODO。

1. 调研与边界

• [CONCEPT: 背景与问题] 确认旧日志 Skill、脚本、hook 和 AGENTS 仍指向 document/work-log/YYYY-MM-DD.md。 证据：rg -n "document/work-log|当日工作内容|遗留问题|TODO" AGENTS.md .codex/skills/agent-change-log tools/agent-change-log .githooks/post-commit。
• [CONCEPT: 目标与非目标] 明确本轮不迁移历史 document/work-log/*.md。 证据：CONCEPT.md 非目标已列明历史不迁移。

2. 契约与设计

• [CONCEPT: 功能能力] 定义 auto、bug、summary 三种脚本模式。 证据：tools/agent-change-log/update_change_log.py 的 --kind 参数。
• [CONCEPT: 数据与契约] 固定新路径 document/development/YYYY-MM-DD/dev-logs/bugs 与 work-logs.med。 证据：agent-change-log Skill、AGENTS 和脚本常量。

3. 后端实现

• [CONCEPT: 后端] 重写日志脚本，支持 bug 记录、auto 跳过非 bug、summary 聚合。 证据：tools/agent-change-log/update_change_log.py。
• [CONCEPT: 后端] 更新 post-commit hook，改为 --kind auto。 证据：.githooks/post-commit。

4. 算法/规则实现

• [CONCEPT: 算法与规则] 实现 bug-like commit 识别规则。 证据：looks_like_bug() 覆盖 fix、bugfix、修复、失败、异常 等关键词。
• [CONCEPT: 算法与规则] 实现 feature 和 bug 汇总生成 work-logs.med。 证据：build_daily_summary()。

5. 前端实现

• [CONCEPT: 前端] 当前不涉及前端页面。 证据：本轮只修改仓库 Skill、脚本、hook、文档和 automation。

6. 测试与验证

• [CONCEPT: 测试方案] 补充脚本回归测试。 证据：tools/agent-change-log/test_update_change_log.py。
• [CONCEPT: 测试方案] 运行脚本单测。 证据：python3 tools/agent-change-log/test_update_change_log.py，3 tests OK。
• [CONCEPT: 测试方案] dry-run 验证 bug 路径和 summary 路径。 证据：--kind bug --dry-run 输出 document/development/2026-06-25/dev-logs/bugs/draft-preview-disappears.md；--kind summary --dry-run 输出 document/development/2026-06-25/work-logs.med。

7. 文档收尾

• [CONCEPT: 指标与验收] 更新 agent-change-log Skill、AGENTS 和 README。 证据：.codex/skills/agent-change-log/SKILL.md、AGENTS.md、tools/agent-change-log/README.md。
• [CONCEPT: 指标与验收] 创建每日 17:00 Codex automation。 证据：automation id x-financial-daily-split-work-log。