shinpr/claude-code-workflows

它解决了什么问题

Claude Code Workflows 提供了一种结构化的、具代理能力的开发生命周期，确保生成的代码严格符合设计文档与测试。它通过为开发流程的每个阶段引入专门代理，防止 AI 生成的代码偏离原始需求或无法通过自身测试的常见问题。

它是如何工作的

该项目实现了一系列「食谱」（入口点），将用户请求引导至一系列专门代理的管道。根据任务复杂度（小、中、大），工作流程会有所不同：

• 分析与规划：requirement-analyzer 判断工作规模。对于较大的任务，它会触发产品需求文档（PRD）的创建、代码库分析以及技术设计文档。

• 执行：专门的执行者（后端或前端）使用测试驱动开发（TDD）实现功能，确保代码经过类型检查与 lint。

• 验证：code-reviewer 与 code-verifier 会根据设计文档检查实现，确保没有遗漏任何需求。

• 诊断：在 investigator、verifier 与 solver 之间的专用循环用于根本原因分析错误，并提出经过权衡分析的解决方案。

• 逆向工程：系统可以扫描现有代码以生成 PRD 与设计文档，使遗留代码库变得 AI 友好。

适用对象

使用 Claude Code 的开发者，若希望拥有比简单聊天式代码生成更具决定性、专业的软件工程流程，则此项目适合您。特别适合从事后端 API、React/TypeScript 前端或全栈应用程序开发的人员。

特色

• 层级感知工作流程：后端、前端与全栈开发的独立插件，各具专门代理（例如 React 的 ui-spec-designer）。
• 多代理协调：使用代理链（Analyzer $ ightarrow$ Designer $ ightarrow$ Planner $ ightarrow$ Executor $ ightarrow$ Reviewer）来保持干净的上下文窗口。
• UI 规范：前端工作的专门步骤，用于捕捉原型常遗漏的边缘情况（加载、错误、空白状态）。
• 自动化文档生成：能将现有代码逆向工程为结构化的 PRD 与设计文档。
• TDD 整合：内建测试优先实现与质量修正的原则。