SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场idea-to-blueprint

idea-to-blueprint

写作与研究

查看项目

更新于 10-30 04:39

技能介绍

用途

Idea to Blueprint 用于把一段原始的产品、应用、机器人或功能想法（哪怕只有两三行）转化为一份单一的 Markdown 构建蓝图。这份蓝图不是宽泛意义上的“PRD”，而是人类、调研结果与未来每一次构建会话之间唯一的共享记忆。它面向需要深度网络调研、市场调研或竞品对标，或需要带论证与锁定版本的架构/技术栈建议、代码质量与评审标准的场景，也适用于用户想要一份“给 Claude Code/Codex 的计划”，让编码智能体一次执行一个史诗。当调研深度、严谨性或零幻觉很重要时，它优于更轻量的 PRD 技能。它不用于评审已有 PRD、孤立比较两个框架，或撰写单条 UX 文案。

主要能力

该技能围绕三个习惯组织：

  • 有证据或沉默：关于外部世界的每一项断言（库、版本、竞品、法规、市场数据、某服务在某国的可用性）都带证据标签：[VERIFIED — <来源>, <日期>]、[ASSUMED — <原因>] 或 [UNKNOWN → OQ-nn]（转入开放问题）。绝不用听起来合理的猜测填补空白。
  • 做决定，不含糊：“用 X 或 Y”会把决定推给上下文更少的智能体。要做出判断，记录备选方案及其落选原因。
  • 为零上下文写作：没有“如前所述”“按惯例”。每个 ID（画像、流程、屏幕、文案行、故事、标准）都唯一且交叉引用，使全新会话能通过搜索解析一切。

蓝图包含：架构驱动因素与风格、带证据标签的版本锁定技术栈、质量门禁、用户画像、流程、UX 文案、边界情况，以及拆分为故事并附 Given/When/Then 验收标准、测试和完成定义（DoD）的史诗。蓝图内嵌会话协议，使 Claude Code 或 Codex 每次全新会话构建一个史诗。

使用方式

工作流分为六个阶段：

  • 阶段 0 需求采集：解析想法，做 2–5 次搜索热身，用默认值提出一批问题并等待。先热身，问题要具体；一批提问，每题带默认值；不问已回答或可推断的内容；只问会改变架构、画像或范围的问题。
  • 阶段 1 深度调研与对标：按七条轨道依次进行——理解想法、竞品对标（5–10 个直接与间接竞品）、架构驱动因素与形态、面向智能体工程的技术栈、质量门槛与工具、集成与本地现实、UX 对标。先 C 后 D 很重要：先选框架再写恰好为其辩护的驱动因素，是此类文档最常见的隐性失败。记录每个来源（URL、标题、访问日期）。若网络工具不可用，应停止并告知用户。
  • 阶段 2 决策简报（检查点）：在写文档前，用用户语言在聊天中发布约一屏的简报，包含对想法的解读、用户、画像、对标、架构驱动因素、形态、技术栈、质量门禁、设计方向、史诗顺序、需要用户回答的问题和假设表。用户回复“go”后写完整蓝图，或修正任意一行。
  • 阶段 3 撰写蓝图：逐节分块写入一个 .md 文件。ID 无处不在（P1、F-01、SCR-01、CP-<screen>-<n>、ENT-…、E00…、E03-S02、AC-1…、OQ-01…、EC-<cat>-<n>）。机器面向文本用英文，人类面向散文用用户语言。每个标题带英文锚点。深度优先于简洁。每个决定都要说明落选方案及其代价。
  • 阶段 4 校验与交付：运行 python3 <技能文件夹>/scripts/lint_blueprint.py <蓝图路径>，修复所有报错。校验器检查必需章节、占位文本、故事 ID 唯一性、每个故事是否有验收标准/边界情况/测试、每个史诗是否有 DoD、[UNKNOWN → OQ-nn] 是否解析到开放问题、技术栈行是否带证据标签、每个画像是否被至少一个故事使用、是否存在带 URL 的来源章节，以及质量层（架构驱动因素 AD-n 是否可测量并被风格决定引用、质量章节是否有 check 命令与评审清单、是否声明适应度函数、是否出现被禁的生产力指标）。随后做人工通读。交付时：在带文件工具的聊天界面保存到 outputs 目录为 <product>-blueprint.md；在 Claude Code/Codex 中保存到仓库 docs/BLUEPRINT.md，并创建 docs/PROGRESS.md、docs/DECISIONS.md 和 AGENTS.md + CLAUDE.md。最后给出 5–10 行收尾消息。
  • 阶段 5 构建会话：用户使用蓝图内嵌的协议，每次全新 Claude Code/Codex 会话运行一个史诗。

适用场景

当有人分享产品、应用、机器人或功能想法并想要 PRD、规格、待办列表、史诗、用户故事、路线图或 MVP 计划时使用，即使没有说“PRD”。当用户想要深度网络调研、市场调研或竞品对标时使用。当用户想要带论证和锁定版本的架构或技术栈建议，或新产品的代码质量与评审标准时使用。当用户要求“给 Claude Code/Codex 的计划”，让编码智能体一次执行一个史诗时使用。

限制

不用于评审已有 PRD、孤立比较两个框架，或撰写单条 UX 文案。若网络工具不可用，仅凭记忆写出的蓝图无法达到零幻觉标准，此时要么用户启用网络访问，要么文档交付时把所有外部事实标为 [UNVERIFIED] 并在封面加警告。规划技能不授权更改宿主设置，应尊重用户的预算与偏好。不要打乱阶段顺序：在需求采集答案前调研会把搜索浪费在错误问题上；在简报获批前写作会浪费文档。

来源与许可

这是作者自己的技能，以 MIT 许可证发布在 iniesohidham/idea-to-blueprint（见 LICENSE）。捆绑文件源自上游，并做了目录维护层面的安全、示例与校验修正；此 SKILL.md 在上游指令周围增加了目录章节（Overview、When to Use、Examples、Limitations、安全说明）。