SuperAPI AI 工具集

plan

智能体与模型

查看项目

更新于 10-16 07:59

技能介绍

用途:把已获用户批准的 SPEC 展开成一份连“不了解该代码库的优秀工程师”也能正确执行的计划文件;在 overstack 场景中该工程师常是 headless 运行的便宜 CLI,无法继承主会话上下文、不能反问,遇到模糊处会自行猜测。触发条件:SPEC(/propose)已通过审批且即将向代理派发任务,工作多步骤、多文件或并行分配给两个以上代理。不适用于尚无已批准 SPEC、单行修改、设计或需求询问(应先用 /propose)。

主要能力:读取 SPEC 并原样保留 ## Context、## Global constraints、## Plan、## Agent Task Assignment;做范围检查(多个独立子系统则拆成多个 PLAN);在拆任务前先画 ## File structure,列出每个文件的唯一职责;按 tracer bullet 方式拆任务(每任务是一条穿透各层的纵向切片,可独立运行并自验证),setup、config、scaffolding、docs 并入需要它们的任务;对横跨全库的机械式修改(expand → migrate by batch → contract)使用专门序列,必要时加 integrate-and-verify 任务;每个任务按固定模板编写,必须含 Thoả(对应 FR-xxx)、Files(精确路径与行号区间)、Interfaces(Consumes/Produces 精确签名)、Depends、Verify(rc 0 命令)、Step 1–5 的 TDD 步骤(含真实测试代码与预期失败/通过输出)。

用法:W01 读取已批准 SPEC → W02 范围检查 → W03 画文件结构 → W04 拆任务 → W05 逐任务套模板书写 → W06 自检(覆盖 SPEC、占位符、类型与命名一致性)原地修改 → W07 写 llmwiki/wiki/sources/draft/DDMMYY-<名称>-PLAN.md、更新 index.md、追加 log.md → W08 每个 ### Task N 对应一个 orca orchestration task-create,dispatch --inject 原样注入该任务 brief 加 Global constraints,不做摘要。文件须含 frontmatter 与 ## Origin,否则被 R9/R2 拦截。

限制与失败边界:PLAN 文件不需要 .html;禁止占位符(TBD、TODO、无实际代码的测试描述、"类似 Task N" 等),R7/R18 在写入与提交时拦截,若存在无任务承接的 FR-xxx 则失败并原地修复。出现反向闸门(需求无法归入任何任务、SPEC 内部或与 Global constraints 矛盾、选定方案不可行、需凭空捏造函数/类型/文件)时必须停止,不写半成品 PLAN,把所有破损点合并为一次报告并附引发它的 SPEC 原句,回到 /propose 重新审批。具体命令、模板格式与代码示例按原文执行,不在此改写。