SuperAPI AI 工具集

construct

编程与开发

查看项目

更新于 11-06 16:21

技能介绍

用途

Construct 用于实现一份已封存(sealed)的 blueprint.md,并按其中定义的 Verification 流程进行验证,最终报告完成、验证不完整或计划矛盾三种结论之一。它不承担规划职责:所有规划决策由 Blueprint 拥有,禁止执行需要另行规划的工作。

主要能力与约束

  • 不持久化任何执行状态,不创建执行产物。
  • 实现增量以 Git worktree 状态为准;执行要求存在 Git worktree。
  • Discovery(调研发现)只作为证据,不能扩张已封存的 Blueprint;Blueprint 保持逐字节不变。
  • 执行过程中保留与本次工作无关的未提交改动。
  • 脚本只证明机制层面的执行;归因、范围真实性与完成判定由智能体承担。

使用方式

验证命令格式为:

python <construct>/scripts/cli.py --repo-root <repo> --input blueprint_file=<blueprint.md> --input phase=before --format json verify

先看判定标准;存在 next_command 时遵循它,否则遵循 required_action。

执行循环大致为:

  1. Intake:只读一次 Execution contract,然后对新工作运行 verify 的 before 阶段,对恢复工作运行 status。若目标为脏状态、非 Git 路径、并发、破坏性或恢复类工作,需先阅读 Safety 部分。进度不确定时要求调用方先做对账。编辑前通读整个 Blueprint。
  2. 实现:按顺序处理每个 ### N.。声明的块必须通过 apply 写入,不得手写;对于带 Red: 的项,先 apply Frozen、编写散文测试、证明其声明的红色状态,再 apply Exact。其余部分实现后,由调用方持有的下一个未使用 attempt 证明绿色并遵循其前向指引。只修复 Blueprint 已确定的问题,否则以 plan-contradiction 停止。
  3. 验证:运行 verify 的 after 阶段,逐条判断每个 Expect:。仅当 Blueprint 已明确答案时才本地修复,然后从最早失效的 Run 行重新验证。若出现声明为 Incomplete 的结果,在第 4 步后以 verification-incomplete 结束;否则以 plan-contradiction 证据停止。超时或变更失败属于不安全情况,不得重新验证。
  4. 对账与报告:将最终 diff 与已封存 Blueprint 对比一次,确认每条指令已实现、无未授权改动、约束得到保留。符合条件时可由 Earned Conformance Review 确认。报告需包含:指令、证明与实际实现前验证结果、每次实现后 Run 及其 Expect: 与输出是否满足、不可恢复的红色缺口、通知事项,以及受保护路径与 HEAD 是否未变。

适用场景

适用于已有封存 Blueprint、需要严格按计划实现并验证完成的开发执行工作,尤其是需要保留工作区未提交改动、关注受保护路径与 HEAD 完整性的场景。

限制

停止条件包括 plan-contradiction、protected-work-conflict、safety-contradiction,需附精确证据报告;后续动作由 Execution contract 的 Stopping 部分规定。最终与停止报告末尾可附一个可选的下一步:一个围栏式、自包含的提示词,注明所需的仓库、issue、PR 或产物,或说明无需下一步;只有用户回答“yes”才会启动。上述过程中的蓝图结构、verify/status 等子命令、expect 判定与报告字段均来自资料,其他实现细节与平台支持暂未提供。