关于 blueprint
Blueprint 是为多阶段、多 Agent 工程项目生成执行计划的技能，可将简短目标拆解为新接手的编码 Agent 也能独立执行的步骤。它包含计划审查、依赖与并行识别，以及带审计记录的计划变更流程。
主要功能
- 01扫描代码库并执行预检
- 02拆解为单个 PR 规模的步骤
- 03识别依赖关系与并行任务
- 04依据验收标准审查计划
- 05记录计划与任务台账
- 06支持带审计轨迹的计划变更
适用场景
- 01规划需要多个 PR 的工程改动
- 02为多次会话或多个 Agent 准备共享计划
- 03在执行前进行对抗性计划审查
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/blueprint确认已加载。
详细介绍
Blueprint — 构建计划生成器
将一句话目标转化为分步计划，让任何编码 Agent 无需了解上下文即可执行。
概述
Blueprint 适用于多会话、多 Agent 的工程项目，其中每个步骤都必须能由一个全新的 Agent 独立执行，且该 Agent 从未看过对话历史。安装一次后，通过 /blueprint <project> <objective> 调用。
何时使用此技能
- 任务需要多个 PR 或多个会话时使用
- 多个 Agent 或团队成员需要共同执行时使用
- 希望在执行前对计划进行对抗性审查时使用
- 需要识别并行步骤和依赖关系图时使用
工作原理
- 调研 — 扫描代码库、读取项目记忆并运行前置检查
- 设计 — 将目标拆分为适合单个 PR 的步骤，识别可并行执行的部分，并记录用户选择的模型约束
- 起草 — 根据结构化模板生成计划，其中内含分支工作流规则、CI 策略和回滚策略
- 审查 — 根据验收标准审查计划；仅当用户或适用指令明确授权使用子 Agent 时才委派，并遵循其模型约束
- 登记 — 将计划／任务台账保存到获准的项目位置；更新全局记忆需要明确请求
示例
示例 1：数据库迁移
/blueprint myapp "migrate database to PostgreSQL"
示例 2：插件拆分
/blueprint antbot "extract providers into plugins"
最佳实践
- ✅ 用于需要 3 个或更多 PR 或多个会话的任务
- ✅ 让 Blueprint 自动检测 git／gh 是否可用——它会灵活降级
- ❌ 不要用于可在单个 PR 中完成的任务
- ❌ 用户说“直接做”时不要调用
主要差异
- 冷启动执行：每个步骤都包含独立完整的上下文说明
- 对抗性审查关卡：执行前进行基于证据的审查，并可选择经授权的委派
- 以 Markdown 为主的分发方式：经过审查的版本主要包含说明和模板，但安装或遵循这些内容仍可能导致 Agent 运行命令。在检查之前，应将此代码库视为不可信。
- 计划变更协议：可以拆分、插入或跳过步骤，并保留审计记录
安装
不要将不断变动的分支直接克隆到正在使用的技能目录中。使用现有的任务／网络授权，在单独的审查目录中检查指定的不可变版本。宿主环境的启用或安装仍需获得适用的明确指示；如果已经获得授权，则无需再次询问：
review_dir="$(mktemp -d)"
git clone --filter=blob:none https://github.com/antbotlab/blueprint.git "$review_dir/blueprint"
git -C "$review_dir/blueprint" checkout --detach 07c5b305cf2d95d584a0d0398c390e839fec5954
git -C "$review_dir/blueprint" ls-files
git -C "$review_dir/blueprint" status --short
阅读该确切提交中的 SKILL.md 和所有附带文件。检查脚本、
钩子、符号链接、网络调用、凭据访问，以及要求执行命令或提升权限的指令。仅在用户明确批准安装到宿主环境的范围内，将经过审查的文件复制到所选宿主的技能目录中。若要使用更新的版本，请重新审查，不要静默更新此固定版本。
其他资源
局限性
- 仅在任务明确符合上述范围时使用此技能。
- 不要将输出视为针对特定环境的验证、测试或专家审查的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。
- 固定版本可确保可复现，但不代表它天然可信；仍需审查其内容。
评论
支持 Markdown