fernando-skills

基于规格驱动设计的代码开发助手,先规划后实现。

安装使用

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

帮我安装这个 AI Skill:fernando-skills。
它的用途是:基于规格驱动设计的代码开发助手,先规划后实现。
完整的 Skill 内容见:https://321skill.com/skills/fernando-skills/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

‘/spec’,它会引导你描述新功能需求,并通过一系列澄清问题,帮你生成一份详细的功能规格文档。之后,

对AI说:‘/spec-impl 01-user-auth’,它会读取已批准的`specs/01-user-auth.md`文件,并严格按照其中的设计,分步骤地生成和修改代码,每步完成后都会暂停等待你的审查。

介绍

该技能旨在解决使用Claude Code等LLM进行开发时,因AI快速生成代码而导致的决策隐形成本问题。传统方式下,AI会快速做出大量隐含设计决策,导致后续修改困难、会话间上下文丢失以及上下文窗口浪费。

Spec-Driven Skills通过引入一个强制性的规格文档(Spec)作为开发的核心契约来解决这些问题。使用流程分为六步:描述问题、AI规划模式、人工决策与细化、保存规格文档、分步执行实现、以及分步代码审查。这确保了设计决策被显式记录和遵循。

它特别适合那些需要清晰设计记录、团队协作或处理复杂、长期项目的开发者。对于追求代码质量、可维护性以及希望将AI的“快思考”转化为可控、可追溯开发流程的团队来说,这是一个理想工具。

建议在开始新功能或模块开发时使用此技能,并确保团队都遵循“先有规格,后有代码”的原则。注意,规格文档需要作为项目资产进行版本管理和维护。

核心特点

核心区别在于将规格文档(Spec)从可选的“文档”提升为强制性的、版本化的“开发契约”,并提供了与Claude Code深度集成的、标准化的六步工作流来严格执行这一过程,确保AI的代码生成完全遵循预先批准的设计。

注意事项

不适合快速原型验证、一次性脚本编写或对开发流程规范性要求不高的简单任务。

常见问题

这个技能和直接让AI写代码有什么区别?

它强制先进行设计规划并生成可追溯的规格文档,避免了AI在代码中隐含决策,使开发过程更可控、可协作。

规格文档需要手动编写吗?

不需要,使用 `/spec` 技能,AI会通过问答引导你生成规格文档,你只需做出关键决策。

给 AI 助手的安装指引

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

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