@dk/shipshape
一个便携、三角色、规范驱动的AI编程工作流框架。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@dk/shipshape。 它的用途是：一个便携、三角色、规范驱动的AI编程工作流框架。 完整的 Skill 内容见：https://321skill.com/skills/dk-shipshape/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用Shipshape工作流，根据这份API接口规范，为我生成一个用户管理模块的Node.js代码。”，它会首先引导AI作为“规划师”拆解模块结构，然后作为“工程师”编写具体路由、控制器和服务层代码，最后作为“审查员”检查代码风格、错误处理和安全性，并给出优化建议。
介绍
Shipshape 旨在解决AI编程助手（如Pi）在执行复杂开发任务时，因缺乏结构化协作流程而导致的代码质量不稳定、上下文切换混乱和效率低下的问题。它提供了一个基于规范（spec）驱动的便携式工作流，将任务分解为“规划师”、“工程师”和“审查员”三个明确角色，通过标准化的交互协议引导AI分步骤、高质量地完成编码任务。
使用Shipshape时，开发者需要为其提供一个清晰的任务规范（spec），该框架会引导AI依次扮演三个角色：首先由“规划师”拆解任务并制定方案，然后由“工程师”编写具体代码，最后由“审查员”进行质量检查和优化建议，形成一个闭环的开发流程。
它非常适合依赖AI进行代码生成、重构或复杂功能开发的个人开发者、技术团队以及希望提升AI编码输出可靠性的用户。尤其适合在需要高质量、可维护代码产出的项目初期或重构阶段使用。
建议在使用前仔细编写任务规范，明确输入输出和约束条件，以获得最佳效果。注意，该框架更适用于有明确目标和边界的编程任务，对于高度探索性或创意性强的原型设计，可能需要更灵活的交互方式。
核心特点
核心区别在于其严格的三角色（规划、执行、审查）职责分离与基于规范的驱动模式，强制AI进行结构化思考与自我审查，而非单次、线性的代码生成，这显著提升了复杂任务的完成质量和代码可靠性。
注意事项
不适合需要快速头脑风暴、高度自由探索或仅需简单代码片段的轻量级、即时性编程需求。
常见问题
Shipshape 支持哪些AI助手？
主要设计用于Pi，但其便携式设计理论上可适配其他具有编程能力的AI代理（如Claude等）。
需要编程经验才能使用吗？
是的，用户需要具备一定的编程知识来编写有效的任务规范和评估输出结果。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/dk-shipshape/raw/index.md 读取 @dk/shipshape 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/dk-shipshape/raw/index.md（查看排版版本）