# 写日志技能拆分 开发 TODO

更新时间：2026-06-25

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

## 使用规则

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

## 1. 调研与边界

- [x] [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`。
- [x] [CONCEPT: 目标与非目标] 明确本轮不迁移历史 `document/work-log/*.md`。
  证据：`CONCEPT.md` 非目标已列明历史不迁移。

## 2. 契约与设计

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

## 3. 后端实现

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

## 4. 算法/规则实现

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

## 5. 前端实现

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

## 6. 测试与验证

- [x] [CONCEPT: 测试方案] 补充脚本回归测试。
  证据：`tools/agent-change-log/test_update_change_log.py`。
- [x] [CONCEPT: 测试方案] 运行脚本单测。
  证据：`python3 tools/agent-change-log/test_update_change_log.py`，3 tests OK。
- [x] [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. 文档收尾

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