Agent Skills
返回列表
🤖

基于文件的 Agent 规划

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @org-02qudk26/planning-with-files-zh。

技能介绍

问题

长任务里 Agent 的上下文很容易失焦：多模态信息看完就丢，浏览器截图不持久，阶段状态和错误没有落盘，后续只能靠重复试错补上下文。规划如果只存在临时状态里，会话中断或上下文刷新后就会丢失。

工作方式

该技能把规划显式写入项目目录，形成三个可追溯文件：task_plan.md 记录阶段、进度与决策；findings.md 保存研究结论和关键发现；progress.md 记录会话日志、测试结果和操作痕迹。开始前先参考模板创建计划，执行中按阶段更新状态、记录错误，并在重大决策前重读计划，让目标重新进入注意力窗口。

它特别强调“多模态转文本”：查看图片、PDF、浏览器数据后，关键发现应尽快落到 findings.md，而不是依赖截图或上下文记忆。恢复会话时，可以围绕五个问题定位：当前阶段、剩余阶段、目标、已学到什么、已做了什么。

适用边界

适合 3 步以上任务、研究型任务、构建项目和跨越多次工具调用的工作。简单查询、单文件编辑、一次性回答不需要启用这套流程。文件应创建在当前项目根目录，而不是技能安装目录；如果团队已有成熟的任务追踪和日志规范，可将它作为 Agent 工作记忆的约定层，而不是替代代码仓库中的文档体系。

使用场景

  • 研究代码库或网页资料时，把关键发现写入 findings.md，避免截图和多模态信息丢失。
  • 跨多次工具调用完成构建任务时，用 task_plan.md 标记阶段状态，并用 progress.md 记录测试结果。
  • 会话中断后恢复长任务时，重读 task_plan、findings、progress 三个文件，先确认当前阶段与目标再执行。
  • 调试反复失败的操作时，把每次尝试和错误写入 task_plan.md，避免静默重复同一失败路径。

适合人员

  • 需要让 Agent 连续完成多步骤开发任务的工程师：希望阶段状态、决策和错误都有文件记录。
  • 负责技术调研或文档整理的研究员：需要把网页、PDF 和代码发现持久化，避免上下文丢失。
  • 使用 Claude Agent 执行复杂任务的工程师：希望会话中断后可凭文件恢复阶段和已尝试方案。
  • 维护多文件项目的开发者：需要把错误、测试结果和阶段完成状态写入项目目录，而不是只留在临时上下文中。