开源项目已核验

文件式任务规划

把任务计划、发现和进度写进磁盘文件,让代理在上下文丢失、清空对话或崩溃之后还能接着干,而不是从头再来。

查看 GitHub
2.5万收藏OthmanAdi作者3.7.0版本MIT许可证

Skill 概览

长任务最容易在中途出问题:上下文满了、对话被清空、程序崩溃,之前想清楚的思路和已经做完的部分就都没了,只能重来。这个技能的做法是把状态落到磁盘上——任务计划、过程中的发现、当前进度各自成文件,随时可读可改。这样即使会话中断,新会话读一遍这几个文件就能接上,不需要你重新交代。v3 还加入了可选的自主模式和门控模式,其中有一道完成检查会拦住代理,直到计划里的事项真正做完,避免它中途宣布完成。它按通用技能标准编写,可以装进六十多种代理环境。

核心功能

  • 计划、发现与进度分别落到磁盘文件,可读可改
  • 上下文丢失或崩溃后可以接着干,不必重来
  • 可选的完成门控,防止任务没做完就收尾
  • 支持六十多种代理环境
  • 文件是纯文本,可纳入版本控制

适用场景

  • 任务要跨多个会话完成,不希望每次重新交代
  • 代理跑长任务时经常中途走偏或提前收尾
  • 想看清代理当前进行到哪一步
  • 多人接手同一件事,需要共享的进度记录

安装方式

bash
npx skills add OthmanAdi/planning-with-files -g

使用说明

安装后交给代理一个较大的任务,它会先把计划写进文件,过程中随时更新发现与进度。会话中断后,新会话读这几个文件即可继续。你也可以直接打开文件查看或修改计划,因为它们就是普通的文本文件。需要更严格的收尾控制时,启用完成门控模式。

示例工作流

  1. 安装技能
  2. 交代任务,让它先写出计划文件
  3. 让它执行并持续更新进度与发现
  4. 中断后新会话读取文件继续
  5. 需要时启用完成门控,确认计划真正做完

更新记录

3.7.0

对应仓库当前发布的版本。v3.0.0 引入了可选的自主模式、门控模式与完成检查。完整变更请查看 GitHub Releases。

常见问题

会在我的项目里留下额外文件吗?

会。它的机制就是把计划、发现和进度写成文件保存在磁盘上,这正是它能在中断后接着干的原因。这些是普通文本文件,可以纳入版本控制,也可以在任务结束后删掉。

启用自主模式安全吗?

自主模式和门控模式都是可选的,默认不启用,现有配置不受影响。自主模式适合你信任任务边界、愿意让它连续跑完的场景;涉及不可逆操作时,建议保留人工确认环节。