Back to Easydict

Agent 提交结果统一报告

docs/histories/2026-08/2026-08-21-agent-commit-result-reporting.md

2.22.01.6 KB
Original Source

Agent 提交结果统一报告

  • 日期:2026-08-21
  • 状态:completed
  • 关联 Issue/PR:none
  • 执行计划:../../exec-plans/completed/2026-08-21-agent-commit-result-reporting.md

用户请求

统一提交和 worktree 集成完成后的报告,明确提交动作和完整提交内容,并增加总变动、 代码变动和文档变动信息;二进制变动无需展示。

设计意图

git-commit 成为单提交结果的唯一报告契约,避免调用工作流各自维护不一致的模板。 文本行统计由可测试脚本从 Git 原始数据计算,worktree-rebase-merge 只补充提交来源和 集成状态。

主要变更

  • git-commit 增加基于 Git numstat 的确定性统计脚本,互斥统计代码与文档文本变动。
  • 增加临时 Git 仓库行为测试,覆盖混合文件、分类、重命名、中文和空格路径、删除、 多提交区间、空提交与无效 revision。
  • 规定成功提交必须展示完整提交哈希、完整实际提交信息、工作树、push 和三组文本变动统计。
  • worktree-rebase-merge 区分本次创建和复用已有提交;单提交复用统一报告,多提交 使用提交列表与区间统计。
  • 在仓库自动提交规则中明确完整提交结果属于交付的一部分。

验证

  • 统计脚本 6 个行为测试通过。
  • Python 语法检查通过。
  • 统计脚本对真实历史提交试运行通过,代码、文档和总计可复算。
  • 两个 skill 的静态检查通过。
  • git diff --check 通过。
  • 未运行 xcodebuild,因为没有修改产品代码、测试或 Xcode 工程。

后续事项

无。