Claude Sub-Agent 规范工作流系统

这是一个基于 Claude Code 的 Sub-Agents（子智能体）功能构建的综合 AI 驱动开发工作流系统。该系统通过协调运作的专业 AI 智能体，将项目构思转化为生产就绪的代码。

目录

• 概述
• 系统架构
• 安装指南
• 快速开始
• Slash 命令使用
• 工作原理
• 智能体参考
• 使用示例
• 质量关卡
• 最佳实践
• 高级用法
• 故障排除

概述

该规范工作流系统利用 Claude Code 的 Sub-Agents 能力，创建了一个多智能体开发流水线。每个智能体都是处理软件开发生命周期特定方面的专业专家，从需求分析到最终验证，覆盖整个流程。

核心功能

• 自动化工作流：从构思到生产代码的完整开发流水线。
• 专业领域专家：每个智能体专注于其擅长的领域。
• 质量关卡：自动化的检查点确保符合质量标准。
• 灵活集成：可与现有的专用智能体协同工作。
• 综合文档：每个阶段都会生成详细的产出物。

优势

• 开发效率提升 10 倍（从构思到代码）。
• 通过自动化验证确保质量的一致性。
• 自动生成综合性的项目文档。
• 通过系统化流程减少人为错误。
• 通过清晰的工作流改善团队协作。

系统架构

graph TD
    A[Project Idea] --> B[spec-orchestrator]
    B --> C[Planning Phase]
    C --> D[spec-analystRequirements]
    D --> E[spec-architectSystem Design]
    E --> F[spec-plannerTask Breakdown]
    
    F --> G{Quality Gate 1}
    G -->|Pass| H[Development Phase]
    G -->|Fail| D
    
    H --> I[spec-developerImplementation]
    I --> J[spec-testerTesting]
    
    J --> K{Quality Gate 2}
    K -->|Pass| L[Validation Phase]
    K -->|Fail| I
    
    L --> M[spec-reviewerCode Review]
    M --> N[spec-validatorFinal Check]
    
    N --> O{Quality Gate 3}
    O -->|Pass| P[Production Ready]
    O -->|Fail| Q[Feedback Loop]
    
    style B fill:#1a73e8,color:#fff
    style G fill:#f9ab00,color:#fff
    style K fill:#f9ab00,color:#fff
    style O fill:#f9ab00,color:#fff
    style P fill:#34a853,color:#fff

安装指南

先决条件

• Claude Code（最新版本）
• 已初始化的项目目录
• 对 AI 辅助开发的基本理解

设置步骤

1. 下载智能体

   # 选项 1：克隆仓库
   git clone https://github.com/zhsama/claude-sub-agent.git
   cd claude-sub-agent
   
   # 选项 2：仅下载您需要的特定智能体
   # 单个智能体文件位于 agents/ 目录中
   

2. 将智能体和 Slash 命令复制到项目的 Claude Code 目录

   # 在项目中创建 .claude 目录结构
   mkdir -p .claude/agents .claude/commands
   
   # 从分类目录复制所有智能体
   cp -r agents/*/*.md .claude/agents/
   
   # 复制 slash 命令
   cp commands/agent-workflow.md .claude/commands/
   

3. 在 CLAUDE.md 中添加 RULES

   ## 项目文档约定 (重要)
   
   **文档文件：** 所有新的文档或任务文件必须保存在本仓库的 `docs/` 文件夹下。例如：
   
   - **任务与 TODOs**: 保存在 `docs/{YYYY_MM_DD}/tasks/` (例如: `docs/t2025_08_08/tasks/ReleaseTodo.md` 用于发布清单)。
   - **需求/规范**: 保存在 `docs/{YYYY_MM_DD}/specs/` (例如: `docs/2025_08_08/specs/AuthModuleRequirements.md`)。
   - **设计文档**: 保存在 `docs/{YYYY_MM_DD}/design/` (例如: `docs/2025_08_08/design/ArchitectureOverview.md`)。
   - **代码文件**: 遵循项目结构（将新代码放入讨论确定的 src/module 文件夹）。
   - **测试**: 将新的测试文件放在 `tests/` 目录中，并镜像代码结构。
   
   > **重要:** 创建新文件时，请确保目录已存在或先创建目录。永远不要将这些文件直接放在根目录下。
   

4. 验证安装

   仓库结构：

   claude-sub-agent/
   ├── agents/
   │   ├── spec-agents/         # 核心工作流智能体
   │   │   ├── spec-analyst.md
   │   │   ├── spec-architect.md
   │   │   ├── spec-developer.md
   │   │   ├── spec-orchestrator.md
   │   │   ├── spec-planner.md
   │   │   ├── spec-reviewer.md
   │   │   ├── spec-tester.md
   │   │   └── spec-validator.md
   │   ├── backend/             # 后端专家
   │   │   └── senior-backend-architect.md
   │   ├── frontend/            # 前端专家
   │   │   └── senior-frontend-architect.md
   │   ├── ui-ux/               # 设计专家
   │   │   └── ui-ux-master.md