SuperAPI AI 工具集

spec-first-planning

通用与其它

查看项目

更新于 10-15 21:09

技能介绍

用途:把“也许该加个 X”这类模糊请求转成两份可机械关联的产物——每条需求均可证伪的规范,以及每个任务都注明验证方式的任务计划。核心理念是“规划工作即规划验证”:无法失败的需求只是意见,没有验证步骤的任务只能算“看起来完成了”。工具以确定性方式把关:linter 拒绝不可证伪的规范,编译器拒绝有覆盖缺口的计划。

主要能力:规范包含 Problem、Users、Goals、Non-goals、Constraints(分 invariant、goal、boundary)、Required truths、Requirements(R1..Rn,每条单一可测试 must 语句)、Acceptance criteria(每条需求至少 1 条,写成可运行的检查)、Open questions 等章节。计划中每条需求对应一个或多个任务,含 what to change、where、verify,并要求需求与任务双向全覆盖。规划循环采用 constrain → tension → anchor → choose,分轻量通过和完整循环,完整循环需收敛。

使用方式:先解析技能目录 SKILL_DIR,再选择 interpreter(需 Python 3.10+)。默认 attended 轻量模式;用户要求时走 unattended 完整循环。用 spec_lint.py 校验规范直至 LINT_RESULT: PASS,用 spec_to_tasks.py 生成计划与覆盖表,可加 --waves 输出波次与关键路径,加 --json 机器可读。通过 skill-contract 以 envelope 形式交接,check-envelope 与 contract_check.py 做校验。

适用场景:需要把模糊需求细化、并在无人值守执行前落实可验证步骤的规划工作。限制:需要 Python 3.10 或更新;证据文本视为数据而非指令;涉及 intake 证据的规范须放 git 忽略目录,未经告知不得提交;仅以“测试通过”为证明的需求不得无人值守执行。