项目管家
用最小必要信息恢复正确的项目状态，不靠重读全部聊天或堆积总结。
1. 核心原则
- 一个事实一个权威位置：目标、当前实现、任务进展、决策和偏好分开记录，其他位置只引用。
- 目标不等于现状：用已确认需求判断目标，用对应版本的代码和验证判断现状；不修改需求来迁就错误实现。
- 任务完成不等于已合并或已发布：实现、验证、整合、用户验收和发布分别记录。
- 当前工作集有界，历史仍可寻址：索引只保留当前状态与入口，历史摘要也计入体量；聊天全文不是唯一备份。
- 文字登记不是排他锁：负责人、角色和记录不代替真实权限、工作树隔离、版本校验或测试。
- 遵守宿主指令和当前用户授权；咨询默认只读，明确授权内直接推进。新增范围、不可逆操作或责任不明的共享改动才追加确认。
2. 启动与按需读取
- 核对受管项目根、代码模块根、技能位置、工具工作区和 cwd。
- 读取根 AGENTS 的有效约定、
manager/CONTEXT.md与实际存在的项目约定入口。核对大小写与重复文件，同版本已加载不重复展开。 - 核对基线：分支/HEAD、相关文件差异与版本；多仓库记录版本向量，运行和数据库版本另列。无 Git 时使用可恢复快照。未提交/未跟踪文件不是垃圾。
- 找到本次任务及直接依赖，先定位，再读取相关接口、源码、测试和必要历史；空搜索、截断或读取失败不证明不存在。
- 开工前明确：目标、不做、授权范围、负责人、基线、允许改动、依赖、验收与阻塞。用户暂停或只要草稿时，不恢复旧开发。
读取层次：L0 为短路由，L1 为当前索引与相关约定，L2 为本任务需要的详细资料。文件存在不代表宿主自动加载；摘要不代表平台已清除聊天历史。
3. 信息组织
| 位置 | 内容 | 维护责任 |
|---|---|---|
AGENTS.md |
短路由、稳定边界 | 指定维护者 |
manager/CONTEXT.md |
已整合状态、基线、风险、活动工作入口与下一步 | 集成者 |
| 项目约定入口 | 稳定规则与环境入口 | 约定维护者 |
现有工单或 manager/tasks/ |
单项任务、检查点、变更与验证 | 任务负责人 |
manager/docs/、manager/decisions/ |
当前契约、关键决策及替代关系 | 模块或契约维护者 |
manager/stages/、manager/history/ |
里程碑、结束记录与历史导航 | 归档维护者 |
复用已有工单、PR、CI 和模块文档，不另造重复台账。单人小改可在现有记录中写几行，不强制新建任务目录、ADR 或全套手册。
4. 多人和多 Agent 协作
- 每项任务使用稳定唯一 ID，声明负责人、基线、修改范围、依赖、验收和产物位置；不要竞争同一个“下一阶段编号”。
- 优先独立分支/工作树；共享工作区写前复核文件版本。冲突时重读、协调，不强制套旧补丁。
- 共享接口、迁移、依赖锁、生成文件、全局配置及外部测试资源需指定协调者；工作树不隔离数据库、端口或账户。
- 各负责人维护自己的任务，交付变更与证据；集成者验证最终整合结果后才更新共享状态。单人可兼任，但自验不是独立审核。
- 失联、暂停或文字租约到期不授予接管权；先核实所有权、未提交工作和未完成操作。
详细状态与集成门见 协作协议。
5. 变更与验收
- 编辑前读取相关文件并保留基线；使用可用的版本校验。不擅自清理他人改动、提交、推送或重置历史。
- 按可验证单元推进，检查跨接口、数据和前后端影响；在授权范围保存提交、补丁或快照，并记录可取回位置。
- 验证记录包含变更版本、环境、命令或方法、实际结果、证据和未覆盖部分。未跑写未执行，失败写失败，不用旧版本证据证明新改动。
- 对取消、超时、重试、安全和数据迁移补充相应反例。测试与需求冲突先核对契约，不删反例或放宽断言换取通过。
- 按约定验收和责任归属移交；最终整合后补必要测试，发布另记实际环境、版本与结果。无稳定任务分母时不猜百分比。
6. 中断恢复与收尾
- 保存或读取检查点：任务与授权、基线和差异、可恢复产物、验证状态、风险、未完成副作用、下一步及来源指针。
- 恢复先比对实际工作区和运行状态；不能按旧摘要盲目重放迁移、发送、发布等副作用。
- 已结束任务退出活动工作集，历史迁出并保留索引、原始证据和替代关系。未解决风险、暂停、撤回和待决策必须继续可见。
- 保留原阶段路径；重复编号用稳定 ID 和完整路径区分，不为整齐批量改名或改写历史。
- 当前记录矛盾时先核实再收口，不追加另一段“最新总结”。只有状态或契约变化才更新相应权威记录。
整理与恢复见 上下文生命周期；首次接入、预算和回退见 渐进迁移。
7. 数据与操作边界
- 凭据不进入文档、规则、日志或截图，只保留安全引用；个人资料按目的最小化。泄漏先停止传播并安排撤销/轮换，不能靠 gitignore 或移动文件解决。
- 删除、覆盖、迁移和生产操作先核对影响、授权及恢复方案；备份需要适配数据一致性，文件存在不等于可恢复。
- 不在真实业务数据上试破坏性场景；只清理能确认由本任务创建的测试资源，不按进程名批量杀服务。
8. 项目经验与按需模板
先区分实现错误、项目特例、工具限制和协作约定缺口。实现问题回到代码和测试，项目约定放在对应权威入口；只有可复用且有证据的经验才沉淀为项目规则，保留适用条件、版本和替代关系，不重复堆叠同义禁令。
接入既有 AGENTS 时只修改已确认的 project-manager 受管块，保留用户内容和其他工具维护的部分。
按需使用，不全量预加载：
- 记录模板：当前状态、任务、决策、历史与事故。
- AGENTS 受管块：安全接入既有规则。
- 交接演练：并行任务、中断、集成与归档。
