Claude Workflow：结构化AI编程工作流与多代理评审体系

一套包含8个核心命令和27个代理角色的Claude Code工作流框架，通过结构化规划、多代理评审和知识沉淀机制，为AI辅助编程带来工程纪律。

"claude-workflow"不是一个简单的代码生成工具，而是一套完整的工作流框架。其核心理念可以用一句话概括："你说WHAT，Claude处理HOW"。无论任务规模是简单的Bug修复还是完整的V2版本重构，同一套管道都能自适应缩放。

这一设计哲学解决了AI辅助编程中的几个常见痛点：上下文丢失导致的重复沟通、缺乏规划导致的代码质量不稳定、以及会话结束后知识无法沉淀的问题。通过结构化的命令体系和多代理评审机制，项目试图在开发效率和工程纪律之间找到平衡点。

项目定义了八个核心斜杠命令，构成完整的开发生命周期：

/kickoff - 项目启动命令。初始化工作区，加载项目章程（constitution）和代理名册（agent roster）。这是每个新会话或新项目的起点，确保AI助手从一开始就了解项目背景和协作规则。

/spec - 需求定义阶段。通过问答式交互收集需求细节，同时追踪置信度指标。不同于简单的功能描述，这个阶段会深入挖掘边界条件、性能要求和用户体验预期。

/spec-review - 需求评审阶段。27个预定义的代理角色从不同维度审视需求文档，检查需求完整性、识别潜在缺口和歧义、评估可行性、控制范围膨胀、并确认利益相关者覆盖。每个代理都有特定的评审视角，如安全专家关注安全需求、UX设计师关注交互细节等。

/plan - 技术规划阶段。在需求通过评审后，系统生成详细的技术方案，涵盖API设计、数据模型、用户体验、可扩展性、安全性和系统集成等维度。

/check - 规划检查阶段。作为质量门禁，验证技术规划的完整性、任务排序合理性、风险识别充分性、范围控制严格性和可测试性保障。

/build - 并行执行阶段。在前序阶段全部通过后，进入代码实现阶段。系统支持并行开发多个模块，同时集成TDD（测试驱动开发）和验证机制确保代码质量。

/wrap - 会话收尾阶段。这是项目的独特设计之一。不同于简单的结束对话，/wrap命令会将会话中学到的知识、遇到的坑和解决方案编译成结构化记忆，供后续会话读取。这解决了AI编程中最令人头疼的上下文丢失问题。

项目的创新之处在于引入了多代理评审体系。27个预定义的代理角色在/spec-review、/plan和/check阶段参与评估，每个角色都有特定的专业视角：

• 需求分析师：检查需求完整性和一致性
• 安全专家：识别潜在安全风险
• UX设计师：评估用户体验和交互流程
• 性能工程师：关注可扩展性和性能瓶颈
• 可测试性专家：确保测试覆盖和可验证性
• 范围管理员：控制功能蔓延
• 利益相关者代表：确认各方需求被考虑

这些代理并非真正独立运行，而是通过精心设计的提示词让Claude Code模拟不同角色的视角进行评审。项目使用"Judge · Dedupe · Synth"模式对评审结果进行聚类、去重和综合，生成结构化的评审报告。

传统的AI编程会话存在一个根本问题：一旦会话结束，所有的上下文、决策理由和经验教训都随之消失。下次开启新会话时，开发者需要重新解释项目背景。

/wrap命令正是为解决这一问题而设计。在会话结束时，它会自动：

• 总结本次会话的关键决策和学习点
• 识别遇到的坑和解决方案
• 更新项目知识图谱（Knowledge Layer）
• 记录代理评审的效能指标（哪些代理发现了真正的问题，哪些是噪音）

这些沉淀的知识会在下次/kickoff或/spec时被读取，使新会话能够"热启动"，无需重复背景介绍。

项目设计了一个智能的工作流缩放机制，根据任务规模自动调整流程深度：

• Bug修复：描述问题 → 直接修复 → 验证
• 小型变更：快速/spec → /build
• 功能开发：完整流程 /kickoff → /spec → /spec-review → /plan → /check → /build
• V2/重构：修订现有规格 → 完整流程

这种灵活性确保了小任务不会被过度流程化拖累，大任务又能获得足够的规划保障。

项目还提到了与Codex的集成可能性。Codex可以作为对抗性评审员，在/spec-review、/check和/build阶段挑战AI的决策，发现潜在盲点。这种"红队"机制对于关键系统的开发尤为重要。

项目的安装非常简洁，一条命令即可完成：

git clone https://github.com/Jstottlemyer/claude-workflow.git ~/Projects/claude-workflow && cd ~/Projects/claude-workflow && ./install.sh

安装完成后，在任何项目目录中输入/kickoff即可初始化工作流，或输入/flow查看参考卡片。