用途:这是 AGENTS.md “Landing the Plane” → Mode B 协议的用户可调用形式,适用于非隔离代理与会话。当 $ARGUMENTS 指向某个可收尾的范围或分支时运行。资料强调:推送经过验证后工作才算完成。隔离 worktree 工作者(agent frontmatter 声明 isolation: worktree)应使用 Mode A,在指定分支提交并向编排者汇报,不推送;不要把本技能用于那里。
主要能力与步骤:一、预检:运行 git status,逐条读取已修改、已删除、未跟踪条目,显式交代每个文件,不静默遗留也不盲目扫入;禁止 git add -A 与 git add .,须用显式路径(如 git add path/to/file.ts path/to/other.ts);若 $ARGUMENTS 指定范围或分支,需确认清单与其一致,不夹带无关脏文件。二、门禁:按 .claude/rules/code-quality.md 跑测试、linter、类型检查、构建;门禁失败即停止,修复或显式交接(issue 加任务列表条目),绝不带着红灯提交。三、提交:一个逻辑变更一个提交,写原子且描述性的信息;提交命令单独一行,不接在 && 后;用 git log -1 确认落地。四、同步:git pull --rebase、git push、git status 必须显示 up to date with origin;解决冲突后若变基触及代码需重跑门禁;报告 git rev-parse HEAD 的 SHA 作为证据。五、交接:向 main 开 PR(主干开发,不堆叠分支),PR body 用文件(heredoc 或临时文件)传入;填 .github/PULL_REQUEST_TEMPLATE.md 的 Provenance 字段与 Risk Tier;剩余工作记为 issue 或任务列表条目并引用 ./artifacts/ 产物;释放工作状态(清理 stash、临时文件、锁),交付物不引用 ./scratchpad/;若 scratchpad/corrections.log 非空,将每条映射到最强执行层级(规则编辑 < 技能编辑 < hook < permissions.deny/CI)并通过小 PR 或 issue 提升,随后移除已处理行。
失败分支:推送被拒(非快进)时 git pull --rebase 后重试一次,仍失败则停止并报告,不 force-push、不循环;门禁失败立即停止并原样报告失败命令输出;无可提交内容时不静默退出,仍执行同步验证并明确说明工作区已干净且同步。
限制:禁止 git add -A / git add .;禁止链式 && 提交;禁止越过失败门禁提交;禁止用 force-push 解决推送被拒;不得把“可以推送”当作完成。相关技能:testing、swarm-coordination;交接去向 /swarm-review 或 issues/任务列表。