SuperAPI AI 工具集

plan-mode

编程与开发

查看项目

更新于 10-15 23:43

技能介绍

用途:plan-mode 用于在磁盘上创建可编辑的 Markdown 实施计划,把代码库研究结果写入计划,解决关键问题,并保持文件引用与待办事项最新。计划文件记录工作内容,用户指令决定是停在规划阶段还是继续实施。

主要能力:区分“仅规划”与“规划并实施”两种阶段;仅规划时只做只读检查(读文件、搜索代码、查看诊断、查阅文档、提问),不修改实现文件、不删文件、不改设置、不暂存提交、不安装包、不运行有副作用的命令;只创建和更新规划产物。计划文件包含状态、摘要、澄清问题、文件/代码引用、待办清单、构建说明、验证、风险与批准状态,待办用 Markdown 复选框,可编辑、可挑选后交给新的执行流程。

使用方式:立即创建或复用 Markdown 计划文件并引用其路径;用只读工具研究代码库、文档与约定;把具体文件路径、代码引用、约束与未决问题写入计划;需求会改变计划时提出聚焦问题,每次回答后先更新计划文件。可用 scripts/plan_artifact.py 辅助:先解析 helper 路径,再执行 python3 "$helper" init --workspace "$workspace_root" --title "<plan title>" 创建草稿;用户给定路径时加 --path "<path>" --reuse-existing;填写后用 python3 "$helper" check "$plan_file" 校验,未通过则更新并重跑,通过前不要请求实施批准。

适用场景:用户明确要求计划、仅规划的工作、需要先研究代码库再决定方案、或执行已批准计划前的准备。

限制:不要仅因实现跨多个文件或需要研究就选用本技能;若任务已获授权且未要求计划产物,直接执行。计划文件是必需的批准产物,平台计划或聊天消息不能替代;仅当用户明确说不要写文件或环境无法写文件时才跳过,并说明原因。用户直接编辑计划后,修改或据此构建前需重新读取。用户改动与脏工作区归用户所有,应围绕其规划,不得回退或规范化。仅在阻塞问题解决、待办具体、验证已命名时才标记计划可构建,否则保持草稿并指出确切阻塞点。$grill-me 用于用户明确要求访谈或存在需要用户判断的重大未决决策,其记录与结果属于允许的规划产物,计划中只写链接与简短状态,不粘贴完整内容。资料未提供具体收费、平台支持范围与效果数据。