spec-skill
为Claude Code设计的规范驱动开发技能,强制先写规范再编码。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:spec-skill。 它的用途是:为Claude Code设计的规范驱动开发技能,强制先写规范再编码。 完整的 Skill 内容见:https://321skill.com/skills/spec-skill/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“/spec 用户登录模块”,它会先询问你关于该功能的目标、范围和约束条件,然后生成一份详细规范供你确认。批准后,它会将规范拆解成具体的开发任务,并引导你逐一完成编码和测试。
介绍
spec-skill 解决了AI辅助开发中常见的“仓促编码导致返工”问题。它强制实施一个“访谈→规范→任务→实现→验证”的五阶段工作流,确保在编写任何代码之前,先与用户对齐需求并生成一份书面规范文件。
使用时,只需在Claude Code中输入 /spec 功能名称 或说出“让我们先规划一下”等触发短语。技能会引导你完成需求访谈,生成规范的Markdown文件供你审核批准,然后将其拆解为原子任务逐一实现,并在最后自动运行测试进行验证。
这个技能非常适合追求代码质量、需要记录决策过程或经常中断开发会话的开发者,如全栈开发、后端开发和项目经理。它尤其适用于功能开发、重构遗留代码或拆解复杂项目任务等场景。
建议在项目初期或接手复杂任务时启用此技能。请注意,它要求先安装oh-my-claudecode框架,并且生成的规范文件会永久保存,作为项目的决策日志。
核心特点
与直接生成代码的技能不同,它强制实施“先规范后代码”的硬性流程,通过结构化访谈和持久化的规范文件,从根本上防止需求误解和方向性错误,并能完美恢复中断的开发会话。
注意事项
不适合需要快速原型验证或简单脚本编写的场景,因其强制性的前期规划流程会拖慢节奏。
常见问题
规范文件保存在哪里?
默认保存在项目根目录的 `.claude/specs/` 文件夹下,可通过配置文件修改位置。
可以中途修改规范吗?
可以,在规范生成阶段可以回复“edit <修改内容>”来更新规范,后续任务将基于新规范执行。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/spec-skill/raw/index.md 读取 spec-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/spec-skill/raw/index.md(查看排版版本)