How this skill is triggered — by the user, by Claude, or both
Slash command
/autopilot:autopilot-commitThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
这是一个高效的 Git 提交工具,在提交前自动分析代码改动,调用相关优化技能,并生成高质量的提交信息。
这是一个高效的 Git 提交工具,在提交前自动分析代码改动,调用相关优化技能,并生成高质量的提交信息。
信任 AI 的智能判断:您已经具备强大的代码分析能力,本工具旨在提供框架而非限制您的判断。
高自由度设计:React 检测、优化应用、提交信息生成都依赖上下文判断,您可以根据具体情况选择最佳方法。
简洁高效:只提供必要的工作框架,避免过度指导。
并行优先:Phase 2 中的任务彼此独立,应在同一轮响应中并行发起(多个 Agent 或工具调用)。只有存在数据依赖时才串行等待。某个任务被跳过时不需要等待——直接标记跳过,继续推进。
假设需要证据:代码中对外部世界的假设(数据格式、接口行为、环境状态、第三方响应结构)不能仅凭文档或推理确认。提交前必须有运行时证据证明关键假设成立。这条原则贯穿 Bugfix 验证和代码理解测验。
autopilot-commit 有两种调用场景,需要智能判断并跳过多余步骤:
.claude/autopilot.local.md 且 phase 为 "merge" → 代码已通过五层 QA,跳过 Phase 1.5(代码优化)、Bugfix 验证、代码理解测验。再优化可能破坏已验证状态。在 worktree 中时,检查 worktree 根目录的 .claude/autopilot.local.md。创建一个简洁的任务列表来跟踪进度:
使用 TaskCreate 工具创建 Git 提交工作流:
Phase 1 — 基础分析(串行)
- [ ] 分析 Git 状态:检查可提交更改,分析改动内容和类型
Phase 1.5 — 代码优化(串行,会修改代码,后续任务需基于优化后的代码)
- [ ] 代码优化(条件性):检测 React 代码 + 调用优化技能 + 用户确认
跳过条件:主链路模式 / 无需优化
Phase 2 — 独立任务(并行执行,基于优化后的代码)
- [ ] Bugfix 验证(主链路模式跳过)
- [ ] 代码理解测验(主链路模式跳过)
- [ ] 项目元数据更新(CLAUDE.md + 版本号)
Phase 3 — 收尾流程(串行,等待 Phase 2 全部完成)
- [ ] 执行智能提交 + 任务同步(ai-todo)+ 提交总结
调度原则:
为何前置:代码优化会修改文件,必须在 bugfix 验证和代码测验之前完成,否则后续任务验证的是优化前的代码。
自主判断改动中是否涉及 React/前端代码,决定调用哪些优化技能:
调用前向用户展示建议的改动,获得确认后应用。技能调用失败时记录警告并跳过(优雅降级)。
目的:bugfix 提交时,拿到运行时证据证明修复生效——"修了就要验"。
触发条件:commit type 为 fix。无测试框架不等于跳过,而是切换验证模式。
两种验证模式:
核心原则:
语言:全部使用中文(type 标签除外)
格式:type(scope): 业务描述 (技术说明)
type 选取:
feat 新功能 / fix 修复 / perf 性能 / refactor 重构style 样式 / docs 文档 / chore 杂项 / test 测试示例:
feat(报告): 支持一键导出 PDF (新增导出 API + 前端按钮)
fix(登录): 修复登录后页面空白 (useEffect 缺少依赖导致重渲染)
perf(列表): 长列表滚动更流畅 (虚拟化渲染,DOM 节点从 500→30)
refactor(Auth): 简化鉴权逻辑 (合并重复的 token 校验分支)
chore: 升级依赖版本
禁止:
目的:Vibe Coding 时代,开发者的核心价值是有效监督 AI 产出。测验聚焦"为什么"和"会怎样",而非代码表面细节。
防合理化指南:
| 借口 | 现实 |
|---|---|
| "改动很小,不需要测验" | 小改动也需要开发者理解上下文。 |
| "用户赶时间" | 跳过测验 = 让用户签收看不懂的代码。2 分钟的测验防止日后的维护灾难。 |
| "这只是重构,逻辑没变" | 重构改变了结构,开发者需要理解新结构的设计权衡。 |
基本原则:
出题指南:
AskUserQuestion,1-2 道场景判断题答错处理:
两项子任务,根据改动类型决定是否执行:
a) CLAUDE.md 更新 — 当新增/删除模块、结构变化、配置变更、工作流调整时:
.autopilot/ 存在且有新增内容,确认 CLAUDE.md 中有对知识库目录的提及b) 版本号升级 — 当 commit type 为 feat/fix/perf 时:
feat → minor 升级(1.2.x → 1.3.0),breaking change → major 升级fix/perf → patch 升级(1.2.0 → 1.2.1)grep -rn '当前版本号' 确认所有包含版本号的文件git add目的:提交完成后,将本次提交与任务管理系统同步,保持开发进度可追踪。
前置检查:使用 Bash 工具执行 which ai-todo 检查是否可用,不可用则静默跳过。
执行步骤:
ai-todo tasks:tree 查看完整任务树ai-todo --help 查看当前可用命令工作流最后一步,输出一个表格让用户快速掌握本次提交全貌。面向用户表达,不讲细碎技术点。多 git 仓库时分开说明。
npx claudepluginhub strzhao/autopilot --plugin autopilotCreates git commits with repo detection, pre-commit checks, submodule support, and conventional messages. Activates on /commit or git commit requests.
Manages Git commit workflow using Conventional Commits format with safety protocols. Creates, validates, executes commits; handles hooks, PRs, and safety checks before operations.
Creates semantic git commits with conventional commit format, stages changes, and pushes to remote. Handles pre-commit hooks and writes meaningful commit messages.