spec-dev

一个从设计到执行的AI开发流程插件,将想法转化为可执行的代码。

安装使用

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

帮我安装这个 AI Skill:spec-dev。
它的用途是:一个从设计到执行的AI开发流程插件,将想法转化为可执行的代码。
完整的 Skill 内容见:https://321skill.com/skills/spec-dev/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“我想开发一个用户注册功能,需要邮箱验证和密码强度检查,请用spec-dev流程帮我处理。” 它会首先引导你进入需求分析阶段,通过提问和对抗性验证明确所有边界情况,并生成详细的设计规格。然后,它会将规格分解为一个个包含具体文件路径、完整代码和测试步骤的原子任务。最后,它在独立的Git工作树中逐个执行这些任务,每完成一个都进行提交和自检,全部完成后进行多维度审查并生成总结报告。

介绍

spec-dev 是一个面向AI辅助开发的技能插件,它构建了一套严谨的“设计→规划→执行”工作流,旨在将模糊的想法系统地转化为高质量的代码实现。它通过强制性的设计审查、任务分解和测试驱动开发,确保开发过程的纪律性和产出的可靠性。

使用时,你可以从一个不成熟的想法开始,利用其“探索模式”进行无负担的头脑风暴。一旦想法成型,便进入“需求分析”阶段,通过对抗性验证和多方案比较,产出结构化的行为需求规格说明。随后,系统会自动生成包含完整代码和TDD步骤的“实现计划”,并在隔离的工作空间中逐一执行和审查。

该技能特别适合追求代码质量、需要处理复杂需求或希望AI开发过程更可控、可复现的开发者。无论是构建新功能还是重构旧代码,它都能提供清晰的路径和严格的约束。

建议在项目初期就引入此技能,以建立规范。对于小型、紧急的修复,可以使用其“快速修复”路径。注意,其严谨的流程可能对极其简单或探索性极强的原型开发略显繁重,此时可灵活使用其探索模式。

核心特点

与常见的“生成代码并执行”的AI技能不同,spec-dev强制引入了“设计批准”硬门禁,确保在写任何代码前完成充分的需求分析和规格定义;同时,其“实现计划”要求包含完整的、可直接执行的代码和TDD步骤,杜绝了模糊的占位符,使执行过程完全零上下文。

注意事项

不适合需要快速验证概念、进行天马行空自由探索或处理极其简单、无需设计的微调任务。

常见问题

spec-dev 能帮我直接写代码吗?

能,但更准确地说,它通过一套流程来确保代码被正确地设计和编写。它会先帮你分析需求、制定规格,然后生成详细的、包含完整代码的实现计划,最后在隔离环境中执行并审查。

使用 spec-dev 会不会很慢?

对于已明确的小问题,可以使用“quick-fix”快速路径。对于新功能开发,其前期设计投入会花费时间,但能显著减少后期返工和错误,从整体项目周期看往往是更高效的。

给 AI 助手的安装指引

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

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