mcpField
A
auto-claude

auto-claude

github.com/travisjneumanAgent 工作流106131 次安装1 天前更新
代码仓库

关于 auto-claude

Auto-Claude 是面向成熟代码库的多 Agent 编码技能，用于实现明确的多文件功能。它会分析项目、生成计划，在隔离的 Git worktree 中协同实现，并通过迭代 QA 后交付审查。

主要功能

  1. 01代码库分析与语义基线
  2. 02生成实现规格
  3. 03多 Agent 协同自主编码
  4. 04隔离的 Git worktree 开发
  5. 05迭代式 QA 验证
  6. 06Graphiti 上下文记忆

适用场景

  1. 01添加身份验证或 API 功能
  2. 02实现表单与 CRUD 任务
  3. 03通过 QA 循环改进功能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/travisjneuman/.claude --skill auto-claude

安装后在 Claude Code 中输入/auto-claude确认已加载。

详细介绍

Auto-Claude：自主编码框架

用于复杂功能实现并通过 QA 验证的自主多 Agent 系统。

适用场景

✅ 适合使用 Auto-Claude 的场景：

  • 复杂度 3-4——定义明确的功能，涉及多个文件
  • 模式清晰的成熟代码库
  • 重复性任务（CRUD、表单、API 端点、身份验证流程）
  • 更倾向于最后统一审查，而非逐步审查
  • 需要通过 QA 验证进行迭代完善的功能

❌ 不适合使用 Auto-Claude 的场景：

  • 复杂度 1-2——改用手动 /start-task
  • 复杂度 5+——改用 /gsd:new-project
  • 从零开始的项目（没有现成的代码库模式）
  • 探索或研究任务（需求不明确）
  • 简单的错别字修正或配置更改
  • 实现期间需要人工决策的任务

快速指南：

  • 复杂度 1-2 → 手动实现
  • 复杂度 3-4 → Auto-Claude（自主实现）
  • 复杂度 5+ → GSD（多阶段）

核心功能

  1. 代码库分析——生成语义基线
  2. 规格生成——创建详细的实现计划
  3. 自主实现——多 Agent 协同
  4. Git Worktree 隔离——在独立 worktree 中安全开发
  5. QA 验证——迭代质量检查
  6. 记忆系统——由 Graphiti 驱动的上下文保留

工作流

# From project directory:
/auto-claude Add user authentication with JWT tokens

执行过程：

  1. 分析项目结构 → 生成基线
  2. 创建实现规格 → 存储在 ~/.auto-claude/specs/
  3. 创建 git worktree → 隔离的开发环境
  4. 自主 Agent 执行实现 → 并进行 QA 循环
  5. 返回已完成的代码 → 可供审查

输出位置： ~/.auto-claude/（已加入 gitignore）

与现有工作流集成

手动实现：

/start-task [description]  → Claude implements step-by-step

自主实现：

/auto-claude [description] → Auto-Claude implements autonomously

多阶段项目：

/gsd:new-project          → GSD for project management

配置

位置： ~/.auto-claude/.env

必需：

  • CLAUDE_CODE_OAUTH_TOKEN——在 Claude Code 的 /settings 中获取

可选（推荐）：

  • GRAPHITI_ENABLED=true——语义记忆
  • GOOGLE_API_KEY——用于 Gemini 嵌入（记忆功能）
  • 替代方案：Ollama（本地），或禁用记忆

权衡

优势：

  • 自主运行，只需极少监督
  • QA 验证确保质量
  • Git worktree 可避免影响主分支
  • 记忆功能可从以往会话中学习

局限：

  • 最适合成熟代码库
  • 需要明确的规格
  • 多 Agent 迭代会消耗令牌
  • 完成后需要手动合并

示例

适用场景：

  • “添加使用 JWT 令牌和会话管理的用户身份验证”
  • “实现可通过 localStorage 持久保存的深色模式切换”
  • “将 API 层从回调改为使用 async/await”
  • “为用户列表添加分页，每页显示 20 项”
  • “为报告添加导出为 CSV 的功能”

不适用场景：

  • “修复 README 中的错别字”（过于简单）
  • “探索状态管理的最佳方案”（探索性任务）
  • “构建整个电子商务平台”（规模过大，使用 GSD）
  • “让应用更好用”（过于含糊）

典型耗时

  • 分析： 30 秒
  • 规格生成： 1-2 分钟
  • 实现： 5-15 分钟（视复杂度而定）
  • QA 验证： 2-5 分钟
  • 你的审查： 5-10 分钟

总计： 大多数功能需要 15-30 分钟

相关内容

  • generic-feature-developer——手动实现模式
  • debug-systematic——系统化调试
  • test-specialist——测试策略

文档

请参阅 ~/.claude/docs/AUTO-CLAUDE-GUIDE.md，了解：

  • 完整的设置说明
  • 包含详细演练过程的真实示例
  • 故障排除指南
  • 性能提示
  • 与其他工作流的比较

评论

支持 Markdown