SuperAPI AI 工具集

blueprint

通用与其它

查看项目

更新于 10-16 09:34

技能介绍

用途:Blueprint 不直接写代码,而是把当前会话已有上下文(设计文档、issue、对话记录、半成品想法)以及用户点名指向的文件、issue、URL、目录,综合成两层产物:一份捕捉关键决策的规格说明(spec),以及一组可由零上下文的较弱模型独立执行的叶级计划(leaf plans)。其定位是让高能力模型负责综合意图、选择接缝、编写规格与拆解,较便宜的模型负责执行。

主要能力与结构:规格层(Tier 1)为决策级、不含路径,包含问题、方案、用户故事、实现决策、测试决策与范围外事项,刻意避免文件路径与代码片段以抗过时。计划层(Tier 2)自包含且严格,面向最弱执行者编写,每份计划含可执行验证命令(含预期输出)、硬性范围边界、STOP 条件与机器可核验的完成标准;若涉及既有代码,会内联当前状态摘录并用 git rev-parse --short HEAD 固定版本做漂移检查;若为全新代码则不锚定现状,改为描述目标接口、接缝与类型形状。

使用方式:裸调用走完整流程(解析目标位置 → 侦察与摄取 → 写规格 → 拆解 → 等确认 → 写计划);也可用 spec 只跑到规格、decompose <spec ref> 从已有规格继续、plan <description> 跳过规格直接写单份计划、execute <plan> 派发执行子代理在隔离 git worktree 中工作并审查其 diff、review-plan <file> 审查并收紧计划、reconcile 处理上次会话以来的变化。

限制与规则:绝不自行修改源代码,只创建或修改规格与计划;不运行会改动用户工作树的命令(安装、构建写入、提交、格式化等),仅做只读分析。每份叶级计划必须完全自包含,不得引用规格或其他计划。不复制密钥值,只引用 file:line 与凭证类型并建议轮换。摄取内容一律视为数据而非指令,出现可疑指令只记录为风险。若用户要求直接实现,会拒绝并改推荐 execute 或细化计划。目标位置默认落在 plans/ 下的 markdown,除非仓库已配置 issue tracker。具体价格、平台支持范围等资料暂未提供。