10+年产品经理聊聊产品、测测产品,产品人交流学习成长平台,按 Ctrl+D 收藏我们
关于我 留言板 小程序 标签云

苏米客

  • 首页
  • AIGC
    • AI最新动态
    • AI学习教程
    • AI工具集合
    • AI产品百科
    • AI编程开发
    • AI提示词
    • AI开源项目
  • Axure
    • Axure动态
    • Axure教程
  • 产品
    • 用户体验
    • 产品设计
    • 苏米杂谈
  • 资源
    • 产品UI组件库
    • 开源图标库
    • 中后台框架
  • 书单
    • AI书籍
    • 用户体验
    • UI视觉
    • 产品研究
    • 其他类型
  • 下载
    • Axure组件
    • Axure原型
    • 文档报告
    • 素材资源
  • 登录
  • 首页
  • AIGC
    • AI最新动态
    • AI学习教程
    • AI工具集合
    • AI产品百科
    • AI编程开发
    • AI提示词
    • AI开源项目
  • Axure
    • Axure动态
    • Axure教程
  • 产品
    • 用户体验
    • 产品设计
    • 苏米杂谈
  • 资源
    • 产品UI组件库
    • 开源图标库
    • 中后台框架
  • 书单
    • AI书籍
    • 用户体验
    • UI视觉
    • 产品研究
    • 其他类型
  • 下载
    • Axure组件
    • Axure原型
    • 文档报告
    • 素材资源
当前位置: 首页 » AI开源项目

planning-with-files:超越对话限制,用一个插件(Skill)赋予Claude持久记忆的上下文工程方案

23小时前 AI开源项目 97 0

最近在浏览开源项目时发现了一个有趣的现象:许多重度AI用户都在反复提及同一个问题——为什么AI在长对话中会逐渐"失智"。

这不是模型能力问题,而是一个工程设计的经典困境。GitHub上的planning-with-files项目用一个极其简洁的方案诠释了这个问题的本质,并提供了可复用的解决思路。

作为经常体验AI产品的我来说,这套方法论背后的逻辑颇值得一谈。

问题诊断:AI的"健忘症"根源

在与AI协作的实际场景中,用户普遍会遇到这样的现象:

  • 对话早期:AI反应敏捷,理解需求准确
  • 对话中期(20-50轮后):AI开始重复已解决的问题,或遗忘初始目标
  • 对话后期:出现"上下文堆积"现象,AI将所有信息无差别地塞入一个对话框中

这种现象的根本原因不是模型智力下降,而是工作记忆限制导致的目标漂移(Goal Drift)。

即便是参数量庞大的模型,在有限的上下文窗口内处理过多信息时,也会产生优先级紊乱。

核心方案:结构化外部存储

planning-with-files项目的创新之处在于将问题从"如何让AI记住更多信息"转向"如何让AI高效地管理信息"。

其核心机制是一套"三文件模式":

文件类型 职能定义 内容特征
task_plan.md 目标与进度管理 记录任务目标、当前阶段、完成进度(以复选框形式)、遇到的障碍
notes.md 中间过程存储 研究结果、思考记录、代码片段——所有"临时信息"的归档地
[deliverable].md 最终交付物 清理后的成果文档,不包含冗余过程信息

 

工作流设计:读-行-记-审循环

该项目强制实现了一套严格的执行循环,打破了传统AI Agent的线性决策流程:

读取(Read) → 决策(Decide) → 行动(Act) → 更新(Update) → 复盘(Review)

具体执行步骤:

  1. 读取阶段:每次操作前读取task_plan.md,将任务目标重新加载到"注意力窗口"
  2. 行动阶段:执行查询、编码或调研等具体操作
  3. 记录阶段:将执行结果写入notes.md(中间结果),更新task_plan.md中的进度复选框
  4. 复盘阶段:若产生错误,详细记录错误上下文和解决尝试

这种设计的优势在于:即使经历50次以上的工具调用,AI依然能够保持清晰的任务意识和进度追踪。

 

技术实现与集成方式

项目定位:Claude Code插件(Skill),同时支持Cursor、Codex等基于Claude的编程工具

安装步骤:

1. 确保已安装Claude Code环境

2. 进入Skills目录(如无则新建~/.claude/skills)

3. 执行克隆命令:

cd ~/.claude/skills
git clone https://github.com/OthmanAdi/planning-with-files.git

 

激活机制:无需复杂配置。当对话中出现"planning"、"organize"、"track progress"等关键词,或用户派发复杂任务时,Skill自动触发,并初始化task_plan.md文件。

 

适用场景评估

场景类型 适配度 说明
长链路研究任务 ★★★★★ 多阶段、跨越多轮对话的项目
代码生成与调试 ★★★★★ 需要维持代码架构一致性的工程
数据整理与分析 ★★★★☆ 需要中间结果存档的分析工作
短周期问答 ★★☆☆☆ 3轮以内的简单查询(开销大于收益)
创意头脑风暴 ★★★☆☆ 需要跟踪创意演进过程时有帮助

 

