SuperAPI AI 工具集

goal-design

智能体与模型

查看项目

更新于 10-15 17:29

技能介绍

用途:/goal-design 是运行循环中 move 1 的前置发现适配器,把人类目标写成结构化的 intent.md 与 driver.md 包,使 /discovery 和 /plan 可以不依赖聊天上下文直接消费。它不同于 /goals(后者维护 GOALS.md fitness 规格),这里是按单目标生成意图包。

主要能力:按 BDD 方式先写 WHAT 再写 HOW,包含目标、原因、有界上下文、非目标、回滚/遏制、过时假设,以及至少一个 Given/When/Then 场景。使用脚本创建、刷新摘要、检查、标记校验并生成分发提示。

必要用法:创建包使用 scripts/goal-design-packet.py new <slug> --objective "<goal>" --scenario-name "<observable behavior>" --first-failing-proof "<test or command>" --write-scope "<path or glob>"。编辑 intent.md 后先刷新摘要:scripts/goal-design-packet.py refresh-digest .agents/goal-design/<slug>。运行确定性检查:scripts/goal-design-packet.py check .agents/goal-design/<slug>。取得独立校验后记录结论:scripts/goal-design-packet.py mark-validated .agents/goal-design/<slug> --verdict "PASS (<validator>, <date>)"。校验通过后把包路径交给 /discovery 或 /plan,场景 id 与名称需原样保留。对外分发时运行 scripts/goal-design-packet.py prompt .agents/goal-design/<slug>,并将输出原样粘贴到 goal API 命令中。

适用场景:目标重要到需要离开聊天,但还未准备好变成 beads 时;需要将验证过的意图带入后续循环时。

限制:driver v1 schema 为 additionalProperties: false,没有专用 andon 字段,升级路由表写在 driver 正文中,route_back_rules 承载可机检语义;不得修改已落地 schema、模板或检查器。分发提示必须小于 4000 字符,草稿包会被拒绝,除非传 --allow-draft。不新增或编辑 GOALS.md,不直接创建 beads(除非调用 /plan),不新增专用 CLI 命令,不追踪仓库根目录生成的 .agents/goal-design 包。具体校验命令与测试见原文,其余实现细节暂未提供。