★ FEATURED ARTICLE 像专家一样提交代码agent-toolkit高质量Git提交技能实战指南【免费下载链接】agent-toolkitA curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.项目地址: https://gitcode.com/gh_mirrors/agentt/agent-toolkitagent-toolkit 是一个为 AI 编程助手打造的技能工具包其中的commit-work 技能专注高质量 Git 提交自动审查改动、智能拆分提交、撰写规范的提交信息并拦截密钥泄露等常见错误。本文面向新手带你快速掌握这个 Git 提交技能的完整用法。 commit-work 技能是什么agent-toolkit 中的技能Skill是打包好的指令和脚本用来扩展 AI 助手在不同工作流中的能力。commit-work 是其中面向Git 提交场景的技能目标是帮你产出容易评审、安全可上线的提交✅ 确保只包含你真正想提交的改动✅ 把混杂的改动拆分为逻辑清晰的多个提交✅ 写清楚改了什么 为什么改的提交信息✅ 遵循 Conventional Commits 规范✅ 拦截密钥、调试代码、无关格式化等常见坑技能文档位于 skills/commit-work/README.md完整的 AI 执行指令见 skills/commit-work/SKILL.md。 快速上手三步安装 commit-work 技能第 1 步克隆仓库git clone https://gitcode.com/gh_mirrors/agentt/agent-toolkit.git cd agent-toolkit第 2 步拷贝技能到 AI 助手目录以 Claude Code 为例把技能目录复制到本地技能目录即可cp -r skills/commit-work ~/.claude/skills/第 3 步直接开口说需求技能通过自然语言触发试试这些说法你说……技能做什么commit this work审查改动并创建规范提交split these changes into commits把混杂改动拆分为多个提交write a commit message为你撰写 Conventional Commits 格式提交信息help me commit全程引导暂存、审查、验证、提交✨ 四大核心亮点1️⃣ 智能拆分提交当你一次改了很多东西时技能会自动按功能 vs 重构后端 vs 前端格式化 vs 逻辑测试 vs 生产代码等维度拆分。例如一次格式化 新功能 补测试的混合改动会被拆成 3 个独立提交# Commit 1: chore: format code with prettier # Commit 2: feat(api): add user profile endpoint # Commit 3: test: add coverage for profile endpoint2️⃣ Conventional Commits 规范提交信息所有提交统一采用业界通用的type(scope): 简短摘要格式一眼看懂每次提交的意图。3️⃣ 补丁级精确暂存同一个文件里既有修复又有重构技能会用git add -p按代码块hunk粒度精确挑选先提交修复再提交重构互不干扰。4️⃣ 提交前安全审查暂存后自动检查是否混入密钥或 Token、是否残留调试日志、是否夹杂无关格式化改动——这些事故隐患都会在提交前被拦下。 八步工作流技能如何一步步工作commit-work 内置了一套严格的 8 步检查清单详见 skills/commit-work/SKILL.md步骤名称做什么1 检查用git status和git diff审查工作区2✂️ 定边界判断改动是否需要拆分为多个提交3 精确暂存用git add -p只暂存属于本次提交的部分4 复核暂存用git diff --cached检查密钥、调试日志等隐患5 描述先用一两句话说清改了什么 为什么说不清就回去拆分6✍️ 写信息生成 Conventional Commits 格式的完整提交信息7 验证提交前跑一遍最快的单元测试 / lint / 构建8 循环重复上述步骤直到工作区完全干净执行完成后技能会交付最终提交信息、每个提交的改了什么/为什么摘要、使用的暂存与审查命令以及测试验证结果。 提交信息模板详解技能使用的提交信息模板遵循 Conventional Commits结构如下type(scope): summary What changed. Why it changed.几个小规则模板来源skills/commit-work/references/commit-message-template.md摘要用祈使句以 Add / Fix / Remove / Refactor 开头具体明确正文写行为与意图不写实现流水账破坏性变更在标题加!或添加BREAKING CHANGE:脚注常见类型速查类型用途示例feat新功能feat(api): add user profile endpointfix修复缺陷fix(auth): resolve token expiration edge caserefactor重构不改变行为refactor(ui): extract menu logic to custom hooktest测试相关test: add coverage for profile endpointchore杂务格式化、依赖等chore: format code with prettier 实战场景一次 bug 修复的完整过程假设你修复了登录接口 Token 过期边界问题对 AI 助手说commit this bugfix技能会依次执行git status git diff # 第1步审查改动 git add src/api/auth.js # 第3步精确暂存 git diff --cached # 第4步复核暂存内容最终生成一条高质量提交fix(auth): resolve token expiration edge case Previously tokens would fail validation within 1 second of expiry due to clock skew. Now includes 5-second grace period.再跑一遍相关单测验证通过后提交完成。整个过程你无需手写任何提交信息。✅ 专家级提交最佳实践清单技能遵循的最佳实践摘自 skills/commit-work/README.md建议内化为你的日常习惯先审查后暂存永远先看git diff再决定暂存什么有意识地暂存杜绝git add ./git add -A一锅端混合改动用补丁模式git add -p精确控制提交前复核git diff --cached确认实际将提交的内容一次提交只做一件事一个逻辑改动一个提交为评审者写作说清 what/why而非实现细节提交后跑测试每个提交都通过最基本的验证做到这些你的提交历史将轻松支持git bisect定位问题和 cherry-pick 挑选提交。 项目结构与延伸学习文件说明skills/commit-work/SKILL.md技能的 AI 执行指令8 步工作流原文skills/commit-work/README.md面向用户的完整文档与示例skills/commit-work/references/commit-message-template.mdConventional Commits 提交信息模板README.md项目总览全部技能、智能体与斜杠命令除了 commit-workagent-toolkit 还提供 session-handoff无缝交接 AI 会话、reducing-entropy精简代码库等技能搭配使用能让整个开发-提交-交接流程都保持专家水准。 上手提示把split these changes into commits设为你的口头禅——当改动变多时主动让技能拆分比事后手动整理提交历史轻松得多。【免费下载链接】agent-toolkitA curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.项目地址: https://gitcode.com/gh_mirrors/agentt/agent-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
