用途:当工作区中存在跨多个上下文、目的不同的未提交改动时,将改动拆分为若干个逻辑清晰、可独立理解与审查的小提交;若所有改动同属一个逻辑单元,则按普通方式提交即可。
主要能力:先收集仓库状态(运行 git status --short、git diff HEAD、git ls-files --others --exclude-standard,并读取未跟踪文件内容),再按优先级分组:同一功能、同一层次(API/模型/前端/配置/测试/文档)、同一目的(新功能、修复、重构、配置),最后逐组执行微提交。提交信息格式为 git commit -m "<type>(<scope>): <description>",类型前缀包括 feat、fix、refactor、docs、style、test、chore。
使用方式:在支持委派的宿主环境中,可将全部 Git 操作(状态检查、暂存、提交)交给一个子代理执行;若委派不可用或被禁止,则直接在主会话按同一流程执行。子代理可选用低成本快速模型,但须遵循宿主文档中的模型标识与选择机制,不得臆造模型名或参数,并尊重用户与项目的显式模型设置;无法选择时使用宿主默认模型,直接执行时沿用当前模型。
限制与注意:暂存时必须逐文件使用 git add <file>,禁止使用 git add . 或 git add -A,以免破坏分组边界;保持一次提交只含一个逻辑改动,按组顺序处理;若某次提交失败(例如 pre-commit 钩子报错),应报告错误并停止,不得强行跳过钩子。全部提交后运行 git status 确认工作区干净,并返回摘要报告,包含提交哈希、信息、涉及文件、遇到的错误与跳过的文件,以及最终仓库状态(分支名、领先远程的提交数、工作区状态)。
适用场景:工作区中同时包含功能、重构、配置等多种改动;即将发起 PR,希望历史整洁可读。具体委派工具与可用模型因宿主环境而异,资料未提供具体工具名称与模型清单。