核心用法
Focus Tree 是一套会话级任务聚焦系统,核心文件为 FOCUS.md(当前工作状态)与 FOCUS-LOG.md(已完成归档)。用户在每次会话开始时读取 FOCUS.md,AI 即可立即恢复上下文,无需再问「我们之前做到哪了」。系统采用树状层级结构:🎯 Focus Point 为根任务,下辖 📝 TODOs(支持两级嵌套)、📌 Decisions、⚠️ Constraints、🤖 Sub-Agents 及 📖 Context 区块。TODO 状态通过 ☐/⏳/✅ 图标直观呈现。
触发写入的时机包括:用户发起新请求、任务完成、优先级变更、心跳检测发现阻塞等。每次更新需保持文件简洁(<50 行),并在工作暂停前更新 📖 Context 区块,确保「未来的自己」能无缝续接。
显著优点
1. 根治上下文遗忘:显式持久化当前任务状态,彻底解决长会话中 AI「失忆」或压缩后上下文丢失的问题。
2. 零认知负荷恢复:会话启动只需读取单文件即可对齐状态,无需用户重复背景说明。
3. 结构化追踪:树状层级 + 状态图标让复杂项目进度一目了然,支持子任务嵌套而不显混乱。
4. 轻量可扩展:纯 Markdown + Node CLI 脚本,无外部依赖,易于集成到任何工作流。
潜在局限
- 手动维护成本:依赖用户或 AI 主动更新 FOCUS.md,若规则执行松懈,文件可能过期。
- 单会话聚焦:设计为「一次只聚焦一件事」,多线程并行任务需要额外协调或拆分为多个 FOCUS 文件。
- 无自动同步:不监听文件系统变化,必须通过显式触发(CLI 或文件操作)更新。
- Node 环境依赖:CLI 脚本需要 Node.js,纯浏览器/受限环境需改用直接文件操作。
适合人群
- 进行长时间、多轮迭代的复杂项目开发者
- 需要与 AI 协作管理多个子任务的产品经理或技术负责人
- 对「AI 突然忘记上下文」感到困扰的高频用户
常规风险
- 状态漂移风险:若 AI 未严格遵守「每次会话先读 FOCUS.md」的规则,可能导致重复提问或错误假设。
- 归档遗漏:未完成归档直接新建项目,会造成历史上下文丢失。
- 文件冲突:多代理同时写入同一 FOCUS.md 时可能产生写入冲突(建议单代理主控)。
- 信息泄露:FOCUS.md 可能包含敏感任务细节,共享工作区需注意访问权限。