Community生产力与协作github.com

karrot0195/agent-skills-

提交工作流:先运行文档生成,仅暂存必要文件(对不确定的文件请求确认),根据实际差异生成提交信息,提交,显示摘要并询问是否推送。

agent-skills- 是什么?

该技能定义了一个结构化的 Git 提交工作流,旨在帮助 AI 代理(如 Claude Code、Cursor 等)安全、高效地执行提交操作。它会先运行 `gen-docs` 技能更新文档,然后检查 `git status` 和 `git diff` 以了解当前变更。核心逻辑是只暂存真正必要的文件:通过直接读取文件内容判断,对无关或不确定的文件会向用户请求确认(`“Should I stage <file>? It contains <brief summary>”`)。最后根据实际差异生成标准化的提交信息(如 `feat: add docs for skills a`),在提交和推送前两次请求用户确认(`yes`/`approve`)。该工作流适用于任何支持 Git 工具和文件读写工具的 AI 代理平台,通过减少不必要的文件暂存和自动生成清晰的提交信息,有效降低了误操作风险并提高了开发效率。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/karrot0195/agent-skills-/tree/HEAD/.agents/skills/commit-flow

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

提交流程

在用户请求提交、暂存或准备变更进行提交时使用。

步骤

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

规则

  • 在此流程中直接使用 git、read_file、write_file 和文件工具——无需为每次工具调用请求许可。
  • 如果不确定某个变更是否必要,询问:“是否应暂存 <file>?它包含 <简要摘要>”
  • 在提交前运行 gen-docs。
  • 从实际差异中推导提交信息(格式示例:feat: add docs for skills a)。
  • 在 git commit 和 git push 前需用户确认(yes/approve);其他步骤直接执行。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能