spec-flow

将复杂功能开发转化为分阶段、可确认的规范驱动工作流。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:spec-flow。
它的用途是:将复杂功能开发转化为分阶段、可确认的规范驱动工作流。
完整的 Skill 内容见:https://321skill.com/skills/spec-flow/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘spec-flow — 为我们的电商平台添加购物车商品推荐功能’。它会首先生成一份功能提案,阐述背景和目标,等你确认后,再继续产出详细的EARS格式需求文档。你可以随时审阅并说‘继续’,或直接说‘execute all’让它按设计好的任务列表自动完成全部实现。

介绍

Spec-Flow 旨在解决AI编码代理在开发复杂功能时可能出现的思路跳跃、需求不清和实现混乱的问题。它通过一个结构化的五阶段工作流(提案、需求、设计、任务、实现),将开发过程分解为可管理、可确认的步骤,确保每一步都经过用户审核,从而提升代码质量和项目可控性。

使用时,用户只需用触发词(如“spec-flow”、“写个方案”)启动,AI便会按顺序生成每个阶段的详细文档(存储在.spec-flow/目录中),并在进入下一阶段前等待用户确认。用户可以选择逐步确认、批量执行或按阶段执行,灵活控制开发节奏。

这个Skill特别适合需要严谨开发流程的开发者、项目经理或技术负责人,尤其是处理中大型功能、重构或团队协作项目时。它帮助将模糊的想法转化为清晰、可执行的开发计划。

建议在开始新功能模块或复杂重构时使用。对于简单修改或探索性编程,可以使用--fast参数跳过确认,或--skip-design参数简化流程。生成的文档应纳入版本控制,便于团队协作和项目复盘。

核心特点

与普通代码生成Skill不同,Spec-Flow强制实施分阶段、文档先行的开发流程,并在每个关键节点等待人工确认,确保开发方向始终与用户意图对齐。其生成的“活文档”不仅指导本次开发,也构成了项目的长期技术资产。

注意事项

不适合需要快速原型验证或进行简单、微小代码修改的场景,可能会因流程步骤而显得不够敏捷。

常见问题

Spec-Flow会拖慢开发速度吗?

对于复杂功能,前期规划能避免后期返工,总体更快。对于简单任务,可使用`--fast`模式或直接编码。

生成的文档有什么用?

文档是“活”的,指导当前开发;存档后可作为项目知识库,方便新成员理解、复盘和后续维护。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/spec-flow/raw/index.md 读取 spec-flow 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。