用途:在用户以文字明确要求提交后,依据显式给出的文件或目录列表,创建可审查的原子 Git 提交。技能调用本身不构成授权,必须存在当前对话中的逐字提交请求。
主要能力:接收 CHANGE_PATHS(仓库相对路径,目录以 / 结尾,不支持通配符,大小写精确),可选 COMMIT_STYLE、CONTEXT_QUERY、CONTEXT_LOCATION、VERIFICATION_HINT。先由只读的 commit-boundary-planner 检查范围内状态与本地上下文并输出计划,经用户对完整计划一次性批准后,由 scoped-commit-executor 按批准顺序逐组提交,使用 git commit --only -- <paths>,使无关的已暂存条目保持暂存,并用摘要(digest)证明无关工作未被触碰。
使用方式:分四阶段执行——Intake 校验请求与路径、检查仓库状态;Plan 派发规划器;Gate G_PLAN_APPROVAL 原样打印计划并询问 approve、revise: <what to change> 或 stop;Execute 逐组提交。输出以 COMMIT_SCOPED_CHANGES: SUCCESS | NEEDS_CONTEXT | BLOCKED | NO_SCOPED_CHANGES | VERIFY_FAILED | COMMIT_ERROR | TOOLS_MISSING | ERROR 开头。规划轮次上限 3。
适用场景:把工作区拆分为原子提交、只提交某工单相关文件、让测试与代码一起提交等。
限制:不推送、不 amend、不改写历史、不使用 --no-verify、不编辑文件以通过检查、不暂存批准组之外的路径;仅运行只读验证。遇到合并、拣选、回滚、变基或二分状态时阻断。支持 Claude Code 与 OpenCode,需要相应读取与受限 git 命令权限。validate-by-observation 尚无评测用例。