核心用法
Project Manager v2.7.0 是一套专为Agent对话场景设计的项目上下文隔离与状态管理系统。用户通过自然语言触发词(如"新建项目"、"回到XX"、"项目列表"、"甘特图"等)即可激活系统功能。系统会自动在workspace/projects/目录下创建项目空间,每个项目拥有独立的STATUS.md文件记录进度、待办、关键决策等信息,并通过index.md维护项目索引。
系统支持分级管理:3天以上的复杂项目使用完整模板(含核心目标、当前状态、待办事项、关键决策等模块),短期单任务使用轻量模板。用户可随时切换项目,系统会强制读取目标项目的STATUS.md恢复上下文,确保不携带其他项目的"信息污染"。
甘特图功能通过读取STATUS.md中的Timeline YAML块自动生成ASCII可视化进度图,支持里程碑追踪、资源冲突检测与延期预警。风险识别模块(需用户显式开启)可按规则引擎自动扫描8类项目风险,包括静默风险、单点依赖、估时不准、范围蔓延等。
显著优点
彻底解决Agent遗忘痛点:系统以"物理隔离+显式状态化"为核心设计原则,每个项目独立存储,重要决策即时落盘(需用户确认),从根本上解决对话跨Session丢失上下文的行业难题。
极低使用门槛:纯自然语言交互,无需学习特定命令语法。意图识别覆盖显式命令、隐含指代、重要性标记、话题切换、完成信号等6大类场景,用户可像与真人项目经理对话一样使用。
Token效率优化:通过STATUS.md结构化锚点替代完整对话历史,大幅降低Memory负载。据文档说明,STATUS.md体积"远小于完整对话历史",对长周期项目尤为关键。
灵活的分级与opt-in设计:状态同步、风险扫描、对话日志等高级功能均需用户显式开启,避免功能过度侵入。小任务可用轻量模板,防止"杀鸡用牛刀"的过度工程化。
安全设计贯穿始终:所有写入操作需用户确认,采用"读-合并-写"模式降低冲突,明确禁止用MEMORY.md记录项目进度,数据完全本地化存储。
潜在缺点与局限性
依赖用户主动配合:系统 effectiveness 高度依赖用户是否愿意在关键时刻确认记录。若用户频繁忽略"是否记录到项目状态?"的提议,信息仍将流失。
TOCTOU竞态条件:文档明确承认"读-写之间内容可能被其他session修改",非真正的写入安全,仅降低冲突概率。高并发场景下可能出现状态覆盖。
T3来源可信度:作者Kris Lu为个人开发者,非企业级背书。虽代码完全透明可审计,但企业用户可能需要额外安全审查流程。
功能边界需清晰认知:纯Markdown指令Skill,本身不执行代码,所有文件操作依赖Agent的工具调用能力。若底层Agent能力受限,系统功能将受牵连。
中文生态适配:部分概念(如kebab-case命名、YAML Timeline块)对非技术用户存在学习成本,模板升级判断(A/B模板选择)依赖用户自行评估项目复杂度。
适合的目标群体
长期多项目并行者:同时推进3-5个以上项目、需要频繁切换上下文的用户,如独立开发者、咨询顾问、产品经理。
跨天协作需求者:工作节奏非连续、需要"明天接着聊"场景的用户,系统解决了Agent"每天醒来是全新的"的天然缺陷。
结构化思维偏好者:喜欢甘特图、里程碑、待办清单等可视化管理工具,愿意投入少量 overhead 换取信息确定性的用户。
技术背景用户:能理解目录结构、YAML配置、Git commit hash等概念,可自主排查pm-checkpoint.json等底层文件的用户。
安全敏感型个人用户:重视数据本地化、拒绝云服务、需要完全掌控项目数据的个人知识管理者。
使用风险
性能风险:风险扫描需遍历全量项目目录读取STATUS.md,项目数量超过20个时可能产生可感知的延迟。建议定期归档旧项目。
存储风险:所有数据存储于workspace/projects/和memory/目录,若用户误删或磁盘损坏,项目状态将永久丢失。系统无自动备份机制,重要项目建议配合Git或外部备份。
依赖项风险:系统本身无外部依赖,但依赖底层Agent的文件读写工具能力。若Agent工具调用失败或权限受限,状态记录将中断。
版本兼容性风险:v2.7.0引入甘特图、风险识别等新功能,若从旧版本升级,既有项目的STATUS.md可能缺少Timeline等新增字段,需手动补全或接受功能降级。
人为操作风险:用户可能误操作"状态同步"功能导致不必要的Token消耗(每次检查500-2000 token),或在未理解opt-in机制的情况下期待自动功能生效。