xinzhyu 发表于 2025-8-6 16:16:23

Claude-Code-Multi-Agent 开源发布,强大的claude code Subagent工作流

<p>开源了一套强大的<strong>Claude Code</strong>工作流,通过简单的指令以及协作即可完成难以完成的史诗级任务,个人一直在使用,分享出来给各位</p>
<p>部分subagent有待优化,可以根据自己的独立场景去自定义Subagent的提示词</p>
<p>仓库地址: https://github.com/Prorise-cool/Claude-Code-Multi-Agent</p>
<h1>多层智能代理协调系统 Claude-Code-Multi-Agent)</h1>
<blockquote>
<p><strong>Context Engineering 驱动的新一代AI编程助手生态系统</strong><br />
基于Claude Code构建的智能代理协调平台,实现从需求到交付的全流程自动化开发</p>
</blockquote>
<p>License: https://opensource.org/licenses/MIT<br />
Claude Code:https://claude.ai/<br />
Context Engineering:https://github.com/coleam00/context-engineering-intro</p>
<hr />
<h2>项目概述</h2>
<p>这是一个基于ContextEngineering理念构建的多层智能代理协调系统,通过100+个专业AI代理(全汉化)的协作,实现从项目需求分析到最终交付的全自动化开发流程。系统采用三层架构设计,结合Hook驱动的自动化机制,能够智能地选择和协调不同专业领域的代理,确保高质量的软件交付。</p>
<h3><strong>重要成本提醒</strong></h3>
<p><strong>Token消耗极快:构建一个完整的项目从文档到成品,大约要使用$10美元的token</strong></p>
<p>这个系统在处理复杂项目时会消耗大量的Claude API token,特别是在以下场景:</p>
<ul>
<li>多代理并行协作时的上下文传递</li>
<li>大型代码库的分析和重构</li>
<li>复杂架构设计的迭代优化</li>
<li>全面的测试套件生成和验证</li>
</ul>
<p>建议在使用前:</p>
<ol>
<li>设置合理的token使用限制</li>
<li>优先处理关键功能模块</li>
<li>合理根据自身需求使用不同复杂度的工作流</li>
</ol>
<h2>推荐MCP协同配置以达最佳效果</h2>
<p>为了充分发挥 <code>Claude-Code-Multi-Agent</code> 系统的全部潜力,我们强烈建议配置 <strong>模型上下文协议</strong>。通过启用一系列协同工作的MCP服务器,您可以为AI代理提供与外部世界交互、长期记忆、浏览器自动化等高级能力,从而实现更复杂、更可靠的自动化开发工作流。</p>
<h3><strong>配置方法</strong></h3>
<p>请将以下 <code>mcpServers</code> 配置代码块添加到您的 <code>.claude/settings.local.json</code> 文件中。如果文件不存在,请创建一个。</p>
<pre data-code-wrap="json" dir="auto" class="codeblock-buttons"><div class="codeblock-button-wrapper"></div></pre>
<pre><code class="language-json">{
&quot;mcpServers&quot;: {
    &quot;Context7&quot;: {
      &quot;command&quot;: &quot;cmd&quot;,
      &quot;args&quot;: [
      &quot;/c&quot;,
      &quot;npx&quot;,
      &quot;-y&quot;,
      &quot;@upstash/context7-mcp@latest&quot;
      ]
    },
    &quot;browsermcp&quot;: {
      &quot;command&quot;: &quot;cmd&quot;,
      &quot;args&quot;: [
      &quot;/c&quot;,
      &quot;npx&quot;,
      &quot;-y&quot;,
      &quot;@browsermcp/mcp@latest&quot;
      ]
    },
    &quot;mcp-feedback-enhanced&quot;: {
      &quot;command&quot;: &quot;cmd&quot;,
      &quot;args&quot;: [
      &quot;/c&quot;,
      &quot;python&quot;,
      &quot;-m&quot;,
      &quot;mcp_feedback_enhanced&quot;
      ],
      &quot;timeout&quot;: 600,
      &quot;autoApprove&quot;: [
      &quot;interactive_feedback&quot;
      ]
    },
    &quot;memory&quot;: {
      &quot;command&quot;: &quot;cmd&quot;,
      &quot;args&quot;: [
      &quot;/c&quot;,
      &quot;npx&quot;,
      &quot;-y&quot;,
      &quot;@modelcontextprotocol/server-memory@latest&quot;
      ]
    },
    &quot;playwright-mcp&quot;: {
      &quot;command&quot;: &quot;cmd&quot;,
      &quot;args&quot;: [
      &quot;/c&quot;,
      &quot;npx&quot;,
      &quot;-y&quot;,
      &quot;@smithery/cli@latest&quot;,
      &quot;run&quot;,
      &quot;@microsoft/playwright-mcp&quot;,
      &quot;--key&quot;,
      &quot;ec7ce98b-bb8a-4d8a-92aa-3bde30602c4c&quot;
      ]
    },
    &quot;sequential-thinking&quot;: {
      &quot;command&quot;: &quot;cmd&quot;,
      &quot;args&quot;: [
      &quot;/c&quot;,
      &quot;npx&quot;,
      &quot;@modelcontextprotocol/server-sequential-thinking&quot;
      ]
    },
    &quot;shrimp-task-manager&quot;: {
      &quot;command&quot;: &quot;cmd&quot;,
      &quot;args&quot;: [
      &quot;/c&quot;,
      &quot;npx&quot;,
      &quot;mcp-shrimp-task-manager&quot;
      ]
    }
}
}
</code></pre>
<h3><strong>核心MCP服务解析</strong></h3>
<table>
<thead>
<tr>
<th>MCP服务器</th>
<th>主要功能</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong><code>playwright-mcp</code></strong></td>
<td><strong>浏览器自动化</strong>: 授权代理通过Playwright控制浏览器,执行网页交互、端到端测试和数据抓取。</td>
</tr>
<tr>
<td><strong><code>memory</code></strong></td>
<td><strong>长期记忆</strong>: 提供一个持久化存储,让代理能够跨会话记住关键信息、上下文和用户偏好。</td>
</tr>
<tr>
<td><strong><code>sequential-thinking</code></strong></td>
<td><strong>顺序思维增强</strong>: 引导代理进行更结构化、逻辑化的思考,将复杂问题分解为有序步骤。</td>
</tr>
<tr>
<td><strong><code>mcp-feedback-enhanced(交互核心)</code></strong></td>
<td><strong>增强反馈循环</strong>: 建立一个交互式反馈机制,允许用户在任务执行过程中进行干预和指导。</td>
</tr>
<tr>
<td><strong><code>browsermcp</code></strong></td>
<td><strong>通用浏览器控制</strong>: 提供一个轻量级的浏览器交互接口。</td>
</tr>
<tr>
<td><strong><code>shrimp-task-manager</code></strong></td>
<td><strong>任务管理</strong>: 一个专用的任务管理服务,用于更精细地跟踪和控制自动化任务的执行状态。</td>
</tr>
</tbody>
</table>
<blockquote>
<p><strong>注意</strong>:</p>
<ul>
<li>启用这些MCP服务可能需要在您的本地环境中安装相应的依赖,例如 <strong>Node.js (用于 <code>npx</code>)</strong> 和 <strong>Python</strong>。</li>
<li>部分服务如 <code>playwright-mcp</code> 在首次运行时会自动下载浏览器驱动,请确保您的网络连接正常。</li>
</ul>
</blockquote>
<h2>系统架构</h2>
<h3>三层代理架构</h3>
<p><img src="https://images.bigseek.com//forum/202508/06/162027iduztuf5jo3gju9f.png" alt="图片.png" title="图片.png" /></p>
<h1>目录结构</h1>
<blockquote>
<p>#目录架构</p>
<p>📦 agents               # 顶层代理目录,包含所有不同类型的AI代理<br />
├── 📄 auto-task-executor.js    # 自动任务执行器,用于自动化执行特定任务的脚本或配置<br />
├── 📄 directory_tree.md      # 目录结构文档,描述整个代理目录的组织方式<br />
└── 📄 task-execution-agent.js# 任务执行代理,负责接收并处理任务执行指令<br />
├── 📂 bonus            # 额外代理目录,包含一些特殊或辅助性的代理<br />
├── 📄 joker.md             # 小丑代理,可能用于生成幽默内容或进行非常规操作<br />
└── 📄 studio-coach.md      # 工作室教练代理,可能用于提供指导或培训<br />
├── 📂 core               # 核心代理目录,包含提供基础或通用功能的代理<br />
├── 📄 code-archaeologist.md# 代码考古学家代理,用于分析和理解遗留代码<br />
├── 📄 code-reviewer.md       # 代码审查代理,用于检查代码质量和发现潜在问题<br />
├── 📄 documentation-specialist.md # 文档专家代理,用于生成和维护项目文档<br />
└── 📄 performance-optimizer.md # 性能优化器代理,用于分析和提升系统性能<br />
├── 📂 databases          # 数据库代理目录,包含与数据库操作相关的代理<br />
├── 📄 customer-support.md    # 客户支持代理,可能与用户数据或支持系统数据库交互<br />
├── 📄 data-engineer.md       # 数据工程师代理,用于数据管道、ETL等操作<br />
├── 📄 data-scientist.md      # 数据科学家代理,用于数据分析和模型训练<br />
├── 📄 database-admin.md      # 数据库管理员代理,用于管理数据库操作和维护<br />
└── 📄 database-optimizer.md# 数据库优化器代理,用于优化数据库查询和结构<br />
├── 📂 deployment         # 部署代理目录,包含与软件部署和运维相关的代理<br />
├── 📄 debugger.md            # 调试器代理,用于识别和修复代码中的错误<br />
├── 📄 deployment-engineer.md # 部署工程师代理,负责自动化部署流程<br />
├── 📄 devops-troubleshooter.md # DevOps 故障排除代理,用于诊断和解决运维问题<br />
├── 📄 dx-optimizer.md      # 开发者体验优化代理,旨在提升开发效率和体验<br />
├── 📄 error-detective.md   # 错误侦探代理,用于日志分析和错误模式识别<br />
├── 📄 legacy-modernizer.md   # 遗留系统现代化代理,用于重构和升级旧系统<br />
├── 📄 network-engineer.md    # 网络工程师代理,用于网络配置、故障排除和优化<br />
├── 📄 payment-integration.md # 支付集成代理,用于处理支付系统相关的任务<br />
├── 📄 performance-engineer.md # 性能工程师代理,用于应用性能优化和可伸缩性<br />
├── 📄 prompt-engineer.md   # 提示工程师代理,用于设计和优化AI提示<br />
├── 📄 quant-analyst.md       # 量化分析师代理,可能用于金融或数据量化分析<br />
├── 📄 refactor-agent.md      # 重构代理,用于改进代码结构而不改变功能<br />
├── 📄 risk-manager.md      # 风险管理器代理,用于识别、评估和缓解项目风险<br />
├── 📄 sales-automator.md   # 销售自动化代理,用于自动化销售流程和营销活动<br />
├── 📄 search-specialist.md   # 搜索专家代理,可能用于优化搜索功能或内容索引<br />
└── 📄 security-auditor.md    # 安全审计师代理,用于审查代码安全性和合规性<br />
├── 📂 design             # 设计代理目录,包含与产品设计相关的代理<br />
├── 📄 brand-guardian.md      # 品牌守护者代理,确保产品符合品牌指南<br />
├── 📄 ui-designer.md         # UI 设计师代理,专注于用户界面视觉设计<br />
├── 📄 ui-ux-master.md      # UI/UX 大师代理,提供全面的用户体验和界面设计<br />
├── 📄 ux-researcher.md       # UX 研究员代理,专注于用户研究和需求分析<br />
├── 📄 visual-storyteller.md# 视觉故事讲述者代理,用于创建引人入胜的视觉叙事<br />
└── 📄 whimsy-injector.md   # 奇思妙想注入器代理,可能用于增加创意或趣味性元素<br />
├── 📂 engineering      # 工程代理目录,包含通用工程领域的代理<br />
├── 📂 backend            # 后端代理目录<br />
├── 📄 ai-engineer.md         # AI 工程师代理,专注于AI模型和服务的后端实现<br />
├── 📄 backend-architect.md   # 后端架构师代理,负责后端系统设计<br />
└── 📄 senior-backend-architect.md # 高级后端架构师代理,提供高级后端架构指导<br />
├── 📂 frontend         # 前端代理目录<br />
├── 📄 frontend-developer.md# 前端开发代理,专注于前端代码实现<br />
├── 📄 mobile-app-builder.md# 移动应用构建器代理,用于开发移动应用程序<br />
├── 📄 rapid-prototyper.md# 快速原型开发代理,用于迅速构建功能原型<br />
└── 📄 senior-frontend-architect.md # 高级前端架构师代理,提供高级前端架构指导<br />
└── 📂 middlend         # 中间层代理目录,可能包含一些跨前后端的通用服务或工具<br />
├── 📄 api-documenter.md      # API 文档编写代理,用于生成和维护API文档<br />
├── 📄 architect-review.md    # 架构审查代理,用于评审系统架构<br />
├── 📄 cloud-architect.md   # 云架构师代理,负责云平台架构设计和优化<br />
├── 📄 code-reviewer.md       # 代码审查代理(通用,可能与 core/code-reviewer.md 功能重叠或更侧重于特定方面)<br />
└── 📄 devops-automator.md    # DevOps 自动化代理,用于自动化运维流程<br />
├── 📂 marketing          # 市场营销代理目录,包含与市场推广相关的代理<br />
├── 📄 app-store-optimizer.md # 应用商店优化代理,用于提升应用在应用商店的可见性<br />
├── 📄 business-analyst.md    # 业务分析师代理,用于分析业务需求和市场趋势<br />
├── 📄 content-creator.md   # 内容创作者代理,用于生成营销内容<br />
├── 📄 growth-hacker.md       # 增长黑客代理,专注于通过实验和策略实现用户增长<br />
├── 📄 instagram-curator.md   # Instagram 内容策展代理,用于管理和优化 Instagram 内容<br />
├── 📄 reddit-community-builder.md # Reddit 社区建设代理,用于在 Reddit 上建立和管理社区<br />
├── 📄 tiktok-strategist.md   # TikTok 策略师代理,用于制定和执行 TikTok 营销策略<br />
└── 📄 twitter-engager.md   # Twitter 互动代理,用于在 Twitter 上进行互动和内容发布<br />
├── 📂 orchestrators      # 编排器代理目录,包含用于协调和管理其他代理的代理<br />
├── 📄 context-manager.md   # 上下文管理器代理,用于管理和维护会话或项目上下文<br />
├── 📄 project-analyst.md   # 项目分析师代理,用于对项目进行初始分析和评估<br />
├── 📄 team-configurator.md   # 团队配置器代理,用于设置和管理代理团队<br />
└── 📄 tech-lead-orchestrator.md # 技术主管编排器代理,作为高级协调者管理整个开发流程<br />
├── 📂 product            # 产品代理目录,包含与产品管理相关的代理<br />
├── 📄 feedback-synthesizer.md # 反馈合成器代理,用于收集和分析用户反馈<br />
├── 📄 sprint-prioritizer.md# Sprint 优先级排序代理,用于确定开发迭代中的任务优先级<br />
└── 📄 trend-researcher.md    # 趋势研究员代理,用于分析市场趋势和用户行为<br />
├── 📂 project-management # 项目管理代理目录,包含与项目管理相关的代理<br />
├── 📄 experiment-tracker.md# 实验跟踪器代理,用于跟踪和分析实验结果<br />
├── 📄 project-shipper.md   # 项目发布代理,负责项目的最终交付和发布<br />
└── 📄 studio-producer.md   # 工作室制作人代理,可能用于协调多媒体或内容制作项目<br />
├── 📂 specialist         # 专家代理目录,包含一些在特定领域具有深度专业知识的代理<br />
├── 📄 spec-analyst.md      # 规范分析师代理,用于需求获取和规范文档编写<br />
├── 📄 spec-architect.md      # 规范架构师代理,根据规范进行系统架构设计<br />
├── 📄 spec-developer.md      # 规范开发代理,根据详细规范进行代码实现<br />
├── 📄 spec-orchestrator.md   # 规范编排器代理,协调基于规范的开发流程<br />
├── 📄 spec-planner.md      # 规范规划代理,将设计分解为可执行任务<br />
├── 📄 spec-reviewer.md       # 规范审查代理,审查代码和设计是否符合规范<br />
├── 📄 spec-task-reviewer.md# 规范任务审查代理,验证开发任务的完成情况<br />
├── 📄 spec-tester.md         # 规范测试代理,创建和执行测试套件以验证规范<br />
└── 📄 spec-validator.md      # 规范验证代理,进行最终质量验证以确保符合所有规范和生产就绪<br />
├── 📂 specialized      # 专业化代理目录,包含按编程语言的框架....在这里可以添加您的编程语言规范,这里仅提供了一些模板<br />
├── 📂 C++                # C++ 语言专家代理<br />
└── 📄 cpp-pro.md         # C++ 编程专家代理<br />
├── 📂 databases          # 数据库专业代理 (可能与顶层 databases 目录下的代理功能互补)<br />
└── 📄 sql-pro.md         # SQL 编程和优化专家代理<br />
├── 📂 django             # Django 框架专家代理<br />
├── 📄 django-api-developer.md # Django API 开发代理<br />
├── 📄 django-backend-expert.md # Django 后端专家代理<br />
└── 📄 django-orm-expert.md # Django ORM 专家代理<br />
├── 📂 Golang             # Go 语言专家代理<br />
└── 📄 golang-pro.md      # Go 语言编程专家代理<br />
├── 📂 JavaScript         # JavaScript 语言专家代理<br />
└── 📄 javascript-pro.md    # JavaScript 编程专家代理<br />
├── 📂 laravel            # Laravel 框架专家代理<br />
├── 📄 laravel-backend-expert.md # Laravel 后端专家代理<br />
└── 📄 laravel-eloquent-expert.md # Laravel Eloquent ORM 专家代理<br />
├── 📂 Python             # Python 语言专家代理<br />
└── 📄 python-pro.md      # Python 编程专家代理<br />
├── 📂 rails            # Ruby on Rails 框架专家代理<br />
├── 📄 rails-activerecord-expert.md # Rails ActiveRecord 专家代理<br />
├── 📄 rails-api-developer.md # Rails API 开发代理<br />
└── 📄 rails-backend-expert.md # Rails 后端专家代理<br />
├── 📂 react            # React 框架专家代理<br />
├── 📄 react-component-architect.md # React 组件架构师代理<br />
└── 📄 react-nextjs-expert.md # React Next.js 专家代理<br />
└── 📂 vue                # Vue.js 框架专家代理<br />
├── 📄 vue-component-architect.md # Vue 组件架构师代理<br />
├── 📄 vue-nuxt-expert.md   # Vue Nuxt.js 专家代理<br />
└── 📄 vue-state-manager.md # Vue 状态管理专家代理<br />
├── 📂 studio-operations# 工作室运营代理目录,包含与日常运营相关的代理<br />
├── 📄 analytics-reporter.md# 分析报告代理,用于生成数据分析报告<br />
├── 📄 finance-tracker.md   # 财务跟踪代理,用于管理和跟踪财务数据<br />
├── 📄 infrastructure-maintainer.md # 基础设施维护代理,用于维护IT基础设施<br />
├── 📄 legal-compliance-checker.md # 法律合规性检查代理,确保符合法律法规<br />
└── 📄 support-responder.md   # 支持响应代理,用于处理用户支持请求<br />
├── 📂 testing            # 测试代理目录,包含与软件测试相关的代理<br />
├── 📄 api-tester.md          # API 测试代理,专注于API接口测试<br />
├── 📄 integration-test-fixer.md # 集成测试修复代理,用于修复集成测试中发现的问题<br />
├── 📄 performance-benchmarker.md # 性能基准测试代理,用于设定和执行性能基准测试<br />
├── 📄 test-automator.md      # 测试自动化代理,用于创建和管理自动化测试<br />
├── 📄 test-results-analyzer.md # 测试结果分析代理,用于分析测试报告<br />
├── 📄 test-writer-fixer.md   # 测试编写和修复代理,用于编写和修复测试用例<br />
├── 📄 tool-evaluator.md      # 工具评估代理,用于评估和选择开发工具<br />
└── 📄 workflow-optimizer.md# 工作流优化代理,用于优化开发和测试流程<br />
└── 📂 universal          # 通用代理目录,包含不特定于某个技术栈的通用代理<br />
├── 📄 api-architect.md       # API 架构师代理,设计通用API结构<br />
├── 📄 backend-developer.md   # 后端开发代理(通用)<br />
├── 📄 frontend-developer.md# 前端开发代理(通用)<br />
└── 📄 tailwind-css-expert.md # Tailwind CSS 专家代理,专注于CSS框架</p>
</blockquote>
<h2>核心指令系统</h2>
<h3>主要工作流指令</h3>
<h4>1. <code>/generate-prp</code> - PRP需求文档生成</h4>
<p><strong>用途</strong>:基于初步需求生成详细的产品需求提示文档</p>
<pre><code class="language-bash">/generate-prp INITIAL.md
</code></pre>
<p><strong>功能</strong>:</p>
<ul>
<li>深度分析功能需求</li>
<li>研究技术实现方案</li>
<li>生成全面的PRP文档</li>
<li>包含验证循环和质量标准</li>
</ul>
<h4>2. <code>/execute-prp</code> - PRP执行工作流</h4>
<p><strong>用途</strong>:根据PRP文档自动实现功能</p>
<pre><code class="language-bash">/execute-prp PRPs/your-feature-name.md
</code></pre>
<p><strong>功能</strong>:</p>
<ul>
<li>解析PRP需求和规范</li>
<li>创建详细实施计划</li>
<li>逐步执行代码实现</li>
<li>运行验证和测试</li>
</ul>
<h4>3. <code>/agent-workflow</code> - 中等难度自动化工作流</h4>
<p><strong>用途</strong>:处理中等复杂度的功能开发</p>
<pre><code class="language-bash">/agent-workflow &lt;功能描述&gt;
</code></pre>
<p><strong>执行流程</strong>:</p>
<pre><code class="language-markdown">spec-analyst → spec-architect → spec-developer → spec-validator → spec-tester
   ↓            ↓            ↓            ↓            ↓
