@
YUX 好，看完了。给个综合评估。
---
## 水平评估：planning-with-files
### 核心思路（ 7/10 ）
思路本身是对的——"文件系统当持久记忆，上下文窗口当临时 RAM"。具体手段：
| 机制 | 说明 | 评价 |
|------|------|------|
| 三文件模式 | `
task_plan.md` + `
findings.md` + `
progress.md` | 结构清晰但死板 |
| 2-Action Rule | 每 2 次搜索/查看后强制存盘发现 | 实用，防遗忘 |
| Re-read Before Deciding | 做重大决策前重读计划 | 对抗 attention drift 有效 |
| Error Log | 错误记录防重复踩坑 | 好习惯 |
| Stop Hook | 结束前验证所有阶段完成 | 合理的收尾检查 |
这套理念对**长 session**（ 50+ tool calls ）确实有帮助，因为 Claude 在超长对话里容易丢失早期目标。
### 实际实现（ 4/10 ）
**本质上是一套 prompt 模板 + hooks 配置，没有任何真正的代码。**
- Skill 文件就是一段 markdown 指令（"你应该创建
task_plan.md…"）
- Hooks 只是在 PreToolUse/PostToolUse/Stop 时机触发提醒
- 模板是标准 markdown checkbox ，手写 10 分钟就能搞定
- 没有任何解析逻辑、状态机、或智能判断
跟 Claude Code 内置能力的对比：
| 功能 | planning-with-files | Claude Code 内置 |
|------|-------------------|-----------------|
| 任务追踪 | 手写 markdown checkbox | **TodoWrite** 工具，结构化 JSON ，实时 UI |
| 计划模式 | prompt 指令 "先写计划" | **EnterPlanMode** 工具，真正的模式切换 |
| 进度可视 | 读文件 | Todo 面板，状态栏 |
| Hooks | 有，但只是提醒 | 原生支持，更深度集成 |
| 研究存储 |
findings.md | 子 agent 隔离 + auto memory |
### 营销 vs 实质（ 2/10 ）
- README 开头就是"Manus AI's context engineering pattern — $2 billion startup"——**纯蹭热度**
- 15k stars / 1.4k forks 的数据在这种 AI 工具圈里很常见，很多是 star-farming
- 支持"16 个 IDE"听起来厉害，实际就是把同一份 markdown 复制到 `.cursor/`、`.codex/`、`.gemini/` 等 16 个目录
- v2.18.2 的版本号对于一个纯 markdown 项目来说，虚高得离谱
### 跟你现有体系的对比
你目前的 `rules/common/` 体系其实**已经覆盖了它的核心价值**：
- `
development-workflow.md` → Plan First + TDD + Review （比它更完整）
- `
agents.md` → 多 agent 并行分析（比它更强）
- `
hooks.md` → hook 最佳实践
- `
performance.md` → 上下文窗口管理策略
它唯一多出来的东西是：**强制写文件落盘** 这个动作。但这个你用 TodoWrite + auto memory 就能做到。
### 总结
| 维度 | 评分 | 说明 |
|------|------|------|
| 核心理念 | 7/10 | 文件当记忆，对抗遗忘——正确 |
| 实现深度 | 4/10 | 纯 prompt 模板，无实质代码 |
| 工程质量 | 3/10 | 16 个目录里放同一份文件，不是工程能力 |
| 营销诚实度 | 2/10 | "Manus $2B" 蹭热度严重 |
| 对你的价值 | **3/10** | 你已有更完整的体系 |
**一句话：思路对，包装虚，实现浅。** 你不需要它——如果真想要"强制文件落盘"的行为，自己在 `rules/common/
hooks.md` 里加一条规则就够了。