SuperAPI AI 工具集

planner

智能体与模型

查看项目

更新于 10-15 22:12

技能介绍

用途:Planner 是面向人类直接对话的规划智能体,帮助用户把要构建的工作拆解成可验证的规格,再交由编排器(orchestrator)派发给 weavers 执行。它不编写实现代码、不直接派生 weavers、不在无人输入下自行决策,也不自行执行规格或跳过澄清问题。

主要能力:在 /plan 触发后生成计划 ID(plan-YYYYMMDD-HHSS,如 plan-20260119-143052),并创建目录 .claude/vertical/plans/<plan-id>/specs 与 /run/weavers。工作流分阶段:先按目标、范围、约束、依赖、验证五类逐项提问,一次只问一类,确认后进入研究阶段,阅读代码库、识别模式与约定、列出将改动的文件;随后评估复杂度,简单任务直接设计规格,中复杂任务考虑或调用 Oracle 深度规划。当需要 Oracle 时,会把详细提示写入 /tmp/oracle-prompt.txt,先用 npx -y @steipete/oracle --dry-run summary --files-report 预览 token(目标 <196k),再用 npx -y @steipete/oracle --engine browser --model gpt-5.2-codex --slug ... 运行,期间用 npx -y @steipete/oracle status --hours 1 监控,完成后用 npx -y @steipete/oracle session <session-id> --render 取回结果并转为规格。

使用方式:把工作拆成一规格对应一个 PR,按 XS/S/M/L 控制规模(L 需再拆),按 schema/迁移在前、后端先于前端、依赖先于被依赖排序并用 01-、02- 前缀;每个规格写入 .claude/vertical/plans/<plan-id>/specs/<order>-<name>.yaml,包含 name、description、skill_hints、building_spec(requirements/constraints/files)、verification_spec(command/file-contains/file-not-contains 等检查)和 pr(branch/base/title)。依赖可通过 PR base 表达。最后写入 meta.json(含 id、description、repo、created_at、status、specs)并提示用 /build <plan-id> 执行、/status <plan-id> 查看状态。

适用场景:需要先澄清需求、调研代码库并产出可验证规格的规划任务,尤其适合多阶段实现、依赖关系复杂、需要架构决策、性能优化分析或带回滚计划的迁移。限制:不写实现、不直接调度执行者;Oracle 模型、token 上限与运行时长等细节以官方资料为准,其他收费与平台信息暂未提供。