葫芦客
1. 介绍
最近重度使用了一段时间的AI工具，确实享受效率的飞升，但遇到了一些困惑，当与AI对话轮次多了，任务复杂了，AI 就会逐渐变得 “健忘”：偏离目标、重蹈错误，堆砌代码、重复提示词、上下文溢出等，起初采用了普通的Skill提炼编码规范会有所改善，不能完全解决问题，于是在网上再找方案，最后了解到GitHub上有一款非常火的项目planning-with-files，它借鉴了 Manus 的方法论，采用 Claude Code 的 Plugin+Skill 实现了 “对话即文档” 的持久化工作流 ，通过自动生成和更新task_plan.md、findings.md、progress.md等结构化文件，将 AI 交互中的思考过程、技术方案、任务拆解和执行进度完整沉淀到本地，既保留了AI 对话的灵活性，又具备了工程化项目的可追溯性，从技术层面彻底解决了长对话上下文溢出和 AI “健忘” 的问题。
2. planning-with-files 亮点
- 开源免费
- 复刻Manus核心工作流，揭示"上下文工程"技术关键
- 通过三个文件模式解决AI长期记忆问题：当前情况+任务计划+进度
- 基于有名的PDCA 循环设计让AI编程更稳定高效，不再跑偏
3. planning-with-files的记忆魔法
它的核心理念简单得令人发指，却又有效得惊人：把 Markdown 文件当作 AI 的硬盘记忆，这个Skill强制AI在执行复杂任务时，必须遵循 “三文件模式”：
| 文件名 | 说明 |
|---|---|
| task_plan.md | 跟踪任务的阶段划分与进度完成情况 |
| findings.md | 存储项目过程中的调研成果与关键发现 |
| progress.md | 留存会话日志与测试结果 |
最精彩的设计在于它的工作流循环：
-
普通 AI Agent 的执行链路是这样的：
接收指令 → 执行 → 执行 → 执行 → 目标漂移 → 重复错误 → 崩溃| task_plan.md | 跟踪任务的阶段划分与进度完成情况 |
| findings.md | 存储项目过程中的调研成果与关键发现 |
| progress.md | 留存会话日志与测试结果 | -
而搭载这套 Skill 的 Claude，走的是一套循环校准的工作流：
1.读计划（Read）：决策前必看 task_plan.md，把核心目标重新拉回 “注意力窗口”
2.做执行（Act）：落地搜索、编码、调研等具体任务
3.记结果（Update）：把发现存入 findings.md，把详细进度同步更新到 progress.md
4.复盘错（Review）：记录错误与问题，归档到日志留档备查
这套 “读取 - 执行 - 记录 - 复盘” 的闭环，让 AI 哪怕完成 50 次以上工具调用，依然能像对话初期一样清醒：我要做什么、卡在了哪里、下一步该干什么。
4. 安装planning-with-files
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files5. 验证安装
安装完成后，验证插件加载状态：
1.新建 Claude Code 会话，页面将显示：「[planning-with-files] Ready.」
2.该插件对复杂任务自动生效，也可手动输入指令唤起：/planning-with-files
6. 开启实战表演
-
下发重构任务，会自动初始化三个文件
▐▛███▜▌ Claude Code v2.1.7 ▝▜█████▛▘ Sonnet 4.5 · API Usage Billing ▘▘ ▝▝ ~/wk/dm-platform21 /model to try Opus 4.5 ❯ /planning-with-files .... ● Read(~/.claude/plugins/cache/planning-with-files/planning-with-files/2.1.2/templates/task_plan.md) ⎿ Read 133 lines ● Read(~/.claude/plugins/cache/planning-with-files/planning-with-files/2.1.2/templates/findings.md) ⎿ Read 96 lines ● Read(~/.claude/plugins/cache/planning-with-files/planning-with-files/2.1.2/templates/progress.md) ⎿ Read 115 lines ● Now I understand the planning workflow. However, I notice that you haven't specified what task you'd like me to help you with yet. Before I can create a meaningful plan, I need to understand: hat would you like me to help you accomplish in this codebase? ..... ❯ 需要重构system-service项目并同步调整system-web，有以下要求： 1、严格遵循前后端开发规范skill完成全量优化，明确持久层、业务层、控制层、Feign层的实体边界与命名规范，彻底解决分层混乱; 2、核心兼容要求：历史接口、业务逻辑、Feign接口实体可以规范化，因为要考虑历史平滑升级；字段命名有变更的，同步在system-web前端工程中完成对应字段调整，保证前后端匹配; 3、实体优化后，同步更新system-service工程中控制器、Feign、Service、Mapper等所有依赖模块的实体引用，无残留无报错; 4、重构完成后，启动system-service后端和system-web前端，通过MCP工具对所有重构的接口、Feign链路进行全量功能测试，确保请求响应正常、业务逻辑无误； 5、重构过程中提炼前后端通用的规范skill改进建议,并更新dimine-backend-coding-enriched和dimine-frontend-coding中; 6、所有实体严格按分层职责使用，但是为了避免太多实体创建和转换，一些查询方法上层实体可以在下层中使用; 7.过程中提出骨架改进建议，并更新到/home/hushow/wk/dm-platform21/dm-framework中; 8.重构合并实体时注意字段核对 9.实体json序列化不能指定时区GMT+08:00，要考虑后面国际化方案 ● 明白了！这是一个复杂的系统性重构任务。让我先创建规划文件，然后探索代码库以了解当前结构和规范要求。 ● Write(task_plan.md) ⎿ Wrote 89 lines to task_plan.md # Task Plan: system-service & system-web 重构优化 <!-- WHAT: system-service实体分层重构 + system-web前端同步调整的完整计划 WHY: 解决实体分层混乱问题，规范化架构，提升代码质量 WHEN: 创建于规划阶段，将在实施过程中持续更新 --> ## Goal 重构system-service项目并同步调整system-web，严格遵循前后端开发规范完成全量优化，实现实体分层清晰化、命名规范化，确保历史兼容性，并通过全量功能测试验证重构正确性。 … +79 lines (ctrl+o to expand) ● Write(findings.md) ⎿ Wrote 53 lines to findings.md # Findings & Decisions <!-- WHAT: system-service & system-web 重构的知识库 WHY: 记录发现的问题、技术决策和架构方案 WHEN: 持续更新，特别是在探索和设计阶段 --> ## Requirements <!-- 用户需求分解 --> - 重构system-service项目，严格遵循后端开发规范 … +43 lines (ctrl+o to expand) ● Write(progress.md) ⎿ Wrote 77 lines to progress.md # Progress Log <!-- WHAT: 重构任务的会话日志 WHY: 记录已完成的工作、测试结果和错误 WHEN: 每个阶段完成后或遇到错误时更新 -->调研成果与关键发现 ## Session: 2026-01-15 ### Phase 1: Requirements & Discovery … +67 lines (ctrl+o to expand) ● 好的！规划文件已创建。现在让我并行启动3个探索代理来了解：1）前后端开发规范要求，2）system-service的实体分层现状，3）system-web的前端结构。 .......省略 -
正常确认方案、授权，等待成果
-
测试新会话
一段时间后我主动中断会话，测试新会话确实恢复执行，点赞！
-
持久化成果截图
1.findings.md文件
存储项目过程中的调研成果与关键发现
2.task_plan.md文件
跟踪任务的阶段划分与进度完成情况
3.progress.md
发现在执行完阶段任务，cluade code确实每次会及时留存会话日志与测试结果