需求分析      系统架构      代码实现      质量验证      测试验证
</code></pre>
<p><strong>质量门控</strong>:达到95%质量分数才继续下一阶段</p>
<h4>4. <code>/multi-agent-workflow</code> - 高难度复杂重构工作流</h4>
<p><strong>用途</strong>:处理复杂的系统重构和大型功能开发</p>
<pre><code class="language-bash">/multi-agent-workflow &lt;功能名称&gt;
</code></pre>
<p><strong>三层协调架构</strong>:</p>
<ol>
<li><strong>spec-orchestrator</strong> - 总协调,智能选择代理团队</li>
<li><strong>9个specialist主管</strong> - 领域专家协调和管理</li>
<li><strong>100+专业代理</strong> - 具体任务执行</li>
</ol>
<h3>Kiro工作流指令</h3>
<h4>5. <code>/kiro/spec</code> - 完整规格创建流程</h4>
<p><strong>用途</strong>:从粗略想法到完整实施规格的迭代流程</p>
<pre><code class="language-bash">/kiro:spec &lt;功能想法&gt;
</code></pre>
<p><strong>三阶段流程</strong>:</p>
<ol>
<li><strong>需求收集</strong> - 生成需求文档并与用户迭代确认</li>
<li><strong>设计创建</strong> - 基于需求进行技术设计和架构规划</li>
<li><strong>任务列表</strong> - 将设计分解为可执行的编程任务</li>
</ol>
<h4>6. <code>/kiro/execute</code> - 任务执行</h4>
<p><strong>用途</strong>:执行Kiro规格中的具体任务</p>
<pre><code class="language-bash">/kiro:execute &lt;功能名称&gt; &lt;任务描述&gt;
</code></pre>
<h3>思考和分析指令</h3>
<h4>7. <code>/think-ultra</code> - 超级思考模式</h4>
<p><strong>用途</strong>:处理复杂问题的深度分析和解决方案设计</p>
<pre><code class="language-bash">/think-ultra &lt;复杂问题描述&gt;
</code></pre>
<h4>8. <code>/reflection</code> - 反思和优化</h4>
<p><strong>用途</strong>:对已完成工作进行反思和改进建议</p>
<pre><code class="language-bash">/reflection &lt;要反思的内容&gt;
</code></pre>
<h4>9. <code>/eureka</code> - 技术突破记录</h4>
<p><strong>用途</strong>:记录和文档化技术突破和创新解决方案</p>
<pre><code class="language-bash">/eureka &lt;突破描述&gt;
</code></pre>
<h3>工具和辅助指令</h3>
<h4>10. <code>/gh/fix-issue</code> - GitHub问题修复</h4>
<p><strong>用途</strong>:自动化GitHub问题分析和修复流程</p>
<pre><code class="language-bash">/gh:fix-issue &lt;issue-number&gt;
</code></pre>
<h4>11. <code>/gh/review-pr</code> - PR审查</h4>
<p><strong>用途</strong>:代码审查和PR反馈</p>
<pre><code class="language-bash">/gh:review-pr &lt;pr-number&gt;
</code></pre>
<h4>12. <code>/cc/create-command</code> - 创建新指令</h4>
<p><strong>用途</strong>:创建自定义Claude Code指令</p>
<pre><code class="language-bash">/cc:create-command &lt;指令名称&gt; &lt;描述&gt;
</code></pre>
<h2>Hook自动化机制</h2>
<p>Hook系统实现了基于事件的自动化流程,配置在 <code>.claude/settings.local.json</code> 中:</p>
<h3>Hook事件类型</h3>
<h4>1. <strong>PreToolUse</strong> - 工具使用前触发</h4>
<pre><code class="language-json">{
    &quot;matcher&quot;: &quot;Task&quot;,
    &quot;hooks&quot;: [{
      &quot;type&quot;: &quot;command&quot;,
      &quot;command&quot;: &quot;node agents/todo-hook-manager.js validate-task-prerequisites&quot;,
      &quot;timeout&quot;: 10000
    }]
}
</code></pre>
<p><strong>触发场景</strong>:代理任务启动前的前置条件验证</p>
<h4>2. <strong>PostToolUse</strong> - 工具使用后触发</h4>
<pre><code class="language-json">{
    &quot;matcher&quot;: &quot;Edit|MultiEdit|Write&quot;,
    &quot;hooks&quot;: [{
      &quot;type&quot;: &quot;command&quot;,
      &quot;command&quot;: &quot;node agents/todo-hook-manager.js handle-file-change&quot;,
      &quot;timeout&quot;: 30000
    }]
}
</code></pre>
<p><strong>触发场景</strong>:文件编辑完成后的状态更新和任务标记</p>
<h4>3. <strong>SubagentStop</strong> - 子代理停止时触发</h4>
<pre><code class="language-json">{
    &quot;matcher&quot;: &quot;*&quot;,
    &quot;hooks&quot;: [
      {
            &quot;command&quot;: &quot;node agents/todo-hook-manager.js handle-task-complete&quot;,
            &quot;timeout&quot;: 45000
      },
      {
            &quot;command&quot;: &quot;git add . &amp;&amp; git commit -m \&quot;Auto-commit: Agent task completed - $(date)\&quot; || true&quot;,
            &quot;timeout&quot;: 20000
      }
    ]
}
</code></pre>
<p><strong>触发场景</strong>:代理任务完成后的自动提交和下一任务触发</p>
<h4>4. <strong>Notification</strong> - 通知事件</h4>
<pre><code class="language-json">{
    &quot;matcher&quot;: &quot;&quot;,
    &quot;hooks&quot;: [{
      &quot;command&quot;: &quot;node agents/todo-hook-manager.js handle-notification&quot;,
      &quot;timeout&quot;: 10000
    }]
}
</code></pre>
<h4>5. <strong>Stop</strong> - Claude响应完成</h4>
<pre><code class="language-json">{
    &quot;matcher&quot;: &quot;&quot;,
    &quot;hooks&quot;: [
      {
            &quot;command&quot;: &quot;node agents/todo-hook-manager.js update-stats&quot;,
            &quot;timeout&quot;: 15000
      },
      {
            &quot;command&quot;: &quot;echo \&quot;$(date): Claude Code session completed\&quot; &gt;&gt; .claude/session.log&quot;,
            &quot;timeout&quot;: 5000
      }
    ]
}
</code></pre>
<h3>Hook自动化流程示例</h3>
<p><img src="https://images.bigseek.com//forum/202508/06/162446q33xppx3yxpjxp3b.png" alt="图片.png" title="图片.png" /></p>
<h2>核心九大专家代理</h2>
<h3>1. spec-orchestrator - 总协调器</h3>
<p><strong>职责</strong>:多层智能代理协调系统的总指挥官</p>
<ul>
<li>读取Kiro规格文件进行深度分析</li>
<li>智能选择最合适的专业代理团队</li>
<li>协调三层架构的代理执行</li>
<li>管理统一的TODO任务列表</li>
<li>实现Hook驱动的自动化流程</li>
</ul>
<h3>2. spec-analyst - 需求分析师</h3>
<p><strong>职责</strong>:需求获取和项目范围专家</p>
<ul>
<li>获取全面的需求和用户故事</li>
<li>创建带验收标准的结构化需求文档</li>
<li>分析利益相关者和用户画像</li>
<li>生成项目简报和范围文档</li>
</ul>
<h3>3.spec-architect - 系统架构师</h3>
<p><strong>职责</strong>:技术设计和架构专家</p>
<ul>
<li>创建全面的系统设计和架构</li>
<li>技术栈推荐和评估</li>
<li>API规范和数据模型设计</li>
<li>确保可扩展性、安全性和可维护性</li>
</ul>
<h3>4.spec-planner - 实施规划师</h3>
<p><strong>职责</strong>:将架构设计分解为可操作任务</p>
<ul>
<li>创建详细的任务列表和实现顺序</li>
<li>估算复杂性和工作量</li>
<li>定义实现顺序和依赖关系</li>
<li>规划全面的测试策略</li>
</ul>
<h3>5.spec-developer - 开发专家</h3>
<p><strong>职责</strong>:根据规范实现代码</p>
<ul>
<li>编写干净、可维护的生产质量代码</li>
<li>遵循架构模式和最佳实践</li>
<li>创建单元测试和处理错误场景</li>
<li>确保与现有代码的无缝集成</li>
</ul>
<h3>6.spec-reviewer - 代码审查师</h3>
<p><strong>职责</strong>:代码质量和最佳实践保证</p>
<ul>
<li>评估代码可读性和可维护性</li>
<li>识别安全漏洞和性能瓶颈</li>
<li>检查代码异味和反模式</li>
<li>提供可操作的改进反馈</li>
</ul>
<h3>7.spec-validator - 质量验证师</h3>
<p><strong>职责</strong>:最终质量验证和生产就绪评估</p>
<ul>
<li>验证所有需求是否满足</li>
<li>确认架构实现的正确性</li>
<li>计算整体质量分数</li>
<li>生成全面的验证报告</li>
</ul>
<h3>8.spec-tester - 测试专家</h3>
<p><strong>职责</strong>:综合测试策略和实现</p>
<ul>
<li>创建并执行全面的测试套件</li>
<li>编写单元、集成和端到端测试</li>
<li>执行安全测试和性能测试</li>
<li>确保代码覆盖率符合标准</li>
</ul>
<h3>9.spec-task-reviewer - 任务监督师</h3>
<p><strong>职责</strong>:开发任务完成状态审查</p>
<ul>
<li>系统地审查任务列表中的每个任务</li>
<li>验证实现是否符合规范要求</li>
<li>自动触发未完成任务的执行</li>
<li>提供全面的进度状态报告</li>
</ul>
<h2>使用流程</h2>
<h3>快速开始</h3>
<ol>
<li><strong>简单需求处理</strong></li>
</ol>
<pre data-code-wrap="bash" dir="auto" class="codeblock-buttons"><div class="codeblock-button-wrapper"></div></pre>
<pre><code class="language-bash"># 1. 编写初始需求到 INITIAL.md
# 2. 生成PRP文档
/generate-prp INITIAL.md
# 3. 执行实现
/execute-prp PRPs/your-feature-name.md
</code></pre>
<ol start="2">
<li><strong>中等复杂度项目</strong></li>
</ol>
<pre data-code-wrap="bash" dir="auto" class="codeblock-buttons"><div class="codeblock-button-wrapper"></div></pre>
<pre><code class="language-bash"># 直接使用自动化工作流
/agent-workflow &quot;实现用户认证系统,包含JWT、密码重置和双因素验证&quot;
</code></pre>
<ol start="3">
<li><strong>复杂系统重构</strong></li>
</ol>
<pre data-code-wrap="bash" dir="auto" class="codeblock-buttons"><div class="codeblock-button-wrapper"></div></pre>
<pre><code class="language-bash"># 使用多层代理协调
/multi-agent-workflow personal-intro-page
</code></pre>
<ol start="4">
<li><strong>规格驱动开发</strong></li>
</ol>
<pre data-code-wrap="bash" dir="auto" class="codeblock-buttons"><div class="codeblock-button-wrapper"></div></pre>
<pre><code class="language-bash"># Kiro完整流程
/kiro/spec &quot;电商购物车功能&quot;
# 执行具体任务
/kiro/execute shopping-cart &quot;实现添加商品到购物车功能&quot;
</code></pre>
<h3>我的核心工作流程</h3>
<p>根据项目复杂度,我采用不同的工作流程:</p>
<h4><strong>文档生成和改进流程</strong></h4>
<pre data-code-wrap="bash" dir="auto" class="codeblock-buttons"><div class="codeblock-button-wrapper"></div></pre>
<pre><code class="language-bash">/generate-prp INITIAL.md# 基于初始需求生成PRP
# 人工审查和改进PRP文档
/execute-prp PRPs/refined-feature.md# 执行优化后的PRP
</code></pre>
<h4><strong>Kiro规格化开发</strong></h4>
<pre data-code-wrap="bash" dir="auto" class="codeblock-buttons"><div class="codeblock-button-wrapper"></div></pre>
<pre><code class="language-bash">/kiro/spec &lt;新功能想法&gt;   # 完整的需求-设计-任务流程
/kiro/execute &lt;功能&gt; &lt;任务&gt; # 执行具体实现任务
</code></pre>
<h4><strong>中等难度自动化</strong></h4>
<pre data-code-wrap="bash" dir="auto" class="codeblock-buttons"><div class="codeblock-button-wrapper"></div></pre>
<pre><code class="language-bash">/agent-workflow &lt;功能描述&gt;# 自动化的质量门控流程
</code></pre>
<h4><strong>复杂重构协调</strong></h4>
<pre data-code-wrap="bash" dir="auto" class="codeblock-buttons"><div class="codeblock-button-wrapper"></div></pre>
<pre><code class="language-bash">/multi-agent-workflow &lt;系统模块&gt;# 多层代理智能协调
</code></pre>
<h2>Context Engineering核心理念</h2>
<p>本项目基于Context Engineering理念构建,核心原则:</p>
<h3>Context Engineering vs Prompt Engineering</h3>
<table>
<thead>
<tr>
<th>维度</th>
<th>Prompt Engineering</th>
<th>Context Engineering</th>
</tr>
</thead>
<tbody>
<tr>
<td>范围</td>
<td>聪明的措辞和短语</td>
<td>完整的系统化上下文</td>
</tr>
<tr>
<td>内容</td>
<td>单次任务指令</td>
<td>文档、示例、规则、模式、验证</td>
</tr>
<tr>
<td>效果</td>
<td>便签式指令</td>
<td>完整剧本式指导</td>
</tr>
<tr>
<td>可靠性</td>
<td>容易失败</td>
<td>自我修正和验证</td>
</tr>
</tbody>
</table>
<h3>关键组件</h3>
<ol>
<li><strong>CLAUDE.md</strong> - 全局AI行为规则和项目约定</li>
<li><strong>examples/</strong> - 代码模式和最佳实践示例</li>
<li><strong>PRP模板</strong> - 包含验证循环的综合实现蓝图</li>
<li><strong>Hook自动化</strong> - 事件驱动的任务流程管理</li>
</ol>
<h2>许可证</h2>
<p>本项目采用 MIT 许可证 - 详见LICENSE文件</p>

paul3105 发表于 2025-8-6 16:16:49

感谢大佬的分享

暮色回响 发表于 2025-8-6 21:08:30

感谢分享

slipknot 发表于 2025-8-6 21:18:33

美人鱼(Mermaid)格式的内容,可以让克劳德帮忙生成。它处理这个格式时非常严谨。你把流程跟它讲一遍,或者让它从头到尾规划执行一遍就行。其他模型生成的内容语法容易报错,不太推荐。

Penger 发表于 2025-8-6 23:28:31

先点赞,再观看

bestcheer 发表于 2025-8-7 00:08:31

老哥,您的一些MCP工具要是功能一样的话,不同仓库会有影响吗?就是您的提示词调用这些工具的时候。
页: [1]
查看完整版本: Claude-Code-Multi-Agent 开源发布,强大的claude code Subagent工作流