核心用法
planning-with-files 是一个受 Manus 启发的文件驱动规划技能，将上下文窗口比作易失性 RAM，文件系统比作持久化磁盘。核心用法遵循 "创建-读取-更新" 循环：
1. 启动阶段：执行复杂任务前，必须创建三件套文件：
task_plan.md：定义任务阶段、目标、依赖关系findings.md：存储研究发现、搜索结果progress.md：记录会话日志与执行轨迹
2. 执行阶段：通过钩子机制自动注入计划内容到提示上下文，支持 PreToolUse、UserPromptSubmit、PostToolUse 等关键节点
3. 恢复阶段：/clear 后可通过脚本恢复上下文，多会话协作通过 .planning/YYYY-MM-DD-<slug>/ 隔离目录实现并行任务
显著优点
- 持久化记忆：突破上下文窗口限制，关键信息落盘不丢失
- 自动注入：Hooks 自动将计划内容注入工具调用前后，无需手动复制粘贴
- 防篡改机制（v2.37.0+）：SHA-256 哈希认证，计划文件被静默修改时自动阻断注入
- 并行任务支持：通过
PLAN_ID环境变量或set-active-plan.sh切换多个独立计划 - Claude Code 深度集成：支持
/plan-goal、/plan-loop、PreCompact 钩子等新原语
潜在缺点与局限性
- 学习成本：需理解 RAM/Disk 隐喻、三文件分工、钩子时机等概念
- 手动维护：计划文件需主动更新，无自动同步机制
- 安全风险：
task_plan.md被自动注入，若写入未经验证的网页内容可能导致提示注入 - 跨平台差异：Windows PowerShell 与 Unix Shell 脚本需分别维护
适合人群
- 处理 5+ 工具调用的复杂多步骤任务
- 需要跨会话保持上下场的长期项目
- 同时推进多个并行任务的开发者
- 追求可审计、可追溯工作流的专业用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 提示注入 | 恶意网页内容写入 `task_plan.md` 后被自动注入 | 外部内容仅写入 `findings.md`；启用 `/plan-attest` 哈希认证 |
| 计划漂移 | 文件修改后未更新，实际执行与计划脱节 | 钩子检测篡改时阻断并告警 |
| 上下文污染 | 过时计划内容残留影响决策 | PreCompact 钩子提醒刷新进度 |
| 并行冲突 | 多任务同时修改同一计划目录 | 使用隔离目录 + 显式切换活跃计划 |