SuperAPI AI 工具集

list-plans

通用与其它

查看项目

更新于 10-16 00:31

技能介绍

用途:在工作区中发现有效的迁移计划(migration plans),并返回被选中计划的路径,供后续规划流程使用。

主要能力:

  1. 发现有效计划。有效计划须为 .github/modernize/ 的子目录,且同时包含 plan.md 与 tasks.json(或 .metadata/tasks.json)。
  2. 按数量三种分支处理:无计划时返回 no-plans-found,不提示用户;恰好一个计划时直接返回 .github/modernize/<folder>/plan.md,无需用户交互;多个计划时读取各 plan.md 的首个标题,去掉开头的 # 以及形如 <Word> Plan: 的前缀(如 Modernization Plan:、Migration Plan:),把剩余部分当作标题,生成选择请求。

使用方式:必须在终端执行发现脚本,不得使用 list_dir、file_search、grep_search 等文件工具。运行前把 <workspace-root> 替换为工作区根目录的绝对路径。Windows 使用 PowerShell 脚本,macOS / Linux 使用 bash 脚本,脚本内容见资料;脚本输出 JSON,被解析为后续步骤的有效计划列表。

多计划时的交互格式:不要调用 question 工具,需向 planning-coordinator 返回两行,第一行 NEEDS_INPUT,第二行紧凑 JSON,其中 requestType 为 plan-selection,options 与 resumeContext.plans 按发现顺序为每个计划各含一项,选项 label 为文件夹名,description 为计划标题;不得默认选择第一个计划。planning-coordinator 收到顶层结构化答案后,通过 resumeContext.plans 解析所选 label 并返回 .github/modernize/<selected-folder>/plan.md。

限制:计划判定条件固定,缺少 plan.md 或 tasks.json 的目录不算有效计划;资料未提供平台、收费、价格、效果或其他使用步骤说明。