commitlisted

# 提交代码 在不覆盖用户本地工作的前提下创建 Git commit，并在需要时更新关联任务状态。 更新关联 `task.md` frontmatter 时，先读取 `.agents/rules/version-stamp.md`，并写入或刷新 `agent_infra_version`。 ## 常见违规借口与反驳 | 借口 | 反驳 | |------|------| | 「测试之前跑过了，不用重跑」 | 暂存内容是最新现实；提交前必须重新核对 `git status`/`git diff`，不能凭记忆。 | | 「`git add -A` 更省事」 | 禁止 `git add -A`/`git add .`；只暂存明确列出的文件，避免带入无关改动。 | | 「改了带版权头的文件，年份先不动」 | 改了就更新版权年份（动态取 `date +%Y`），这是提交前的硬性检查。 | ## 1. 检查本地修改（关键） 在任何编辑前先检查： ```bash git status --short git diff ``` 必须尊重现有用户改动；如果你的计划与之冲突，先停止并征求确认。 ## 2. 更新版权头年份 动态获取当前年份，只更新已经改动过的文件。 > 完整版权检查流程见 `reference/copyright-check.md`。修改任何版权头前，先读取 `reference/copyright-check.md`。 ## 3. 生成提交信息 检查状态、diff 和最近历史，然后按 Conventional Commits 生成 message，并补齐正确的协作署名。 > 提交信息规则、示例和多代理署名细节见 `reference/commit-message.md`。写 commit message 前先读取 `reference/commit-message.md`。 ## 4. 创建提交 只暂存明确列出的文件，然后执行 `git commit`。 ## 5. 按需更新任务状态 获取当前时间： ```bash date "+%Y-%m-%d %H:%M:%S%:z" ``` > 完整的 4 种状态分支、前置条件检查和多 TUI 下一步命令见 `reference/task-status-update.md`。更新任务状态前，先读取 `reference/task-status-update.md`。 > **重要**：向用户展示下一步时，必须完整输出所有 TUI 命令格式，并直接使用 `reference/task-status-update.md` 中对应场景的标准模板。如果 `.agents/.airc.json` 中配置了自定义 TUI（`customTUIs`），读取每个工具的 `name` 和 `invoke`，按同样格式补充对应命令行（`${skillName}` 替换为技能名，`${projectName}` 替换为项目名）。 追加 Commit 的 Activity Log，并且只能选择一个下一步分支： - 最终提交 -> `complete-task {task-id}` - 还有后续工作 -> 更新 task.md 后停止 - 准备审查 -> `review-code {task-id}` - 准备创建 PR（仅项目启用 PR 流程，即 `requiresPullRequest !== false`）-> `create-pr` ## 6. 同步 Issue 元数据（按需）