speclet
基于规格驱动的AI辅助编码工作流工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：speclet。 它的用途是：基于规格驱动的AI辅助编码工作流工具 完整的 Skill 内容见：https://321skill.com/skills/speclet/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用speclet-draft技能，为‘用户登录模块’创建一个功能草案。”，它会引导你以Markdown形式描述需求、验收条件和边界情况。然后，你可以说：“基于刚才的草案，生成详细的JSON规格。”，Speclet技能会将其转化为包含具体测试用例的结构化规格文件，为后续实现和自动验证提供明确依据。
介绍
Speclet 旨在解决开发者在利用AI助手（如Claude、GPT）进行编码时，需求与实现容易脱节、上下文难以持续、决策记录分散等问题。它提供了一个结构化的四阶段工作流：从Markdown草案，到生成JSON规格说明，再到具体实现，最后归档，确保每个开发故事（story）都清晰可追踪。
使用Speclet，你只需在项目中运行一行安装命令，它便会自动创建一套包含指南、模板、技能和运行脚本的目录结构。开发者随后可以通过配套的AI技能（如speclet-draft, speclet-spec）与AI交互，将自然语言需求转化为结构化的开发规格，并利用循环运行器（speclet.sh/speclet.ps1）在验证通过后自动提交代码。
它非常适合需要与AI结对编程、管理复杂功能开发或希望将开发过程文档化的工程师，尤其是全栈开发、后端开发和智能体开发者。对于独立开发者或小团队，它能有效规范AI协作流程，避免混乱。
建议在开始一个新功能模块时引入Speclet，并充分利用其DECISIONS.md来记录关键架构选择，这能帮助AI在后续迭代中保持一致性。注意，它更适用于有一定复杂度的功能开发，而非简单的代码片段生成。
核心特点
Speclet的核心在于其严格的“规格驱动”工作流和原子提交理念，它将AI辅助编码从临时的对话提示升级为可追踪、可验证的工程项目管理。与同类工具相比，它通过JSON规格文件（包含passes字段）明确验收标准，并内置了从草案到归档的完整生命周期管理，确保AI生成的代码始终对齐原始需求。
注意事项
不适合用于快速生成一次性脚本或进行简单的代码片段问答，其完整工作流更适合中大型、需要持续维护的功能开发任务。
常见问题
Speclet 和直接问AI写代码有什么区别？
Speclet通过结构化工作流（草案->规格->实现）确保需求被清晰定义和验证，避免了AI在多次对话中偏离原始目标，并使开发过程可追踪、可复盘。
安装Speclet会修改我的项目结构吗？
会，它会创建 .speclet、.opencode/skill/ 等目录，并添加运行脚本，但会更新.gitignore以避免提交不必要的文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/speclet/raw/index.md 读取 speclet 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/speclet/raw/index.md（查看排版版本）