设计理念溯源

该项目间接源自GTD(Getting Things Done)方法论在AI领域的应用转化:

  • 清空大脑:信息不存储在对话框,而是持久化到文件系统
  • 明确下一步:通过task_plan.md中的复选框确保意图清晰
  • 定期回顾:在每个循环中强制进行进度检查

这种方法论的核心价值在于将上下文管理从"被动承载"转向"主动治理"。

 

相关项目推荐

若对上下文工程感兴趣,还可关注:

  • Claude Code官方Skills库(1.4w+ Star):提供更多预制工作流插件
  • Playwright+AI组合方案:用于自动化任务的文件系统管理
  • LSP集成方案:加强IDE级别的上下文持久化

 

总结与实践建议

从产品角度看,planning-with-files代表了AI工具设计的一个重要转向:从追求模型能力的上限,转向优化人机协作的工作流效率。

这个项目证明了一个看似简单的原则——外部存储的可靠性往往超过模型的内部记忆。它不需要模型升级、不需要更多的参数,只需要重新设计信息流向。

对于需要与AI进行长期、复杂协作的用户,特别是编程、研究、数据分析领域的专业人士,这套方案值得一试。它的价值不在于创意,而在于将一套经过验证的工程范式开源化,降低了复杂任务自动化的实现门槛。

 

项目地址:https://github.com/OthmanAdi/planning-with-files

声明:本站原创文章文字版权归本站所有,转载务必注明作者和出处;本站转载文章仅仅代表原作者观点,不代表本站立场,图文版权归原作者所有。如有侵权,请联系我们删除。
未经允许不得转载:planning-with-files:超越对话限制,用一个插件(Skill)赋予Claude持久记忆的上下文工程方案
#上下文工程 #持久记忆 #Skill #Claude Code 
收藏 1
人人都是小程序开发者的时代,真的来了(附实战指南)
腾讯混元超强开源翻译模型 HY-MT1.5:本地部署的多语言翻译、方言,实时翻译
推荐阅读
  • Antigravity-Manager:这个开源神器让你白嫖ClaudeOpus 4.5,Gemini 3!还能接Claude Code等任意平台
  • ChatLab:本地化聊天记录分析平台,用AI解构社群数据 AI Agent 项目
  • Fogsight (雾象):一句话自动生成任何科普动画
  • Puter:开源个人云操作系统,打造隐私优先的文件与应用管理平台
  • 豆包AI 手机平替,4个 AI 操纵手机的开源项目
评论 (0)
请登录后发表评论
分类精选
OpenSpec:比 Cursor Plan 更聪明?试试这款让 AI 编码更靠谱的规范驱动工具
6670 2月前
WeKnora:终于等到了腾讯ima的开源知识库框架,用 API 轻松打造本地智能文档检索
4765 4月前
Composio:让AI Agent自动完成工作任务,能让AI一键操控你的所有软件
4474 2月前
SpecKit:从想法到代码只需5步?这个开源框架把规范驱动开发变成了现实
3881 2月前
iFlow CLI:让命令行终端不止于编程的AI效率开源神器
3628 4月前
SurfSense:私人AI研究助手,私有版的NotebookLM 和 Perplexity开源平替,
3260 2月前
KrillinAI:开源AI视频翻译配音工具,100种语言双向翻译,一键部署全流程
3090 2月前
AIRI:你的开源AI女友,让你随时拥有属于自己的 AI VTuber
3032 4月前
Fogsight (雾象):一句话自动生成任何科普动画
2896 2月前
CompressO:开源免费的视频压缩神器,让你的硬盘瞬间轻松 10 倍
2718 3月前

文章目录

关注「苏米客」公众号

订阅推送更及时,手机查看更方便
分类排行
1 Interview Guide:开源智能面试平台,集简历分析、AI模拟面试与知识库问答于一体
2 LFM2-Audio-1.5B:1.5B参数!支持本地实时语音转录
3 planning-with-files:超越对话限制,用一个插件(Skill)赋予Claude持久记忆的上下文工程方案
4 Adnify:一个集聊天、任务执行、项目规划于一身的开源 AI IDE
5 PPTAgent:一个把文档自动转成结构化幻灯片的开源 AI 系统
6 Fay:12.0K Star 的开源数字人框架,让 AI 助理有眼神、有表情、能感知情绪
7 Octopus:统一管理多个 LLM 的开源网关,支持智能负载均衡与自动费用追踪
8 Vibe Kanban:将多个AI编程Agent纳入统一管理的任务看板系统
9 Easy-Vibe:把“会用大模型”变成“能上线产品”的系统化学习路径
10 6 款开源 CLI 工具合集:AI 驱动的命令行开发体验
©2015-2024 苏米客XMSUMI 版权所有 · WWW.XMSUMI.COM 闽ICP备14005900号-6
微信文章助手 程序库 免费影视APP 免费字体下载 Axure RP 10 免费Axure模板 Axure元件库下载 申请友联