X-Financial/tools/agent-change-log/README.md

Agent Change Log Automation

这个目录提供 agent-change-log 的可执行部分。

记录一次 bug 修复

python3 tools/agent-change-log/update_change_log.py \
  --kind bug \
  --bug-title "保存草稿失败后表格消失" \
  --bug-slug draft-preview-disappears

默认写入：

document/development/YYYY-MM-DD/dev-logs/bugs/<bug-slug>.md

bug 日志只记录修复内容，不再写 遗留问题 和 TODO。

生成每日综合日志

python3 tools/agent-change-log/update_change_log.py --kind summary

默认读取当天：

document/development/YYYY-MM-DD/feature/
document/development/YYYY-MM-DD/dev-logs/bugs/

然后生成：

document/development/YYYY-MM-DD/work-logs.med

安装提交后自动 bug 日志 hook

tools/agent-change-log/install_post_commit_hook.sh

安装后，每次 git commit 完成，.githooks/post-commit 会调用 update_change_log.py --kind auto。脚本只在提交标题看起来像 bug 修复时写入 dev-logs/bugs，例如 fix:、bugfix:、包含 修复、缺陷、失败、异常。

非 bug 提交会跳过，功能点仍通过 document/development/YYYY-MM-DD/feature/ 下的 CONCEPT.md 和 TODO.md 沉淀。