Blueprint 规划会话技能
在写代码之前,通过多轮问答替你梳理设计决策,为编码代理生成一份可直接执行的实施计划。
证据显示该技能为只读的规划问答流程,明确禁止写代码文件、要求向用户提问并由用户决定结束,无依赖安装、无外部调用、无敏感数据处理;扣分点:无破坏性风险但确认与回滚机制仅是流程约定而非硬性保障,且发布者身份未经验证。
SKILL.md 指令自洽,引用的 references 文件(templates.、questions.md、refine-prompt.md)均存在且格式一致;扣分点:无任何测试或关键路径复现证据,静态审查上限10,短格式答案解析等边缘行为的容错只有描述性指引。
适用场景、非适用范围(视觉前端、小重构、debug 打磨)在 README 中有明确说明,触发描述清晰、与能力匹配;扣分点:完全依赖英文交互,无中文支持说明,且需兼容的 agent harness,对中国大陆网络环境适配无声明。
MIT 许可清晰,文档分层良好(SKILL.md + references),模板可自定义且有说明;扣分点:无版本号、无 changelog,templates. 需在两个技能目录手动同步是隐藏假设,维护责任与更新路径仅间接体现。
README 有清晰的价值主张和与竞品对比,输出为可直接使用的 markdown 计划文件;扣分点:静态审查上限7,无已执行的计划产物或第三方使用证据证明输出质量,价值主张仅来自作者自述与用户引语。
有可审计的一手材料:完整技能源码、模板、许可、README;扣分点:无测试套件、无 CI 覆盖该技能关键路径的证据,用户引语不可独立验证,上限5。
- 本评估为静态源码审查,未执行任何技能流程,实际问答质量与计划生成效果未经独立验证。
- 技能仅提供英文交互,无中文支持声明;中国大陆用户使用体验可能受影响。
- templates. 需在 blueprint 与 blueprint-generate 两个技能目录间手动保持同步,自定义模板时容易遗漏。
- blueprint 依赖配套的 blueprint-generate 技能完成计划生成,单独使用本技能无法产出最终计划。
这个 Skill 能做什么,适合哪些场景?
Blueprint 是 imbue-ai 开源的编码代理规划助手,本条目只覆盖仓库中的 blueprint 技能(即规划会话技能)。它接收一段功能描述后,先让你从模板中选择计划结构,再深入探索你的代码库,随后以 3-5 个为一轮的方式提出选择题式的澄清问题。你只需简短作答,它会不断更新一份精炼后的提示词,直到你主动调用 blueprint-generate 技能结束问答并生成计划。该技能只负责收集信息,不生成计划文件,也不修改任何代码。
解析用户输入的功能描述;读取 references/templates. 并让你选择模板(含 Other 自定义选项);实际阅读项目源码以理解结构、模块、既有模式与约定;每轮提出 3-5 个基于代码库实际情况的澄清问题,支持 1a, 2b 这类速记或自由文本作答;每轮将你的回答以要点形式并入精炼后的提示词并展示;在模板选定后于每条消息末尾显示 Explore/Plan/Write/Refine 四阶段进度条。它不会自己结束问答、不会生成计划、不会改动代码文件。
- 在现有代码库上开发较大的新功能、需要先明确设计再动手的工程师
- 启动全新项目、希望把脑中想法变成可执行规格的开发者
- 做增量改动但改动大到值得先写计划再交给代理执行的团队
- 进行研究性实验(如新模型、新系统或新子系统)的研究者
这个 Skill 有哪些优点和局限?
- 把规划的 tedious 部分交给代理,但所有决策权留在用户手中
- 问题基于真实代码库探索,不会问代码里已有答案的问题
- 问答规模可自由控制——一轮后即可生成计划,也可多轮深入
- 计划结构与深度由模板决定,且支持用户自定义模板
- 本身不生成计划,必须配合 blueprint-generate 技能才能得到计划文件
- 问答深度依赖模板选择——模板选错可能导致问题视角不匹配
- 源材料未提供自动化测试或跨平台兼容性验证的证据
- 不太适合以视觉决策为主的前端工作或小型重构
如何安装这个 Skill?
安装整个技能集合:npx skills add imbue-ai/blueprint。Claude Code 用户也可用 curl -fsSL https://raw.githubusercontent.com/imbue-ai/blueprint/main/install-skills.sh | bash,技能会被复制到 ~/.claude/skills/(若设置了 $CLAUDE_CONFIG_DIR 则为其下的 skills 目录)。
如何使用这个 Skill?
在兼容的代理中输入 /blueprint <功能描述>(例如 /blueprint Add a caching layer to reduce API calls)。选择模板后,技能会探索代码库并开始提问;用速记(如 1a, 2b, 3e)或自由文本回答。回答完成后,调用配套的 blueprint-generate 技能结束问答并生成计划——本技能自身不负责生成计划。