[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-zhsama--claude-sub-agent":3,"tool-zhsama--claude-sub-agent":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",152630,2,"2026-04-12T23:33:54",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":75,"owner_location":76,"owner_email":76,"owner_twitter":76,"owner_website":76,"owner_url":77,"languages":76,"stars":78,"forks":79,"last_commit_at":80,"license":76,"difficulty_score":32,"env_os":81,"env_gpu":81,"env_ram":81,"env_deps":82,"category_tags":86,"github_topics":87,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":92,"updated_at":93,"faqs":94,"releases":95},7056,"zhsama\u002Fclaude-sub-agent","claude-sub-agent","AI-driven development workflow system built on Claude Code Sub-Agents.","claude-sub-agent 是一个基于 Claude Code 子代理功能构建的 AI 驱动开发工作流系统。它旨在解决传统开发中从创意到落地代码周期长、质量不稳定以及文档缺失等痛点，通过将软件开发全生命周期拆解为需求分析、系统设计、任务规划、代码实现、测试验证及代码审查等多个专业阶段，让不同的专用 AI 代理协同工作，自动完成从项目构思到生产级代码的转化。\n\n这套系统特别适合希望提升研发效率的软件开发者、技术团队负责人以及需要快速原型验证的研究人员。其核心亮点在于引入了严格的“质量门禁”机制：在每个关键阶段结束后，系统会自动进行校验，只有达标才能进入下一环节，否则将触发反馈循环进行修正。这种类似工厂流水线的协作模式，不仅实现了开发速度的显著提升，还确保了产出代码的一致性与高质量，并自动生成详尽的需求、设计及任务文档，让开发过程更加规范透明。","# Claude Sub-Agent Spec Workflow System\n\nA comprehensive AI-driven development workflow system built on Claude Code's Sub-Agents feature. This system transforms project ideas into production-ready code through specialized AI agents working in coordinated phases.\n\n## Table of Contents\n\n- [Overview](#overview)\n- [System Architecture](#system-architecture)\n- [Installation](#installation)\n- [Quick Start](#quick-start)\n- [Slash Command Usage](#slash-command-usage)\n- [How It Works](#how-it-works)\n- [Agent Reference](#agent-reference)\n- [Usage Examples](#usage-examples)\n- [Quality Gates](#quality-gates)\n- [Best Practices](#best-practices)\n- [Advanced Usage](#advanced-usage)\n- [Troubleshooting](#troubleshooting)\n\n## Overview\n\nThe Spec Workflow System leverages Claude Code's Sub-Agents capability to create a multi-agent development pipeline. Each agent is a specialized expert that handles specific aspects of the software development lifecycle, from requirements analysis to final validation.\n\n### Key Features\n\n- **Automated Workflow**: Complete development pipeline from idea to production code\n- **Specialized Expertise**: Each agent focuses on their domain of expertise\n- **Quality Gates**: Automated checkpoints ensure quality standards\n- **Flexible Integration**: Works with existing specialized agents\n- **Comprehensive Documentation**: Every phase produces detailed artifacts\n\n### Benefits\n\n- 10x faster development from concept to code\n- Consistent quality through automated validation\n- Comprehensive documentation generated automatically\n- Reduced errors through systematic processes\n- Better collaboration through clear workflows\n\n## System Architecture\n\n```mermaid\ngraph TD\n    A[Project Idea] --> B[spec-orchestrator]\n    B --> C[Planning Phase]\n    C --> D[spec-analyst\u003Cbr\u002F>Requirements]\n    D --> E[spec-architect\u003Cbr\u002F>System Design]\n    E --> F[spec-planner\u003Cbr\u002F>Task Breakdown]\n    \n    F --> G{Quality Gate 1}\n    G -->|Pass| H[Development Phase]\n    G -->|Fail| D\n    \n    H --> I[spec-developer\u003Cbr\u002F>Implementation]\n    I --> J[spec-tester\u003Cbr\u002F>Testing]\n    \n    J --> K{Quality Gate 2}\n    K -->|Pass| L[Validation Phase]\n    K -->|Fail| I\n    \n    L --> M[spec-reviewer\u003Cbr\u002F>Code Review]\n    M --> N[spec-validator\u003Cbr\u002F>Final Check]\n    \n    N --> O{Quality Gate 3}\n    O -->|Pass| P[Production Ready]\n    O -->|Fail| Q[Feedback Loop]\n    \n    style B fill:#1a73e8,color:#fff\n    style G fill:#f9ab00,color:#fff\n    style K fill:#f9ab00,color:#fff\n    style O fill:#f9ab00,color:#fff\n    style P fill:#34a853,color:#fff\n```\n\n## Installation\n\n### Prerequisites\n\n- Claude Code (latest version)\n- Project directory initialized\n- Basic understanding of AI-assisted development\n\n### Setup Steps\n\n1. **Download the agents**\n\n   ```bash\n   # Option 1: Clone the repository\n   git clone https:\u002F\u002Fgithub.com\u002Fzhsama\u002Fclaude-sub-agent.git\n   cd claude-sub-agent\n   \n   # Option 2: Download specific agents you need\n   # Individual agent files are available in the agents\u002F directory\n   ```\n\n2. **Copy agents and slash command to your project's Claude Code directory**\n\n   ```bash\n   # Create .claude directory structure in your project\n   mkdir -p .claude\u002Fagents .claude\u002Fcommands\n   \n   # Copy all agents from categorized directories\n   cp -r agents\u002F*\u002F*.md .claude\u002Fagents\u002F\n   \n   # Copy slash command\n   cp commands\u002Fagent-workflow.md .claude\u002Fcommands\u002F\n   ```\n\n3. **Add RULES to CLAUDE.md**\n\n   ```md\n   ## Project Documentation Conventions (Important)\n\n   **Documentation Files:** All new documentation or task files must be saved under the `docs\u002F` folder in this repository.For example:\n\n   - **Tasks & TODOs**: Save in `docs\u002F{YYYY_MM_DD}\u002Ftasks\u002F` (e.g., `docs\u002Ft2025_08_08\u002Fasks\u002FReleaseTodo.md` for a release checklist).\n   - **Requirements\u002FSpecs**: Save in `docs\u002F{YYYY_MM_DD}\u002Fspecs\u002F` (e.g., `docs\u002F2025_08_08\u002Fspecs\u002FAuthModuleRequirements.md`).\n   - **Design Docs**: Save in `docs\u002F{YYYY_MM_DD}\u002Fdesign\u002F` (e.g., `docs\u002F2025_08_08\u002Fdesign\u002FArchitectureOverview.md`).\n   - **Code Files:** Follow the project structure (place new code in the appropriate src\u002Fmodule folder as discussed).\n   - **Tests:** Put new test files under the `tests\u002F` directory, mirroring the code structure.\n\n   > **Important:** When creating a new file, ensure the directory exists or create it. Never default to the root directory for these files.\n   ```\n\n4. **Verify installation**\n\n   **Repository Structure:**\n\n   ```text\n   claude-sub-agent\u002F\n   ├── agents\u002F\n   │   ├── spec-agents\u002F         # Core workflow agents\n   │   │   ├── spec-analyst.md\n   │   │   ├── spec-architect.md\n   │   │   ├── spec-developer.md\n   │   │   ├── spec-orchestrator.md\n   │   │   ├── spec-planner.md\n   │   │   ├── spec-reviewer.md\n   │   │   ├── spec-tester.md\n   │   │   └── spec-validator.md\n   │   ├── backend\u002F             # Backend specialists\n   │   │   └── senior-backend-architect.md\n   │   ├── frontend\u002F            # Frontend specialists\n   │   │   └── senior-frontend-architect.md\n   │   ├── ui-ux\u002F              # Design specialists\n   │   │   └── ui-ux-master.md\n   │   └── utility\u002F             # Utility agents\n   │       └── refactor-agent.md\n   └── commands\u002F\n       └── agent-workflow.md    # Slash command\n   ├── CLAUDE.md\n   ```\n\n   **Your project structure after installation:**\n\n   ```text\n   your-project\u002F\n   ├── .claude\u002F\n   │   ├── commands\u002F\n   │   │   └── agent-workflow.md   # Slash command\n   │   └── agents\u002F\n   │       ├── spec-analyst.md\n   │       ├── spec-architect.md\n   │       ├── spec-developer.md\n   │       ├── spec-orchestrator.md\n   │       ├── spec-planner.md\n   │       ├── spec-reviewer.md\n   │       ├── spec-tester.md\n   │       ├── spec-validator.md\n   │       ├── senior-backend-architect.md\n   │       ├── senior-frontend-architect.md\n   │       ├── ui-ux-master.md\n   │       └── refactor-agent.md\n   ├── CLAUDE.md\n   └── ... (your project files)\n   ```\n\n## Quick Start\n\n### Basic Usage\n\n```bash\n# Start a new project workflow\nAsk Claude: \"Use the spec-orchestrator agent to create a todo list web application\"\n\n# The orchestrator will automatically:\n# 1. Analyze requirements\n# 2. Design architecture\n# 3. Plan tasks\n# 4. Implement code\n# 5. Write tests\n# 6. Review and validate\n```\n\n### Simple Example\n\n```markdown\nYou: Use spec-orchestrator to create a personal blog platform\n\nClaude (spec-orchestrator): Starting workflow for personal blog platform...\n\n[Planning Phase - 45 minutes]\n✓ Requirements analyzed\n✓ Architecture designed\n✓ Tasks planned\n✓ Quality Gate 1: PASSED (96\u002F100)\n\n[Development Phase - 2 hours]\n✓ 15 tasks implemented\n✓ Tests written\n✓ Quality Gate 2: PASSED (88\u002F100)\n\n[Validation Phase - 30 minutes]\n✓ Code reviewed\n✓ Final validation complete\n✓ Quality Gate 3: PASSED (91\u002F100)\n\nProject complete! Generated artifacts:\n- requirements.md\n- architecture.md\n- Source code (15 files)\n- Test suites (85% coverage)\n- Documentation\n```\n\n## Slash Command Usage\n\nFor the quickest way to start a complete workflow, use our custom slash command:\n\n### Basic Usage\n\n```bash\n\u002Fagent-workflow \"Create a task management web application with user authentication and real-time updates\"\n```\n\n### Advanced Usage\n\n```bash\n# High-quality enterprise project\n\u002Fagent-workflow \"Develop a CRM system with customer management and analytics\" --quality=95\n\n# Quick prototype development  \n\u002Fagent-workflow \"Simple personal blog website\" --quality=75 --skip-agent=spec-tester\n\n# From existing requirements\n\u002Fagent-workflow \"Mobile app based on existing requirements\" --skip-agent=spec-analyst\n\n# Specific phases only\n\u002Fagent-workflow \"Microservices e-commerce platform\" --phase=planning\n```\n\n### Command Options\n\n- `--quality=[75-95]`: Set quality gate threshold\n- `--skip-agent=[agent-name]`: Skip specific agents\n- `--phase=[planning|development|validation|all]`: Run specific phases\n- `--output-dir=[path]`: Specify output directory\n- `--language=[zh|en]`: Documentation language\n\n**📖 For complete slash command documentation, see [commands\u002Fagent-workflow.md](.\u002Fcommands\u002Fagent-workflow.md)**\n\n## How It Works\n\n### 1. Claude Code Sub-Agents Integration\n\nAccording to Claude Code's documentation, sub-agents work by:\n\n- Operating in isolated context windows\n- Preventing pollution of the main conversation\n- Allowing specialized, focused interactions\n- Being automatically selected based on task context\n\nOur system leverages these features by creating specialized agents for each development phase.\n\n### 2. Workflow Phases\n\n#### Planning Phase\n\n1. **spec-analyst**: Analyzes requirements and creates user stories\n2. **spec-architect**: Designs system architecture\n3. **spec-planner**: Breaks down work into tasks\n4. **Quality Gate 1**: Validates planning completeness\n\n#### Development Phase\n\n1. **spec-developer**: Implements code based on tasks\n2. **spec-tester**: Writes comprehensive tests\n3. **Quality Gate 2**: Validates code quality\n\n#### Validation Phase\n\n1. **spec-reviewer**: Reviews code for best practices\n2. **spec-validator**: Final production readiness check\n3. **Quality Gate 3**: Ensures deployment readiness\n\n### 3. Agent Communication\n\nAgents communicate through structured artifacts:\n\n- Each agent produces specific documents\n- Next agent uses previous outputs as input\n- Orchestrator manages the flow\n- Quality gates ensure consistency\n\n## Agent Reference\n\n### Agent Classification System\n\nOur agents are organized into specialized categories for better organization and domain expertise:\n\n- **spec-agents\u002F**: Core workflow orchestration agents\n- **backend\u002F**: Backend system specialists\n- **frontend\u002F**: Frontend development specialists  \n- **ui-ux\u002F**: User experience and design specialists\n- **utility\u002F**: General-purpose utility agents\n\n### Core Workflow Agents (spec-agents\u002F)\n\n| Agent | Purpose | Inputs | Outputs |\n|-------|---------|--------|---------|\n| spec-orchestrator | Workflow coordination | Project description | Status reports, routing |\n| spec-analyst | Requirements analysis | User description | requirements.md, user-stories.md |\n| spec-architect | System design | Requirements | architecture.md, api-spec.md |\n| spec-planner | Task planning | Architecture | tasks.md, test-plan.md |\n| spec-developer | Implementation | Tasks | Source code, unit tests |\n| spec-tester | Testing | Code | Test suites, coverage reports |\n| spec-reviewer | Code review | Code | Review report, improvements |\n| spec-validator | Final validation | All artifacts | Validation report, quality score |\n\n### Specialist Agents by Category\n\n#### Backend Specialists (backend\u002F)\n\n| Agent | Domain | Integration Point |\n|-------|--------|-----------|\n| senior-backend-architect | Backend Systems & Architecture | Architecture\u002FDevelopment phase |\n\n#### Frontend Specialists (frontend\u002F)\n\n| Agent | Domain | Integration Point |\n|-------|--------|-----------|\n| senior-frontend-architect | Frontend Systems & Architecture | Development phase |\n\n#### UI\u002FUX Specialists (ui-ux\u002F)\n\n| Agent | Domain | Integration Point |\n|-------|--------|-----------|\n| ui-ux-master | User Experience & Interface Design | Planning\u002FDevelopment phase |\n\n#### Utility Agents (utility\u002F)\n\n| Agent | Domain | Integration Point |\n|-------|--------|-----------|\n| refactor-agent | Code Quality & Refactoring | Any phase |\n\n## Usage Examples\n\n### Example 1: Enterprise Application\n\n```bash\n# High-quality enterprise system\nUse spec-orchestrator with quality threshold 95:\nCreate an enterprise CRM system with:\n- Multi-tenancy support\n- Role-based access control\n- RESTful API\n- Real-time dashboard\n- Audit logging\n```\n\n### Example 2: Quick Prototype\n\n```bash\n# Fast prototype with lower quality threshold\nUse spec-orchestrator with quality threshold 75 and skip analyst:\nCreate a simple landing page with email capture\n```\n\n### Example 3: Existing Requirements\n\n```bash\n# Start from existing documentation\nUse spec-orchestrator starting from requirements:\nLoad requirements from .\u002Fdocs\u002Frequirements.md and continue workflow\n```\n\n### Example 4: Specific Phase Only\n\n```bash\n# Run only validation on existing code\nUse spec-orchestrator for validation phase only:\nValidate the project in .\u002Fmy-app\u002F\n```\n\n## Quality Gates\n\n### Gate 1: Planning Quality (95% threshold)\n\n- Requirements completeness\n- Architecture feasibility\n- Task breakdown quality\n- User story clarity\n\n### Gate 2: Development Quality (80% threshold)\n\n- Test coverage\n- Code quality metrics\n- Security scan results\n- Performance benchmarks\n\n### Gate 3: Production Readiness (85% threshold)\n\n- Overall quality score\n- Documentation completeness\n- Deployment readiness\n- Operational requirements\n\n## Best Practices\n\n### 1. Project Preparation\n\n- Write clear project descriptions\n- Include constraints and requirements\n- Specify quality expectations\n- Provide existing documentation\n\n### 2. Working with Agents\n\n- Let each agent complete their phase\n- Review artifacts between phases\n- Use feedback loops effectively\n- Trust the quality gates\n\n### 3. Customization\n\n- Adjust quality thresholds based on needs\n- Skip agents for simpler projects\n- Add custom validation criteria\n- Integrate with existing workflows\n\n### 4. Performance Optimization\n\n- Enable parallel execution for large projects\n- Cache results for iterative development\n- Use phase-specific execution\n- Monitor resource usage\n\n## Advanced Usage\n\n### Custom Workflows\n\n```python\n# Create custom workflow configuration\nworkflow_config = {\n    \"quality_threshold\": 90,\n    \"skip_agents\": [\"spec-analyst\"],  # If you have requirements\n    \"parallel\": True,\n    \"custom_validators\": [\"security-scan\", \"performance-test\"],\n    \"output_format\": \"markdown\"\n}\n\n# Execute with custom config\n\"Use spec-orchestrator with config: \" + json.dumps(workflow_config)\n```\n\n### Integration with CI\u002FCD\n\n```yaml\n# GitHub Actions example\nname: AI Workflow Validation\non: [pull_request]\njobs:\n  validate:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v3\n      - name: Run Spec Validation\n        run: |\n          # Use Claude Code CLI (if available)\n          claude-code run spec-orchestrator \\\n            --phase validation \\\n            --project-path .\n```\n\n### Extending the System\n\n1. **Add New Agents**\n   - Create agent with YAML frontmatter\n   - Define clear responsibilities\n   - Specify input\u002Foutput formats\n   - Update orchestrator routing\n\n2. **Custom Quality Gates**\n   - Define new criteria\n   - Set appropriate thresholds\n   - Implement validation logic\n   - Add to workflow\n\n3. **Domain-Specific Workflows**\n   - Create specialized orchestrators\n   - Define domain patterns\n   - Customize quality criteria\n   - Optimize for specific needs\n\n## Troubleshooting\n\n### Common Issues\n\n1. **Agent Not Found**\n   - Verify agents are in correct directory\n   - Check YAML frontmatter format\n   - Ensure proper file permissions\n\n2. **Quality Gate Failures**\n   - Review specific criteria that failed\n   - Check artifact completeness\n   - Allow agents to revise work\n   - Consider adjusting thresholds\n\n3. **Workflow Stuck**\n   - Check orchestrator status\n   - Review last agent output\n   - Look for error messages\n   - Restart from last checkpoint\n\n### Debug Mode\n\n```bash\n# Enable verbose logging\nUse spec-orchestrator with debug mode:\nCreate test project and show all agent interactions\n```\n\n## Contributing\n\nWe welcome contributions! Please:\n\n1. Follow the existing agent format\n2. Add comprehensive documentation\n3. Include usage examples\n4. Test with the orchestrator\n5. Submit PR with description\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Acknowledgments\n\n- Built on Claude Code's Sub-Agents feature\n- Inspired by BMAD methodology\n- Community contributions welcome\n\n---\n\nFor more information, see:\n\n- [Claude Code Documentation](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code)\n- [Sub-Agents Guide](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fsub-agents)\n- [Project Issues](https:\u002F\u002Fgithub.com\u002Fzhsama\u002Fclaude-sub-agent\u002Fissues)\n","# Claude 子代理规范工作流系统\n\n基于 Claude Code 的子代理功能构建的全面 AI 驱动开发工作流系统。该系统通过协调运作的专用 AI 代理，将项目创意转化为可投入生产的代码。\n\n## 目录\n\n- [概述](#overview)\n- [系统架构](#system-architecture)\n- [安装](#installation)\n- [快速入门](#quick-start)\n- [斜杠命令使用方法](#slash-command-usage)\n- [工作原理](#how-it-works)\n- [代理参考](#agent-reference)\n- [使用示例](#usage-examples)\n- [质量门控](#quality-gates)\n- [最佳实践](#best-practices)\n- [高级用法](#advanced-usage)\n- [故障排除](#troubleshooting)\n\n## 概述\n\n规范工作流系统利用 Claude Code 的子代理能力，创建了一个多代理开发流水线。每个代理都是专注于软件开发生命周期特定环节的专业专家，从需求分析到最终验证。\n\n### 核心特性\n\n- **自动化工作流**：从创意到生产代码的完整开发流程\n- **专业化分工**：各代理专注于各自的专业领域\n- **质量门控**：自动化的检查点确保质量标准\n- **灵活集成**：可与现有专业代理协同工作\n- **全面文档化**：每个阶段都会生成详细的产出物\n\n### 优势\n\n- 从概念到代码的开发速度提升 10 倍\n- 通过自动化验证实现一致的质量\n- 自动生成全面的文档\n- 通过系统化流程减少错误\n- 清晰的工作流促进更好的协作\n\n## 系统架构\n\n```mermaid\ngraph TD\n    A[项目创意] --> B[spec-orchestrator]\n    B --> C[规划阶段]\n    C --> D[spec-analyst\u003Cbr\u002F>需求分析]\n    D --> E[spec-architect\u003Cbr\u002F>系统设计]\n    E --> F[spec-planner\u003Cbr\u002F>任务分解]\n    \n    F --> G{质量门控1}\n    G -->|通过| H[开发阶段]\n    G -->|未通过| D\n    \n    H --> I[spec-developer\u003Cbr\u002F>实现]\n    I --> J[spec-tester\u003Cbr\u002F>测试]\n    \n    J --> K{质量门控2}\n    K -->|通过| L[验证阶段]\n    K -->|未通过| I\n    \n    L --> M[spec-reviewer\u003Cbr\u002F>代码评审]\n    M --> N[spec-validator\u003Cbr\u002F>最终检查]\n    \n    N --> O{质量门控3}\n    O -->|通过| P[已准备好投入生产]\n    O -->|未通过| Q[反馈循环]\n    \n    style B fill:#1a73e8,color:#fff\n    style G fill:#f9ab00,color:#fff\n    style K fill:#f9ab00,color:#fff\n    style O fill:#f9ab00,color:#fff\n    style P fill:#34a853,color:#fff\n```\n\n## 安装\n\n### 先决条件\n\n- Claude Code（最新版本）\n- 已初始化的项目目录\n- 对 AI 辅助开发的基本了解\n\n### 设置步骤\n\n1. **下载代理**\n\n   ```bash\n   # 方法一：克隆仓库\n   git clone https:\u002F\u002Fgithub.com\u002Fzhsama\u002Fclaude-sub-agent.git\n   cd claude-sub-agent\n   \n   # 方法二：下载所需的具体代理\n   # 单个代理文件可在 agents\u002F 目录下找到\n   ```\n\n2. **将代理和斜杠命令复制到项目的 Claude Code 目录中**\n\n   ```bash\n   # 在项目中创建 .claude 目录结构\n   mkdir -p .claude\u002Fagents .claude\u002Fcommands\n   \n   # 复制分类目录下的所有代理\n   cp -r agents\u002F*\u002F*.md .claude\u002Fagents\u002F\n   \n   # 复制斜杠命令\n   cp commands\u002Fagent-workflow.md .claude\u002Fcommands\u002F\n   ```\n\n3. **在 CLAUDE.md 中添加规则**\n\n   ```md\n   ## 项目文档规范（重要）\n\n   **文档文件：** 所有新文档或任务文件必须保存在本仓库的 `docs\u002F` 文件夹下。例如：\n\n   - **任务与待办事项**：保存在 `docs\u002F{YYYY_MM_DD}\u002Ftasks\u002F` 目录中（如 `docs\u002Ft2025_08_08\u002Fasks\u002FReleaseTodo.md` 用于发布清单）。\n   - **需求\u002F规格说明**：保存在 `docs\u002F{YYYY_MM_DD}\u002Fspecs\u002F` 目录中（如 `docs\u002F2025_08_08\u002Fspecs\u002FAuthModuleRequirements.md`）。\n   - **设计文档**：保存在 `docs\u002F{YYYY_MM_DD}\u002Fdesign\u002F` 目录中（如 `docs\u002F2025_08_08\u002Fdesign\u002FArchitectureOverview.md`）。\n   - **代码文件：** 遵循项目结构（按照讨论结果将新代码放置在相应的 src\u002Fmodule 文件夹中）。\n   - **测试：** 新测试文件应放在 `tests\u002F` 目录下，并与代码结构保持一致。\n\n   > **重要提示：** 创建新文件时，请确保目标目录存在，否则请先创建。切勿将这些文件默认保存在根目录下。\n   ```\n\n4. **验证安装**\n\n   **仓库结构：**\n\n   ```text\n   claude-sub-agent\u002F\n   ├── agents\u002F\n   │   ├── spec-agents\u002F         # 核心工作流代理\n   │   │   ├── spec-analyst.md\n   │   │   ├── spec-architect.md\n   │   │   ├── spec-developer.md\n   │   │   ├── spec-orchestrator.md\n   │   │   ├── spec-planner.md\n   │   │   ├── spec-reviewer.md\n   │   │   ├── spec-tester.md\n   │   │   └── spec-validator.md\n   │   ├── backend\u002F             # 后端专家\n   │   │   └── senior-backend-architect.md\n   │   ├── frontend\u002F            # 前端专家\n   │   │   └── senior-frontend-architect.md\n   │   ├── ui-ux\u002F              # 设计专家\n   │   │   └── ui-ux-master.md\n   │   └── utility\u002F             # 工具类代理\n   │       └── refactor-agent.md\n   └── commands\u002F\n       └── agent-workflow.md    # 斜杠命令\n   ├── CLAUDE.md\n   ```\n\n   **安装后的项目结构：**\n\n   ```text\n   your-project\u002F\n   ├── .claude\u002F\n   │   ├── commands\u002F\n   │   │   └── agent-workflow.md   # 斜杠命令\n   │   └── agents\u002F\n   │       ├── spec-analyst.md\n   │       ├── spec-architect.md\n   │       ├── spec-developer.md\n   │       ├── spec-orchestrator.md\n   │       ├── spec-planner.md\n   │       ├── spec-reviewer.md\n   │       ├── spec-tester.md\n   │       ├── spec-validator.md\n   │       ├── senior-backend-architect.md\n   │       ├── senior-frontend-architect.md\n   │       ├── ui-ux-master.md\n   │       └── refactor-agent.md\n   ├── CLAUDE.md\n   └── ... (您的项目文件)\n   ```\n\n## 快速入门\n\n### 基本用法\n\n```bash\n# 启动新的项目工作流\n向 Claude 提问：“使用 spec-orchestrator 代理创建一个待办事项 Web 应用程序”\n\n# Orchestrator 将自动完成以下步骤：\n# 1. 分析需求\n# 2. 设计架构\n# 3. 制定任务计划\n# 4. 实现代码\n# 5. 编写测试\n# 6. 进行评审和验证\n```\n\n### 简单示例\n\n```markdown\n您：使用 spec-orchestrator 创建一个个人博客平台\n\nClaude（spec-orchestrator）：开始个人博客平台的工作流...\n\n[规划阶段 - 45 分钟]\n✓ 需求已分析\n✓ 架构已设计\n✓ 任务已规划\n✓ 质量门控 1：通过（96\u002F100）\n\n[开发阶段 - 2 小时]\n✓ 15 项任务已完成\n✓ 测试已编写\n✓ 质量门控 2：通过（88\u002F100）\n\n[验证阶段 - 30 分钟]\n✓ 代码已评审\n✓ 最终验证完成\n✓ 质量门控 3：通过（91\u002F100）\n\n项目完成！生成的成果包括：\n- requirements.md\n- architecture.md\n- 源代码（15 个文件）\n- 测试套件（覆盖率 85%）\n- 文档\n```\n\n## 斜杠命令使用方法\n\n要以最快的方式启动完整的工作流，请使用我们的自定义斜杠命令：\n\n### 基本用法\n\n```bash\n\u002Fagent-workflow \"创建一个带有用户认证和实时更新的任务管理Web应用\"\n```\n\n### 高级用法\n\n```bash\n# 高质量企业级项目\n\u002Fagent-workflow \"开发具有客户管理和分析功能的CRM系统\" --quality=95\n\n# 快速原型开发  \n\u002Fagent-workflow \"简单的个人博客网站\" --quality=75 --skip-agent=spec-tester\n\n# 从现有需求出发\n\u002Fagent-workflow \"基于现有需求的移动应用\" --skip-agent=spec-analyst\n\n# 仅执行特定阶段\n\u002Fagent-workflow \"微服务架构的电商平台\" --phase=planning\n```\n\n### 命令选项\n\n- `--quality=[75-95]`: 设置质量门限\n- `--skip-agent=[agent-name]`: 跳过指定代理\n- `--phase=[planning|development|validation|all]`: 执行特定阶段\n- `--output-dir=[path]`: 指定输出目录\n- `--language=[zh|en]`: 文档语言\n\n**📖 完整的斜杠命令文档，请参阅 [commands\u002Fagent-workflow.md](.\u002Fcommands\u002Fagent-workflow.md)**\n\n## 工作原理\n\n### 1. Claude Code子代理集成\n\n根据Claude Code的文档，子代理的工作方式如下：\n\n- 在隔离的上下文窗口中运行\n- 防止污染主对话\n- 允许专业、专注的交互\n- 根据任务上下文自动选择\n\n我们的系统利用这些特性，为每个开发阶段创建专门的代理。\n\n### 2. 工作流阶段\n\n#### 规划阶段\n\n1. **spec-analyst**: 分析需求并创建用户故事\n2. **spec-architect**: 设计系统架构\n3. **spec-planner**: 将工作分解为任务\n4. **质量门1**: 验证规划完整性\n\n#### 开发阶段\n\n1. **spec-developer**: 根据任务实现代码\n2. **spec-tester**: 编写全面的测试\n3. **质量门2**: 验证代码质量\n\n#### 验证阶段\n\n1. **spec-reviewer**: 检查代码是否符合最佳实践\n2. **spec-validator**: 最终生产就绪检查\n3. **质量门3**: 确保部署就绪\n\n### 3. 代理间通信\n\n代理通过结构化产物进行沟通：\n\n- 每个代理生成特定文档\n- 下一代理以先前输出为输入\n- 协调器管理流程\n- 质量门确保一致性\n\n## 代理参考\n\n### 代理分类体系\n\n我们的代理按专业类别组织，以便更好地管理和领域专长：\n\n- **spec-agents\u002F**: 核心工作流协调代理\n- **backend\u002F**: 后端系统专家\n- **frontend\u002F**: 前端开发专家  \n- **ui-ux\u002F**: 用户体验与设计专家\n- **utility\u002F**: 通用工具代理\n\n### 核心工作流代理 (spec-agents\u002F)\n\n| 代理 | 目的 | 输入 | 输出 |\n|-------|---------|--------|---------|\n| spec-orchestrator | 工作流协调 | 项目描述 | 状态报告、路由 |\n| spec-analyst | 需求分析 | 用户描述 | requirements.md, user-stories.md |\n| spec-architect | 系统设计 | 需求 | architecture.md, api-spec.md |\n| spec-planner | 任务规划 | 架构 | tasks.md, test-plan.md |\n| spec-developer | 实现 | 任务 | 源代码、单元测试 |\n| spec-tester | 测试 | 代码 | 测试套件、覆盖率报告 |\n| spec-reviewer | 代码审查 | 代码 | 审查报告、改进建议 |\n| spec-validator | 最终验证 | 所有产物 | 验证报告、质量评分 |\n\n### 按类别划分的专家代理\n\n#### 后端专家 (backend\u002F)\n\n| 代理 | 领域 | 整合点 |\n|-------|--------|-----------|\n| senior-backend-architect | 后端系统与架构 | 架构\u002F开发阶段 |\n\n#### 前端专家 (frontend\u002F)\n\n| 代理 | 领域 | 整合点 |\n|-------|--------|-----------|\n| senior-frontend-architect | 前端系统与架构 | 开发阶段 |\n\n#### UI\u002FUX专家 (ui-ux\u002F)\n\n| 代理 | 领域 | 整合点 |\n|-------|--------|-----------|\n| ui-ux-master | 用户体验与界面设计 | 规划\u002F开发阶段 |\n\n#### 工具代理 (utility\u002F)\n\n| 代理 | 领域 | 整合点 |\n|-------|--------|-----------|\n| refactor-agent | 代码质量与重构 | 任何阶段 |\n\n## 使用示例\n\n### 示例1：企业应用\n\n```bash\n# 高质量的企业系统\n使用质量阈值为95的spec-orchestrator：\n创建一个企业级CRM系统，具备以下功能：\n- 多租户支持\n- 基于角色的访问控制\n- RESTful API\n- 实时仪表盘\n- 审计日志\n```\n\n### 示例2：快速原型\n\n```bash\n# 低质量阈值的快速原型\n使用质量阈值为75且跳过分析师的spec-orchestrator：\n创建一个简单的邮件捕获着陆页\n```\n\n### 示例3：现有需求\n\n```bash\n# 从现有文档开始\n使用从需求开始的spec-orchestrator：\n加载.\u002Fdocs\u002Frequirements.md中的需求，并继续工作流\n```\n\n### 示例4：仅执行特定阶段\n\n```bash\n# 仅对现有代码执行验证\n仅使用spec-orchestrator的验证阶段：\n验证.\u002Fmy-app\u002F中的项目\n```\n\n## 质量门\n\n### 第1道门：规划质量（95%阈值）\n\n- 需求完整性\n- 架构可行性\n- 任务分解质量\n- 用户故事清晰度\n\n### 第2道门：开发质量（80%阈值）\n\n- 测试覆盖率\n- 代码质量指标\n- 安全扫描结果\n- 性能基准测试\n\n### 第3道门：生产就绪（85%阈值）\n\n- 整体质量评分\n- 文档完整性\n- 部署准备情况\n- 运营要求\n\n## 最佳实践\n\n### 1. 项目准备\n\n- 编写清晰的项目描述\n- 包括约束条件和需求\n- 明确质量期望\n- 提供现有文档\n\n### 2. 与代理协作\n\n- 让每个代理完成其阶段\n- 在各阶段之间审查产物\n- 有效利用反馈循环\n- 相信质量门的作用\n\n### 3. 自定义\n\n- 根据需求调整质量阈值\n- 对于简单项目可跳过某些代理\n- 添加自定义验证标准\n- 与现有工作流整合\n\n### 4. 性能优化\n\n- 对大型项目启用并行执行\n- 对迭代开发进行结果缓存\n- 使用分阶段执行\n- 监控资源使用情况\n\n## 高级用法\n\n### 自定义工作流\n\n```python\n# 创建自定义工作流配置\nworkflow_config = {\n    \"quality_threshold\": 90,\n    \"skip_agents\": [\"spec-analyst\"],  # 如果已有需求\n    \"parallel\": True,\n    \"custom_validators\": [\"security-scan\", \"performance-test\"],\n    \"output_format\": \"markdown\"\n}\n\n# 使用自定义配置执行\n\"使用spec-orchestrator并配置：\" + json.dumps(workflow_config)\n```\n\n### 与CI\u002FCD集成\n\n```yaml\n\n# GitHub Actions 示例\n名称: AI 工作流验证\n触发条件: [pull_request]\n作业:\n  validate:\n    运行在: ubuntu-latest\n    步骤:\n      - 使用: actions\u002Fcheckout@v3\n      - 名称: 运行规范验证\n        运行: |\n          # 使用 Claude Code CLI（如果可用）\n          claude-code run spec-orchestrator \\\n            --phase validation \\\n            --project-path .\n\n### 系统扩展\n\n1. **添加新代理**\n   - 使用 YAML 前置元数据创建代理\n   - 明确职责范围\n   - 指定输入输出格式\n   - 更新编排器路由逻辑\n\n2. **自定义质量门控**\n   - 定义新的评估标准\n   - 设置合适的阈值\n   - 实现验证逻辑\n   - 添加到工作流中\n\n3. **领域特定工作流**\n   - 创建专用的编排器\n   - 定义领域模式\n   - 自定义质量标准\n   - 针对特定需求进行优化\n\n## 故障排除\n\n### 常见问题\n\n1. **未找到代理**\n   - 确认代理文件位于正确目录\n   - 检查 YAML 前置元数据格式\n   - 确保文件权限设置正确\n\n2. **质量门控失败**\n   - 仔细检查失败的具体标准\n   - 核实生成的工件是否完整\n   - 允许代理重新修改工作\n   - 考虑调整阈值\n\n3. **工作流卡住**\n   - 检查编排器状态\n   - 查看上一个代理的输出\n   - 寻找错误信息\n   - 从最近的检查点重新启动\n\n### 调试模式\n\n```bash\n# 启用详细日志记录\n使用带有调试模式的 spec-orchestrator：\n创建测试项目并展示所有代理交互\n```\n\n## 贡献说明\n\n我们欢迎各位贡献！请：\n\n1. 遵循现有代理格式\n2. 提供详尽的文档\n3. 包含使用示例\n4. 使用编排器进行测试\n5. 提交带有说明的拉取请求\n\n## 许可证\n\nMIT 许可证 - 详情请参阅 LICENSE 文件\n\n## 致谢\n\n- 基于 Claude Code 的子代理功能构建\n- 受 BMAD 方法论启发\n- 欢迎社区贡献\n\n---\n\n更多信息请参阅：\n\n- [Claude Code 文档](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code)\n- [子代理指南](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fsub-agents)\n- [项目问题](https:\u002F\u002Fgithub.com\u002Fzhsama\u002Fclaude-sub-agent\u002Fissues)","# claude-sub-agent 快速上手指南\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n- **核心工具**：已安装最新版本的 **Claude Code**。\n- **项目基础**：已初始化一个项目目录。\n- **知识储备**：对 AI 辅助开发流程有基本了解。\n\n> **注意**：本工具依赖 Claude Code 的原生子代理（Sub-Agents）功能，无需额外安装 Python 包或 Node.js 依赖。\n\n## 安装步骤\n\n### 1. 获取源码\n克隆仓库到本地：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fzhsama\u002Fclaude-sub-agent.git\ncd claude-sub-agent\n```\n\n### 2. 配置项目结构\n在项目根目录下创建 `.claude` 配置目录，并复制代理定义文件和斜杠命令：\n\n```bash\n# 创建必要的目录结构\nmkdir -p .claude\u002Fagents .claude\u002Fcommands\n\n# 复制所有分类下的代理定义文件 (.md)\ncp -r agents\u002F*\u002F*.md .claude\u002Fagents\u002F\n\n# 复制工作流斜杠命令\ncp commands\u002Fagent-workflow.md .claude\u002Fcommands\u002F\n```\n\n### 3. 配置文档规范 (CLAUDE.md)\n在项目根目录的 `CLAUDE.md` 文件中添加以下规则，以确保生成的文档和代码存放在正确位置：\n\n```md\n## Project Documentation Conventions (Important)\n\n**Documentation Files:** All new documentation or task files must be saved under the `docs\u002F` folder in this repository.For example:\n\n- **Tasks & TODOs**: Save in `docs\u002F{YYYY_MM_DD}\u002Ftasks\u002F` (e.g., `docs\u002Ft2025_08_08\u002Fasks\u002FReleaseTodo.md` for a release checklist).\n- **Requirements\u002FSpecs**: Save in `docs\u002F{YYYY_MM_DD}\u002Fspecs\u002F` (e.g., `docs\u002F2025_08_08\u002Fspecs\u002FAuthModuleRequirements.md`).\n- **Design Docs**: Save in `docs\u002F{YYYY_MM_DD}\u002Fdesign\u002F` (e.g., `docs\u002F2025_08_08\u002Fdesign\u002FArchitectureOverview.md`).\n- **Code Files:** Follow the project structure (place new code in the appropriate src\u002Fmodule folder as discussed).\n- **Tests:** Put new test files under the `tests\u002F` directory, mirroring the code structure.\n\n> **Important:** When creating a new file, ensure the directory exists or create it. Never default to the root directory for these files.\n```\n\n### 4. 验证安装\n确认您的项目结构如下所示：\n\n```text\nyour-project\u002F\n├── .claude\u002F\n│   ├── commands\u002F\n│   │   └── agent-workflow.md\n│   └── agents\u002F\n│       ├── spec-analyst.md\n│       ├── spec-architect.md\n│       ├── spec-developer.md\n│       ├── spec-orchestrator.md\n│       ├── spec-planner.md\n│       ├── spec-reviewer.md\n│       ├── spec-tester.md\n│       ├── spec-validator.md\n│       └── ... (其他专业代理)\n├── CLAUDE.md\n└── ... (您的其他项目文件)\n```\n\n## 基本使用\n\n### 方式一：使用斜杠命令（推荐）\n这是启动完整开发工作流最快捷的方式。直接在 Claude Code 对话框中输入：\n\n```bash\n\u002Fagent-workflow \"Create a task management web application with user authentication\"\n```\n\n**高级用法示例：**\n- 指定高质量标准（阈值 95）：\n  ```bash\n  \u002Fagent-workflow \"Develop a CRM system\" --quality=95\n  ```\n- 仅运行规划阶段：\n  ```bash\n  \u002Fagent-workflow \"Microservices platform\" --phase=planning\n  ```\n- 跳过特定代理（如跳过测试以快速原型开发）：\n  ```bash\n  \u002Fagent-workflow \"Simple blog\" --skip-agent=spec-tester\n  ```\n\n### 方式二：自然语言指令\n您也可以直接通过自然语言调用协调器代理：\n\n```text\nUse the spec-orchestrator agent to create a personal blog platform\n```\n\n**执行流程预览：**\n一旦启动，系统将自动按顺序执行以下阶段：\n1.  **规划阶段**：需求分析 -> 架构设计 -> 任务拆解 -> **质量门禁 1**\n2.  **开发阶段**：代码实现 -> 单元测试 -> **质量门禁 2**\n3.  **验证阶段**：代码审查 -> 最终验收 -> **质量门禁 3**\n\n完成后，您将得到包含需求文档、架构设计、源代码、测试套件及完整文档的生产级项目。","某初创团队的后端工程师需要在两天内从零构建一个具备用户认证和支付功能的电商微服务模块，且必须保证代码质量符合生产标准。\n\n### 没有 claude-sub-agent 时\n- **需求与设计脱节**：开发者独自脑补需求细节，常因理解偏差导致后期反复重构架构，浪费大量时间。\n- **测试覆盖不足**：赶工期时往往跳过单元测试或仅编写简单用例，导致上线后频繁出现边界条件报错。\n- **文档严重缺失**：代码写完后无暇补全文档，后续维护者难以理解业务逻辑，协作效率极低。\n- **质量依赖个人状态**：代码审查完全依赖人工，疲劳状态下容易遗漏潜在的安全漏洞或逻辑缺陷。\n\n### 使用 claude-sub-agent 后\n- **流水线式专业分工**：spec-analyst 和 spec-architect 代理先自动拆解需求并输出严谨的系统设计图，确保开发方向零偏差。\n- **自动化质量门禁**：spec-tester 代理在编码完成后立即生成全覆盖测试用例，未通过质量网关的代码无法进入下一阶段。\n- **文档与代码同步生成**：每个阶段自动产出详细的需求规格书、设计文档和任务清单，直接存入 docs 目录，无需人工补录。\n- **多重验证机制**：spec-reviewer 和 spec-validator 代理进行多轮代码审查与最终校验，系统性消除人为疏忽带来的隐患。\n\nclaude-sub-agent 通过将软件开发拆解为多个专家代理协同工作的标准化流水线，让单人开发者也能以十倍速度交付具备企业级质量的完整功能模块。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzhsama_claude-sub-agent_64da9ba9.png","zhsama","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fzhsama_f98d91b6.jpg","I have no enemy\r\n","@LangGenius",null,"https:\u002F\u002Fgithub.com\u002Fzhsama",572,104,"2026-04-06T10:43:07","未说明",{"notes":83,"python":81,"dependencies":84},"该工具并非独立的 Python 应用程序，而是基于 Claude Code 的 Sub-Agents 功能构建的工作流系统。运行环境核心要求是安装最新版的 Claude Code 客户端。无需配置 GPU、特定 Python 版本或深度学习依赖库。安装过程主要涉及将提供的 Markdown 代理文件复制到项目目录下的 .claude\u002Fagents 和 .claude\u002Fcommands 文件夹，并在 CLAUDE.md 中配置文档规范。",[85],"Claude Code (最新版本)",[13],[88,89,90,91],"agent","claude-code","multi-agent-system","workflow","2026-03-27T02:49:30.150509","2026-04-13T17:43:05.309451",[],[]]