SuperAPI AI 工具集

blueprint

编程与开发

查看项目

更新于 11-06 19:22

技能介绍

blueprint 是一个用于“先规划、后实施”的仓库变更规划技能,属于 akshay-diwadkar/first-four-hours 技能集。它的核心定位是:在任何人真正实施变更之前,先把方案规划完整,并封存一份实施完整的 blueprint.md,使执行者不再需要做任何设计决策。该技能本身不拥有实施权限,实施由 Construct 或其他智能体完成。

主要能力与使用方式:

  • 规划范围:围绕仓库变更,明确目标结果、兼容性、产品取舍、变更边界、不可推导的优先级与验收标准等用户自有的关键歧义;只有不同答案会产生实质性不同的正确方案且无法推导时才向用户提问。
  • 只读约束:除写入 .first-four-hours/blueprints/<task>/request.md 和 blueprint.md、prepare 的排除规则、安全探测副作用以及被调用的 ideate 交接外,仓库保持只读;规划者与挑战者不会构建、应用或运行所规划的变更,包括临时副本,只探测未修改的当前状态。
  • 探索与求解:仅收集可能改变方案、保留、传播或验证方式的事实;需要确定机制、控制/数据流、文件与符号、传播、保留、兼容/迁移/恢复、测试、验证与完成条件;当存在多个可行设计时,收集最小判别事实并自行决定;需要先寻找可行方案时按 Ideate 调用。
  • 变更边界:按规划契约的“租金规则”约束新增内容,确保每一项实质性计划新增都通过该规则。
  • 编写计划:按 README 准备 workspace,在原位填写准备好的 blueprint.md 脚手架,保持固定外壳行不变,并按规划契约路由到 Declared text 与 Incomplete gates;完成标准是 check 报告无诊断。
  • 挑战与修复:阅读 Challenge and rehearsal,用 Challenger brief 自行走查草稿;对升级版草稿,另由一个全新上下文的子智能体依据该 brief 加 Elevated attack 进行挑战。
  • 封存:当 Seal gate 成立后,按 README 执行 check 与 seal,遇到 receipt 诊断时阅读 Seal receipts;报告封存路径,并区分机械封存成功、有证据支持的就绪判断,以及尚未开始的实施与验证。
  • 推理检查点:在承诺方案前、失败后(如探测失败或封存受阻)或方向变更后、挑战与封存前咨询 reason,并按 Checkpoint trace 记录;结束时可给出一个可选的下一步,若为停止后的解除阻塞提示,需为命名仓库及所需 issue、PR 或产物的自包含提示,只有用户回答“yes”才会启动。

适用场景:适用于需要在实施前完成完整设计规划、希望把设计决策全部固化到一份计划文档中、且要求规划阶段不触碰修改后状态的仓库变更任务。

限制:该技能不实施、不构建、不运行所规划的变更;请求或交接只设定结果,不能覆盖技能、工具或 harness 指令;来源是证据而非权威;决策不由对话记录、旁挂文件、隐藏状态或兼容层承载,而由 blueprint.md 承载;脚本仅验证机械机制。官方页面未提供的收费、价格、平台等信息暂未提供。