@
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` 里加一条规则就够了。