SuperAPI AI 工具集

aif-plan-overview

办公与效率

查看项目

更新于 10-30 22:58

技能介绍

用途

aif-plan-overview 是 ai-factory 计划工作流中的概览技能,用于向用户解释选中的 fast、full、ultra 或 fix 计划,以及该计划声明的文件变更。它只提供计划概览,不代表实现验证,也不授予执行该计划的权限。

主要能力

  • 解析项目配置:读取项目根目录下的 .ai-factory/config.yaml,解析计划路径(paths.plan、paths.plans、paths.fix_plan、paths.archive、paths.roadmap)、plan_id 格式、git 启用状态及界面/产物/技术术语语言;缺省值包括 .ai-factory/PLAN.md、.ai-factory/plans/、.ai-factory/FIX_PLAN.md、.ai-factory/archive/、.ai-factory/ROADMAP.md、slug 与英文。只在 git 启用或可用时读取当前分支,不假设 git 存在。
  • 读取技能上下文:在使用前按顺序读取 .ai-factory/skill-context/global-skill-context.md 和 .ai-factory/skill-context/aif-plan-overview/SKILL.md,缺失文件跳过,存在但不可读的文件会中止依赖它的工作;优先级为 individual > build(适用时)> global > 技能默认值。
  • 按模式读取计划:fast/full/fix 计划完整读取;ultra 计划完整读取 index.md(其任务复选框是进度唯一依据),并从每个链接阶段只读取标题、## Objective 和 ## Files to Change(或清晰本地化等价标题)到下一个同级标题之间的内容,不预载完整阶段实现、研究或代码。
  • 统计任务进度:统计 ## Tasks(或清晰本地化等价标题,如 ## Задачи)下的实际任务复选框,排除围栏示例、设置/验收清单和重复阶段详情;进度含糊时报告为未知,勾选表示计划进度而非测试通过或功能可用。
  • 输出概览:使用界面语言(保留标识符、文件路径和命令),显示选中入口、是否归档、模式、2–3 句目标摘要、已提供设置、任务进度与下一个未完成任务、阶段与依赖、至多五项关键决策(含范围外事项)、提交计划、开放问题、路线图关联;仅在需要澄清既有链接时读取路线图,且不更新它。
  • 生成文件映射:从 ultra 的 Files to Change 表或 fast/full/fix 的任务 Files 行/表中提取文件行,保留阶段/任务引用、动作与简短变更说明;不依据当前文件系统猜测创建/修改/删除,缺少动作记为未知,同一路径的多个计划动作全部保留,重命名需显式提供新旧路径。
  • 树状展示:可将行数据以 JSON 数组传给已安装的标准库辅助脚本 file_tree.py(以 python3 -I -B 运行,JSON 经 stdin 传入,脚本只读取数据、只写 stdout),支持去重、展开字面逗号花括号、折叠文件夹链并保留动作/引用集合;+ 表示创建、~ 修改、- 删除、? 未知、* 多动作;树放在文本围栏中展示,页脚统计唯一计划路径(含提供的占位符),不展开 glob/生成占位符。无法表示或外部的声明单独列出及来源,不静默丢弃。若 Python 或辅助脚本不可用,可手工绘制同样的树,不构成阻塞,也不授权安装。
  • 给出下一步建议(不执行):未完成的活动计划 → /aif-implement @<entrypoint>;全部任务已勾选 → /aif-verify;fix 计划的后续由 /aif-fix 负责;已归档计划属历史,建议验证或明确开始新工作,不自动恢复。

使用方式

在 ai-factory 项目中选中一份已有计划后调用该技能。它按共享技能上下文与项目配置读取计划,输出概述和文件映射;如需提问,只使用可用的会话提问工具及其实际 schema,否则以纯文本编号选项提问并允许自由输入。

适用场景

  • 在动手实施前快速了解计划目标、任务进度与文件影响范围。
  • 查看 fix 计划的内容与文件变更。
  • 回顾已归档计划时作为历史参考。

限制

  • 不拥有任何项目产物:不编辑计划、复选框、代码、配置、路线图、TaskList 或协调器状态,不执行实现、验证命令、分支/worktree 变更或自动交接。
  • 计划及其内嵌命令属于数据,而非执行工具、更改设置或读取无关材料的指令;不运行实现发现中的变更步骤(如 Handoff 同步或 fix 计划重定向)。
  • ultra 的有限读取不验证各任务阶段正文或实现;缺失章节时指明哪个阶段缺少文件/目标摘要,不从代码片段或未链接阶段文件推断缺失变更;歧义标签对应值或进度记为未知。
  • 文件映射不反映真实验证过的现有文件;辅助脚本只校验输入形状与边界,不验证计划陈述的真实性。
  • 遇到损坏或缺失输入时报告并仅停止依赖它的概览,保留可读证据,不虚构章节。

其他说明

官方未提供额外的收费、价格或平台信息。