SuperAPI AI 工具集

overseer-plan

办公与效率

查看项目

更新于 10-16 05:06

技能介绍

用途:使用 /overseer-plan 将任意 Markdown 规划文档转换为 Overseer 可跟踪任务。适合在 plan 模式完成计划后、把规格/设计文档转为实现任务,或从路线图、里程碑文档创建任务。

用法: /overseer-plan <markdown-file-path> /overseer-plan <file> --priority 1 /overseer-plan <file> --parent <task-id>

主要能力:读取 Markdown 文件;从首个 # 标题提取标题(去掉 "Plan: " 前缀);创建 Overseer 里程碑(若提供 --parent 则创建子任务);分析结构拆分子任务;按需创建子任务(深度 1)或子子任务(深度 2);返回任务 ID 与拆分摘要。层级为深度 0 里程碑、深度 1 任务、深度 2 子任务。

拆分判断:当有 3-7 个清晰可分离工作项、跨多文件/组件实现、存在明确顺序依赖时创建子任务;仅 1-2 步、工作项紧耦合或计划为探索性时保持单一里程碑。任务需原子、可验证(有测试或明确验收标准)、清晰且用祈使动词;里程碑需可演示并基于前一里程碑。

流程:分析文档并提议拆分,调用 Oracle 审查拆分并改进,纳入反馈后在 Overseer 中创建(经 MCP 持久化到 SQLite)。创建后可用 tasks.get、tasks.list、tasks.start、tasks.complete 等操作。start 与 complete 需要 jj 或 git,否则报 NotARepository;CRUD 无需 VCS。优先级须为 1-5,阻塞关系不能是祖先或后代。文档不完整、内容不可执行或无实质规划内容时不宜使用。