提交流程
在用户请求提交、暂存或准备变更进行提交时使用。
步骤
- 运行文档生成 — 首先激活/运行
gen-docs技能,根据代码变更更新文档。 - 检查当前变更 — 运行
git status和git diff(或git diff --cached)以查看具体有哪些变更。 - 审查代码 — 阅读已修改/新增的文件,了解实际需要的内容。
- 仅暂存必要代码 — 直接读取文件;添加包含真实必要变更的文件。对于看起来无关、临时或不明确的文件,应向用户提问:“是否应暂存
<file>?它包含<简要摘要>”——不要自行假设。 - 根据代码变更生成信息 — 从实际差异/内容中推导提交信息(例如
feat: add docs for skills a)。 - 与用户确认 — 展示建议的提交信息、文档生成结果和已暂存文件,在提交前请求批准(
yes/approve)。 - 提交代码 — 使用已批准的信息运行
git commit,然后显示已提交内容的简要摘要。 - 询问推送 — 询问用户是否想要推送(
git push)。
规则
- 在此流程中直接使用
git、read_file、write_file和文件工具——无需为每次工具调用请求许可。 - 如果不确定某个变更是否必要,询问:“是否应暂存
<file>?它包含<简要摘要>” - 在提交前运行
gen-docs。 - 从实际差异中推导提交信息(格式示例:
feat: add docs for skills a)。 - 在
git commit和git push前需用户确认(yes/approve);其他步骤直接执行。