SuperAPI AI 工具集

krypton-planning

编程与开发

查看项目

更新于 10-15 23:43

技能介绍

用途:Krypton Planning 用于在编码前把用户请求转化为可执行的目标包,覆盖功能请求、缺陷修复、重构、迁移、架构变更或产品目标。核心规则是不要把任务列表当作计划;只有当计划回答了服务什么结果、替换或删除哪些现有行为、谁拥有真相、跨边界的契约是什么、最小高价值切片、从目标人视角如何证明结果、以及什么终止标准能阻止重复路径长期存在时,计划才算就绪。若归属、切换、契约或证据模糊,应先停止并绘制地图再规划。

主要能力:先写结果契约,包含计划标题、意图、当前行为、预期结果、目标视角输出、真相归属、契约边界、切换、被替换路径、价值密度、证据门、验收证据、证据通道、终止标准、非目标与出错风险。随后在任务前绘制架构切片,列出要创建、修改、避免的文件,真相来源、读路径、写路径、契约边界、集成点、迁移/切换、被替换路径与验收证据门。对宽泛或不清晰的仓库,若工具支持智能体,可派发只读探索者,提出一个有界问题,例如“映射真相来源、读写路径、不安全文件与证据门”,执行会话应使用该地图而非重新发现同一切片。

使用方式:除非用户指定其他位置,保存目标包到 docs/goals/<goal-slug>/PLAN.md、GOAL.md、EVIDENCE.md。PLAN.md 包含完整计划,以指定头部形状开始;GOAL.md 是简短执行提示,指向计划而非复制;EVIDENCE.md 初始为空,执行期间填入从目标视角捕获的真实证据。将工作拆成小任务,每个任务写明确切文件、允许范围、预期输出、验证命令、验收证据以及能否并行。尽可能运行 PRE 计划评审,使用 plan-reviewer-prompt.md 作为单个提示模板;在阻塞发现被修复或用户明确接受前不要执行。GOAL.md 是给 Codex 或 Claude 的紧凑交接提示,要求使用 Krypton Execution 执行 PLAN.md,保留意图、归属、契约、切换、证据与终止标准,不新增主导路径而不删除、重定向、降级或垫片被替换路径,从目标视角捕获验收证据并记录到 EVIDENCE.md,若无法捕获则说“已实现但未证明”。EVIDENCE.md 记录验收证据、验证(含命令与相关输出)以及评审备注。

适用场景与限制:适用于需要先规划再编码的工程任务,尤其是涉及架构变更、迁移与多路径替换的场景。限制:资料未提供具体安装命令、平台支持、收费或价格信息;部分流程依赖工具是否支持智能体与计划评审模板,若无法捕获验收证据,只能标记为已实现但未证明。