claude-code-autopilot

Claude Code AutoPilot Plugin v1.1.0

极简4命令设计24小时无人值守执行系统 - 基于官方最佳实践架构，智能自动化执行

🎯 核心定位：

• ✅ 纯插件实现：完全依赖Claude Code原生能力，无外部依赖
• ✅ 本地Marketplace安装：符合官方插件规范，通过本地marketplace安装
• ✅ 严格工作流程：需求讨论→规划生成→按计划执行→状态更新→需求对齐
• ✅ JSON状态管理：结构化记录执行进度和决策过程
• ✅ 长时间执行支持：结构化的状态管理和恢复机制

🎉 v1.1.0 重大更新 - 极简设计 + 官方最佳实践：

• ✅ 极简命令设计：只需4个命令，大幅降低学习成本
• ✅ 官方最佳实践架构：采用agents/skills/commands标准架构
• ✅ 智能自动化执行：自动检测状态、恢复异常、管理上下文
• ✅ 专业化分工：需求分析师、执行规划师、质量保证专家协作
• ✅ 模块化技能系统：按需加载，提高效率，避免token浪费
• ✅ @文件引用机制：使用官方推荐的文件引用方式访问模板
• ✅ 结构化工作流：需求讨论→规划生成→按计划执行→持续对齐
• ✅ JSON状态管理：5个核心文件跟踪完整项目生命周期
• ✅ 智能恢复机制：异常检测和状态恢复，支持执行连续性
• ✅ 需求对齐：持续验证执行结果与原始需求的一致性

🎯 核心特性

🤖 严格工作流程约束

• 需求讨论优先：深度理解用户需求，确认所有细节
• 规划文档生成：基于讨论结果生成详细执行计划
• 按计划执行：严格按照规划执行，及时更新状态
• 需求对齐检查：持续验证执行结果与原始需求的一致性

📝 JSON状态文件系统

• 5个核心状态文件：覆盖完整的项目生命周期
• 实时状态跟踪：记录任务执行、质量评分、决策过程
• 状态一致性验证：确保各状态文件间的数据一致性
• 智能恢复机制：异常中断后的状态恢复和数据修复

🔄 纯插件执行模式

• slash命令驱动：所有功能通过标准slash命令访问
• 智能上下文管理：避免对话长度限制，保持执行连续性
• 自动状态维护：Claude Code自动读取和更新JSON状态文件
• 需求对齐确认：每个重要节点都验证与需求的一致性

📋 系统要求

基本要求

• Claude Code：已安装并正常运行
• 项目目录：任何现有项目目录或空目录
• 纯插件实现：无需额外依赖工具

验证Claude Code

# 检查Claude Code版本
claude --version

# 测试基本功能
claude --dangerously-skip-permissions
/help

🚀 快速开始

1. 安装插件

全局安装（推荐）

步骤1：下载插件源码

# 克隆插件仓库（只需要执行一次）
git clone https://github.com/x-rush/claude-code-autopilot.git

步骤2：在Claude Code中添加本地marketplace并安装

# 启动Claude Code
claude --dangerously-skip-permissions

# 添加本地marketplace（使用你的实际路径）
/plugin marketplace add /path/to/claude-code-autopilot

# 安装插件
/plugin install claude-code-autopilot@claude-code-autopilot

# 验证插件安装
/help | grep autopilot

安装优势：

• ✅ 全局可用：一次安装，所有项目都可以使用
• ✅ 符合官方规范：通过标准marketplace机制安装
• ✅ 简单直接：只需几个命令完成安装
• ✅ 自动管理：Claude Code自动处理插件加载和更新

示例：

# 假设你把插件克隆到了 ~/dev/claude-code-autopilot
/plugin marketplace add ~/dev/claude-code-autopilot
/plugin install claude-code-autopilot@claude-code-autopilot

2. 启动AutoPilot工作流

启动Claude Code

claude --dangerously-skip-permissions

启动连续执行流程

/autopilot-start

3. 三阶段执行流程

第一阶段：需求深度讨论

Claude将引导你进行结构化的需求讨论：

1. 核心目标确认

   • 最终想要的具体成果
   • 成果的使用场景和用户群体
   • 成功的质量标准和验收条件

2. 执行细节挖掘

   • 技术实现偏好和风格要求
   • 风险容忍度和特殊约束
   • 质量标准和完整性要求

3. 决策点识别

   • 识别所有可能的决策点
   • 为每个决策点预设解决方案
   • 建立决策优先级和备选方案

第二阶段：执行计划生成

基于需求讨论生成完整的执行计划：

1. TODO任务分解

   • 将需求分解为具体的可执行任务
   • 确定任务间的依赖关系和执行顺序
   • 为每个任务设定验收标准

2. 状态文件初始化

   • 生成5个核心JSON状态文件
   • 建立需求对齐配置
   • 设定决策框架和质量标准

第三阶段：按计划自主执行

严格按规划执行，持续更新状态：

1. 任务执行

   • 按照TODO清单顺序执行任务
   • 每个任务完成后立即更新状态
   • 记录质量评分和执行备注

2. 状态维护

   • 实时更新TODO_TRACKER.json
   • 记录决策过程到DECISION_LOG.json
   • 维护EXECUTION_STATE.json

3. 需求对齐检查

   • 定期验证执行结果与原始需求
   • 确认没有偏离预期目标
   • 必要时调整执行策略

📊 简化的命令体系

四个核心命令

🚀 启动工作流

/autopilot-start          # 启动完整工作流
/autopilot-start --quick  # 快速启动模式

📊 查看状态

/autopilot-status                # 完整状态报告
/autopilot-status --quick       # 快速概览
/autopilot-status --progress    # 仅进度信息
/autopilot-status --alignment   # 仅需求对齐
/autopilot-status --quality     # 仅质量指标

⚡ 继续执行

/autopilot-continue             # 智能继续执行
/autopilot-continue --recover   # 恢复中断执行
/autopilot-continue --refresh   # 刷新上下文

❓ 帮助指南

/autopilot-help            # 完整使用指南
/autopilot-help --trouble  # 故障排除指南

📁 项目结构（v1.0.0 最佳实践架构）