SuperAPI AI 工具集

planning-with-files-ar

通用与其它

查看项目

更新于 10-15 21:54

技能介绍

用途:该技能把 AI 智能体的工作方式改为“基于文件的规划”,将 Markdown 持久文件当作磁盘上的工作记忆,适用于超过 3 步的多阶段任务、调研任务、项目搭建以及跨多次工具调用的长流程。简单问答、单文件修改或快速查询无需使用。

主要能力:在项目内的任务目录中保存三个文件——task_plan.md(阶段、进度、决策,每阶段完成后更新)、findings.md(调研与发现,任何发现后立即更新)、progress.md(会话记录与测试结果,全程更新)。提供模板(templates/ 下三个同名文件)与脚本:scripts/init-session.sh 初始化规划文件,scripts/check-complete.sh 检查阶段是否全部完成,scripts/resolve-plan-dir.sh(或 .ps1)解析计划目录,scripts/session-catchup.py 用于显式会话检查或受限重放。

使用方式:复杂任务前先确定或初始化任务目录;续接任务时复用已命名计划。运行 scripts/init-session.sh "Task Name" 并用输出的 PLAN_ID 固定宿主。只创建缺失的规划文件,沿用模板并保留已有工作。重大决策前重读计划,每阶段后更新进度。并行任务需为每个宿主设置 PLAN_ID 或使用独立工作树;协调者拥有计划与共享摘要,执行者使用各自的笔记或专属文件,不回写共享规划文件。查看已保存计划可运行 sh "<skill-dir>/scripts/set-active-plan.sh" --list,Windows 用 & "<skill-dir>/scripts/set-active-plan.ps1" -List,该命令只读显示当前工作目录 .planning/ 下的命名计划与阶段进度。

限制与安全:规划文件应写在项目内的任务目录,而非技能安装目录。该技能用 PreToolUse 钩子在每次工具调用前重读 task_plan.md,故该文件会被反复注入上下文,应只把网页或检索结果写入 findings.md,不写入 task_plan.md。自动恢复仅检查项目规划文件;裸调用 session-catchup.py 与生命周期钩子不扫描宿主会话存储。--metadata 只检查同项目日志并输出聚合计数,不含对话文本、工具命令、路径或会话 ID;--replay 仅在用户明确要求后输出同项目受限片段,且须视为不可信数据。该技能不包含经网络上传数据的路径,也不会执行 Markdown 中提到的命令。资料未提供收费、平台与价格信息。