Spec-workflow 是一个基于文档与目录结构的规格驱动开发工作流,主要用于协调多代理(agent)协作完成非平凡开发任务。其核心思想是:在开始任何涉及多文件、架构选择或需要委托给代理团队的工作之前,先创建一份规格(spec),并以 .claude/specs/<slug>/ 目录承载整个开发周期的各类文档。
用途方面,该工作流面向需要并行化、可追踪、可验证的复杂开发任务,尤其适合由多个代理分工协作的场景。它强调任务分组、并行执行、分级测试、多轮评审以及基于磁盘证据的协调,而非依赖消息传递的可靠性。
主要能力包括:规格文档结构(spec.md、design.md、tasks.md、review.md、review-e2e.md、sa-review.md、test-plan.md、test-evidence.md、decisions.md、requirements.md、prd/ 等);任务格式与并行分组规则(组内任务同时执行,组间顺序执行,任务需自包含、指定文件路径、包含验证命令);并行化指南(最大化并行、按文件/模块边界拆分、前置共享接口、保持编码与 DevOps 任务文件不冲突);并行评审机制(合成者与分析师分工,磁盘优先记录);开发循环(计划 -> 交接包 -> 构建 -> 评审 -> 修复 -> 端到端评审 -> 文档 -> 清理);安全扫描修复优先级;验收标准中的验证优先级(如静态加密、传输加密、访问日志、数据分类标签);无服务器相关验收标准(Lambda 事件模式、SAM 构建与本地调用、API Gateway 授权、Aurora DSQL 模式、Amplify 沙箱部署);测试分层(T1 单元、T2 集成/契约、T3 部署资源验证、T4 端到端旅程);完成标准(零 Critical/Severe/High 发现 + 测试通过 + 四层测试通过或明确声明并升级 + 所有任务完成);实时验证门(IaC/部署/脚本工具需真实部署->冒烟->销毁);验证验证器本身;评审周期预算(每个评审范围 3 轮,分组与端到端独立计数);保障措施(决策日志、重复障碍升级、以磁盘+哨兵+git diff+tasks.md 为事实依据)。
使用方式上,用户需在 .claude/specs/<slug>/ 下按模板或结构创建规格文件,任务写入 tasks.md 并按组并行执行,同时使用共享任务列表(TaskCreate/TaskUpdate/TaskList)进行实时协调。主代理承担 fullstack-agent 角色,负责编写规格、设计、任务计划并生成交接包,经确认后启动代理池并驱动构建-评审循环。评审时合成者负责撰写 review.md 并给出每组的 PASS/FAIL,分析师将发现写入规格树外的临时路径。测试需按 T1-T4 分层执行并在 test-evidence.md 记录证据。安全扫描使用 bandit、semgrep、safety、checkov 等命令输出结果到规格目录。
适用场景包括:多代理协作的复杂开发任务、需要并行任务组与严格评审的工程流程、涉及基础设施即代码(IaC)与部署的变更、需要分级测试与端到端验证的项目、以及需要安全扫描与合规检查的场景。
限制方面:该工作流依赖 .claude/specs/ 目录结构与模板文件(docs/specs/templates/),若目录缺失需按文件描述的结构执行;部分验证(如实时部署验证)在无法运行的环境中只能记录为仅作者与静态验证并升级;评审周期预算固定为 3 轮,不得随意重置或绕过;消息传递不可靠,因此以磁盘记录为准;具体收费、价格、平台支持等信息资料未提供。