Gepetto 说明文档

# /gepetto > 🪵 就像 Gepetto 从粗糙的木头中雕刻出匹诺曹一样，将模糊的想法转化为生动的实施计划 正如这位大师工匠将粗糙的木材雕刻成栩栩如生的木偶，**Gepetto** 将你粗糙的功能草图转化为详细的、经过实战检验的、随时可以付诸行动的规范。 **Gepetto** 通过结构化研究、利益相关者访谈和多智能体审查，将模糊的想法雕刻成全面的、分章节的实施计划。 ## 工艺 Geppetto 不会仓促行事。你的规范也不应该。 - **粗木**（你的初始规范）→ 研究与细化 - **精心雕刻**（访谈与综合）→ 形状显现 - **精细细节**（外部审查）→ 大师工匠审查你的工作 - **最终打磨**（章节）→ 准备就绪 - **赋予生命**（Ralph-loop）→ 你的创作开始运行 ## 问题 你: "Claude，帮我构建一个认证系统" Claude: *立即开始编码* 结果: 反复迭代、遗漏边缘情况、范围蔓延 ## 解决方案 你: "/gepetto @planning/auth-spec.md" gepetto: 研究 → 访谈 → 规范 → 计划 → 外部审查 → 章节 结果: 清晰的实施路线图，经由多个智能体审查，准备执行 ## 目录 - [安装](#installation) - [工作流](#workflow) - [快速开始](#quick-start) - [何时使用](#when-to-use) - [输出文件](#output-files) - [外部审查](#external-review) - [恢复](#resuming) - [最佳实践](#best-practices) - [实施计划](#implementing-the-plan) - [与 ralph-loop 集成 (可选)](#integration-with-ralph-loop-optional) - [与 Ralphy 集成 (可选)](#integration-with-ralphy-optional) - [文件结构](#file-structure) ## 安装 **仅限 Claude Code** - 此技能专为 Claude Code 设计。 ### 推荐：插件安装 **第一步：** 添加市场（仅首次需要） bash /plugin marketplace add softaworks/agent-skills **第二步：** 安装 gepetto bash /plugin install gepetto ### 替代方案：手动安装 bash npx add-skill softaworks/gepetto # 或 cp -r skills/gepetto ~/.claude/skills/ ### 对于 claude.ai 虽然不是主要用例，但你可以将此技能添加到项目知识中，或将 SKILL.md 内容粘贴到对话中以获取基本指导。 --- ## 工作流 ┌─────────────────────────────────────────────────────────────────┐ │ gepetto 流水线