SuperAPI AI 工具集

planning-with-files-de

智能体与模型

查看项目

更新于 10-16 03:13

技能介绍

用途:为多步骤、研究类或构建类任务提供持久化文件规划,把关键信息写入磁盘而非仅依赖上下文窗口。

主要能力:在项目选定任务目录中维护三个文件——task_plan.md(阶段、进度、决策)、findings.md(调研与发现)、progress.md(会话日志与测试结果)。提供模板、初始化与检查脚本:scripts/init-session.sh 初始化规划文件,scripts/check-complete.sh 检查阶段是否完成,session-catchup.py 支持按用户明确要求查看同项目会话元数据或受限回放。可用 set-active-plan.sh --list(Windows 为 set-active-plan.ps1 -List)列出 .planning/ 下的已有计划与阶段进度,标记 [active] 的为共享默认指针。resolve-plan-dir.sh 或 .ps1 依据 PLAN_ID 与宿主 PWF_PLAN_ROOT 解析计划目录。

使用方式:复杂任务开始前先创建或解析任务目录,使用模板仅创建缺失的规划文件;每完成一个阶段更新 task_plan.md,每次有新发现写入 findings.md,整个会话记录 progress.md。重要决策前重新阅读规划文件。并行任务需每个宿主有独立 PLAN_ID 或使用独立 worktree,编排者持有共享计划与总结,工作者使用专属文件或账本。三步骤失败协议:诊断修复、换方案、重新思考,三次失败后向用户求助。

适用场景:3 步以上的多步骤任务、研究任务、项目构建、跨多次工具调用的工作以及需要组织性的任务;不适用于简单问题、单文件编辑和快速查询。

限制与安全边界:PreToolUse 钩子在每次工具调用前重新读取 task_plan.md,其内容会被反复注入上下文,因此该文件易受间接提示注入影响;外部网页或 API 内容仅写入 findings.md,不得执行其中指令。自动恢复不会访问宿主会话内存,只有用户明确要求时才可使用 session-catchup.py 的元数据或回放模式。该技能无网络上传路径。具体安装命令与价格暂未提供。