puffin
为Claude Code提供结构化开发环境，将AI编码转化为可追踪的软件工程流程。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：puffin。 它的用途是：为Claude Code提供结构化开发环境，将AI编码转化为可追踪的软件工程流程。 完整的 Skill 内容见：https://321skill.com/skills/puffin/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“基于用户故事‘用户可以通过OAuth登录’，请生成实施计划。” 它会通过CRE分析依赖（如需要先设置API路由和数据库表），生成任务序列和RIS规格。然后你对Claude Code说：“请根据RIS规格#1实现OAuth后端路由。” 它会基于代码模型的上下文，生成准确的代码，并在完成后运行预设的检查断言进行验证。
介绍
Puffin解决的核心问题是：当使用Claude Code等AI编码助手进行中大型项目开发时，传统的对话式、即兴的提示方式会导致上下文丢失、需求与实现脱节、代码结构混乱，难以进行团队协作和项目追踪。
Puffin通过引入中央推理引擎（CRE），将开发流程结构化。它将模糊的需求转化为用户故事，再由CRE生成包含依赖分析和任务排序的实施计划，进而产出可供AI执行的确定性规格说明（RIS）。Claude Code基于这些规格和持续维护的代码模型进行编码，最后通过检查断言来验证代码正确性，形成一个从需求到验证的完整、可追溯的闭环。
它非常适合需要与AI协作进行复杂软件开发的团队或个人，特别是全栈开发、项目经理以及那些希望将AI编码从实验性探索转向可重复、可管理工程实践的开发者。
使用建议：初次使用建议从小型项目或模块开始，熟悉从创建用户故事到生成RIS的流程。充分利用其代码模型和内存插件功能来维护项目架构知识，避免重复解释。对于超大型单体项目，可考虑按功能模块拆分成多个Puffin项目进行管理。
核心特点
与普通AI编码工具不同，Puffin的核心在于其“中央推理引擎”驱动的结构化工作流，它将随机的提示对话转化为“用户故事→实施计划→确定性规格说明”的瀑布式工程流程，并通过自动维护的代码模型确保架构知识不丢失，实现了从需求到代码的完整可追溯性。
注意事项
不适合用于快速原型验证、一次性脚本编写或偏好高度自由、探索式对话编程的场景。
常见问题
Puffin和直接使用Claude Code有什么区别？
Puffin不是替代Claude Code，而是为其提供结构化的工作流界面。它用工程方法（故事、计划、规格、模型）管理编码过程，而Claude Code仍是执行终端命令的“手”。
Puffin能用于非代码项目吗？
目前主要针对软件开发。其结构化思维（故事→计划→规格→验证）可能启发其他领域，但核心功能围绕代码模型和AI编码代理设计。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/puffin/raw/index.md 读取 puffin 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/puffin/raw/index.md（查看排版版本）