yiming-Falcon YM PM Clean
把一个项目整理到“当前成员找得到、后续成员接得住”的状态。结构从真实资料和真实工作流中长出来，不先创建一批空目录。
工作原则
- 先确认项目边界，再读取和整理。
- 当前入口保持少而明确；历史材料不得与现役真源竞争。
- 更新和合并优先于新增同类说明文件。
- 移动或改名后，立即查找并修复旧路径引用。
- Agent 承担可回读的低风险整理；删除原件、线上变更和大范围迁移集中请人确认。
- 项目任务仍回到既有任务系统，不在整理结果中建立第二套 Todo。
1. 选择模式
根据用户意图选择：
- 审计模式：用户要求检查、评估或给建议。只读取，不移动或改写文件。
- 整理模式：用户明确要求整理、执行、收尾或归档。直接完成低风险调整并回读。
先确定项目根目录。个人资料总目录、同步盘根目录和包含多个项目的上级目录，默认不是单个项目根。
以下情况必须暂停并集中确认：
- 删除、覆盖真实原件。
- 批量移动大量资料或改变共享路径。
- 修改线上仓库、共享文档、权限、域名、部署或公开状态。
- 处理密钥、账号、客户隐私或其他敏感数据。
2. 读取项目入口
优先寻找并读取：
- 项目主说明，例如
CLAUDE.md或项目自己的协作说明。 - 数据和版本权威索引，例如
SOURCE_OF_TRUTH.md。 - 跨 Agent 入口，例如
AGENTS.md。 - 当前状态、需求、设计、交付和最近一次交接。
这些文件不存在时，不机械补齐三件套。只有项目已经进入持续运行、存在多版本或需要交接时，才建立相应入口。
3. 建立内部盘点
默认扫描项目根以下三层，排除 .git、依赖、构建缓存和系统噪音。形成三张内部清单：
- 结构清单：目录、文件类型、体量、命名模式、空目录和散落文件。
- 真源清单：需求、数据、设计、当前版本、模板和交付物分别以谁为准。
- 阶段清单：已完成、进行中、待确认、下一闸门和历史产物。
给每个对象标记一个动作：
保留原位 / 更新 / 合并 / 归位 / 归档候选 / 删除候选 / 需要确认
删除候选只是判断，不等于授权删除。详细检查项见 references/project-clean-checklist.md。
4. 识别冲突
重点检查：
- 同一事实是否在多个文件中维护，内容是否不一致。
- “当前版”“最终版”“最新版”等名称是否对应多个文件。
- README、协作规则和权威索引是否互相覆盖职责。
- 历史方案是否仍出现在当前入口。
- 文件已经移动，但 Markdown、脚本或配置仍引用旧路径。
- 前台交付、内部工作底稿、运行缓存和敏感原件是否混在一起。
能从内容、修改时间、引用关系和项目规则确定的，直接修复。需要业务判断或会影响真实协作的，集中成一个确认点。
5. 执行整理
整理模式按以下顺序推进：
- 修正当前真源和入口中的错误事实。
- 合并重复说明，保留一个明确入口。
- 把文件归到已有的合适位置；没有稳定需求时不新建分类层。
- 将已结束阶段材料移入项目现有归档区；归档后仍保留来源和时间。
- 搜索旧文件名、旧目录名和旧路径，修复全部有效引用。
- 更新交接入口，使其只描述当前状态、下一动作和必要边界。
不要为了让目录“看起来完整”而创建空 README、空状态文件或空文件夹。
6. 五分钟接手测试
整理完成后，以一个不了解聊天历史的新成员视角检查：
- 能否在五分钟内找到项目目标和当前阶段？
- 能否找到需求、数据、当前成品和运行方式的唯一入口？
- 能否区分现役内容、历史材料和敏感后台？
- 能否知道下一步是什么、由谁决定、什么动作不能直接做？
- 文档中的关键路径、链接和命令是否真实可用？
任一答案为否，继续修复，不能只把问题写进报告后结束。
7. 输出
审计模式输出：
## 项目整理审计
- 当前结构：
- 真源与冲突：
- 建议调整：
- 需要集中确认：
- 建议执行顺序：
整理模式输出：
## 项目整理完成
- 已更新：
- 已移动或合并：
- 已修复引用：
- 未执行的高风险事项：
- 五分钟接手测试：通过 / 未通过
在结果末尾按 references/pm-handoff-contract.md 输出或更新 pm_handoff。未通过接手测试时，next_gate 保持 ym-pmclean。
边界
ym-pmintake：澄清项目价值、MVP 和验收。ym-pmclean：整理单个项目的结构、真源、阶段材料和交接。ym-pmsafety：审查代码、数据、权限、部署和自动化风险。- 个人或团队整体工作空间治理应使用对应的空间治理能力，不由 PM Clean 承接。