superplan 是 superRA 工作流中的 PLAN 阶段技能,负责规划阶段的过程形态:发现已有工作、探索、领域设置、任务分解、自审与交接。其输出是供 superimplement 消费的 superRA/ 任务树。使用前需先加载 superRA:using-superra;若运行环境已激活 plan 模式,还需先加载 references/harness-plan-mode.md。开始时需声明正在使用 superplan 创建任务树。
用途与入口评估:在探索或任务设计前,从三个维度评估工作——放置位置(放入已有 superRA/ 树、迁移旧 PLAN.md,或作为首个顶层任务)、深度层级(quick、standard 默认、thorough)、路由路径(默认前向规划,或为已有代码补建记录的追溯文档)。不明确时应给出具体选项而非猜测。
主要能力:按层级执行探索(读取项目结构、代码、数据、文档、git 历史);识别工作领域并加载对应领域技能的规划参考,满足其规划硬门槛;设计产物流水线与任务结构,任务以 depends_on 声明依赖,不使用复选框;多产物工作需提供单一可复现入口点。
使用方式:先创建任务树包装器,首次调用通过已加载任务树技能目录执行 uv run --script <skill-dir>/scripts/cli.py wrapper init,之后使用 ./superRA/superra … 或直接写 task.md。完成后进行自审(占位符扫描、流水线一致性、验证覆盖、依赖图检查等),thorough 层级还需派发 planning-review 代理审查,再向用户展示任务树并提交。
适用场景与限制:适用于启动或变更工作、创建或修订 superRA/、为无任务覆盖的代码补建记录。任务树是权威任务跟踪器,会随工作演进就地更新;材料性变更(增删改任务、改目标、改数据源等)须经用户确认后按协议原子提交。具体命令、字段与模板细节以资料所述参考文件为准,其余未提供。