SuperAPI AI 工具集

contract-builder

编程与开发

查看项目

更新于 10-16 00:03

技能介绍

用途:Contract Builder 仅面向已存在的遗留(legacy)变更,把规划产物转换为单一执行契约 execution-contract.md,作为进入实现前的审批握手。新的直接或计划变更不调用本技能,而是使用 proposal.md + tasks.md 与 SSF workflow start --path planned,不应为其生成契约或请求二次审批。

主要能力:生成前需读取 .spec-superflow.yaml(尤其 dp_0_decisions)、proposal.md、specs/、design.md、tasks.md,并用 SSF runtime asset read docs/artifact-contract.md 加载文档契约;基线模板通过 SSF runtime asset read templates/execution-contract.md 加载。契约需体现已批准行为、范围外内容、约束、批次、测试义务、评审门与回退到规划的条件,引用需求 ID 与任务 ID 而非复制全文。

用法:执行 CLI 前须把行首 SSF 替换为 node "<plugin-root>/scripts/spec-superflow.mjs",不得直接运行 SSF 或调用 PATH 中的 ssf。写入契约前进入 bridging;产物语言取自 dp_0_decisions 的 artifact_language,缺失或仍为 auto 时须回到 workflow-start,不得猜测或默认英文。审批后执行 SSF state set <change-dir> dp_3_result "approved: <summary>"、SSF state set <change-dir> dp_3_timestamp now、SSF state rebuild <change-dir>,再 SSF state transition <change-dir> approved-for-build。DP-3 为硬门禁。

适用场景与限制:适用于遗留变更及遗留 Hotfix(后者仅生成 Intent Lock、任务列表、DP-3 审批门)。范围、需求、约束或批次变化时需刷新契约。不得替用户审批、不得因规划文档看似完整而跳过契约、不得静默丢弃未映射需求。解析失败、文件缺失、用户中断、校验失败均有对应处理路径。