autopilot-commit

Git 智能提交工作流

这是一个高效的 Git 提交工具，在提交前自动分析代码改动，调用相关优化技能，并生成高质量的提交信息。

核心原则

信任 AI 的智能判断：您已经具备强大的代码分析能力，本工具旨在提供框架而非限制您的判断。

高自由度设计：React 检测、优化应用、提交信息生成都依赖上下文判断，您可以根据具体情况选择最佳方法。

简洁高效：只提供必要的工作框架，避免过度指导。

并行优先：Phase 2 中的任务彼此独立，应在同一轮响应中并行发起（多个 Agent 或工具调用）。只有存在数据依赖时才串行等待。某个任务被跳过时不需要等待——直接标记跳过，继续推进。

假设需要证据：代码中对外部世界的假设（数据格式、接口行为、环境状态、第三方响应结构）不能仅凭文档或推理确认。提交前必须有运行时证据证明关键假设成立。这条原则贯穿 Bugfix 验证和代码理解测验。

上下文感知

autopilot-commit 有两种调用场景，需要智能判断并跳过多余步骤：

• 主链路模式：当前项目根目录存在活跃 autopilot 状态文件（.autopilot/runtime/active.ptr 指向的 .autopilot/runtime/requirements/<slug>/state.md，worktree 中位于 .autopilot/runtime/sessions/<name>/requirements/<slug>/state.md）且 phase 为 "merge" → 代码已通过五层 QA，跳过 Phase 1.5（代码优化）、Bugfix 验证、代码理解测验。再优化可能破坏已验证状态。
• 独立模式：其他所有情况 → 执行完整流程。

工作框架

创建一个简洁的任务列表来跟踪进度：

使用 TaskCreate 工具创建 Git 提交工作流：

Phase 1 — 基础分析（串行）
- [ ] 分析 Git 状态：检查可提交更改，分析改动内容和类型

Phase 1.5 — 代码优化（串行，会修改代码，后续任务需基于优化后的代码）
- [ ] 代码优化（条件性）：检测 React 代码 + 调用优化技能 + 用户确认
      跳过条件：主链路模式 / 无需优化

Phase 2 — 独立任务（并行执行，基于优化后的代码）
- [ ] Bugfix 验证（主链路模式跳过）
- [ ] 代码理解测验（主链路模式跳过）
- [ ] 项目元数据更新（CLAUDE.md + 版本号）

Phase 3 — 收尾流程（串行，等待 Phase 2 全部完成）
- [ ] 执行智能提交 + 任务同步（ai-todo）+ 提交总结

调度原则：

• Phase 1.5 串行执行，因为代码优化会修改文件，后续 bugfix 验证和代码测验必须基于优化后的代码
• Phase 1.5 无需优化时直接跳过，不阻塞流程
• Phase 2 的任务之间没有数据依赖，应尽可能在一轮响应中并行发起
• 需要用户交互的任务（如代码测验）与其他任务同时发起，等待用户回答期间其他任务已完成
• 任何 Phase 2 任务的失败或跳过不阻塞其他任务
• Phase 3 必须等待 Phase 2 全部完成（包括用户交互结束）

关键决策点

1. 代码优化（Phase 1.5，串行）

为何前置：代码优化会修改文件，必须在 bugfix 验证和代码测验之前完成，否则后续任务验证的是优化前的代码。

自主判断改动中是否涉及 React/前端代码，决定调用哪些优化技能：

• react best practice：React 最佳实践（检测到 React 代码时调用）
• code simple：代码简化（建议总是调用）

调用前向用户展示建议的改动，获得确认后应用。技能调用失败时记录警告并跳过（优雅降级）。

2. Bugfix 验证

目的：bugfix 提交时，拿到运行时证据证明修复生效——"修了就要验"。

触发条件：commit type 为 fix。无测试框架不等于跳过，而是切换验证模式。

两种验证模式：

• 自动化测试模式（项目有测试框架）：找到或创建对应测试 → 补充 bug 场景用例 → 运行相关测试确认通过 → 测试文件加入暂存区。
• 运行时验证模式（无测试框架，或 bug 涉及外部系统交互）：实际执行代码路径，获取运行时输出作为证据。手段由 AI 自主判断——curl 调接口、写临时脚本跑一次、启动 dev server 手动触发、读日志——任何能产出可观察证据的方式都行。