# Ym Pmclean

> 整理单个项目内部的目录、文件、文档真源、阶段产物、历史资料和交接入口。用于项目资料散乱、命名不一致、README/CLAUDE/AGENTS/SOURCE_OF_TRUTH 冲突、阶段收尾或需要让新人和其他 Agent 接手时。支持只读审计和受控整理；不治理整个个人工作空间，也不替代安全审查。

- Skill: `yiming-falcon/ym-pmclean` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add yiming-falcon/ym-pmclean`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yiming-falcon/ym-pmclean/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: yiming-Falcon (https://skillmd.com/u/yiming-falcon)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yiming-falcon/ym-pmclean

---


# YM PM Clean

把一个项目整理到“当前成员找得到、后续成员接得住”的状态。结构从真实资料和真实工作流中长出来，不先创建一批空目录。

## 工作原则

- 先确认项目边界，再读取和整理。
- 当前入口保持少而明确；历史材料不得与现役真源竞争。
- 更新和合并优先于新增同类说明文件。
- 移动或改名后，立即查找并修复旧路径引用。
- Agent 承担可回读的低风险整理；删除原件、线上变更和大范围迁移集中请人确认。
- 项目任务仍回到既有任务系统，不在整理结果中建立第二套 Todo。

## 1. 选择模式

根据用户意图选择：

- **审计模式**：用户要求检查、评估或给建议。只读取，不移动或改写文件。
- **整理模式**：用户明确要求整理、执行、收尾或归档。直接完成低风险调整并回读。

先确定项目根目录。个人资料总目录、同步盘根目录和包含多个项目的上级目录，默认不是单个项目根。

以下情况必须暂停并集中确认：

- 删除、覆盖真实原件。
- 批量移动大量资料或改变共享路径。
- 修改线上仓库、共享文档、权限、域名、部署或公开状态。
- 处理密钥、账号、客户隐私或其他敏感数据。

## 2. 读取项目入口

优先寻找并读取：

1. 项目主说明，例如 `CLAUDE.md` 或项目自己的协作说明。
2. 数据和版本权威索引，例如 `SOURCE_OF_TRUTH.md`。
3. 跨 Agent 入口，例如 `AGENTS.md`。
4. 当前状态、需求、设计、交付和最近一次交接。

这些文件不存在时，不机械补齐三件套。只有项目已经进入持续运行、存在多版本或需要交接时，才建立相应入口。

## 3. 建立内部盘点

默认扫描项目根以下三层，排除 `.git`、依赖、构建缓存和系统噪音。形成三张内部清单：

- **结构清单**：目录、文件类型、体量、命名模式、空目录和散落文件。
- **真源清单**：需求、数据、设计、当前版本、模板和交付物分别以谁为准。
- **阶段清单**：已完成、进行中、待确认、下一闸门和历史产物。

给每个对象标记一个动作：

```text
保留原位 / 更新 / 合并 / 归位 / 归档候选 / 删除候选 / 需要确认
```

删除候选只是判断，不等于授权删除。详细检查项见 [references/project-clean-checklist.md](references/project-clean-checklist.md)。

## 4. 识别冲突

重点检查：

- 同一事实是否在多个文件中维护，内容是否不一致。
- “当前版”“最终版”“最新版”等名称是否对应多个文件。
- README、协作规则和权威索引是否互相覆盖职责。
- 历史方案是否仍出现在当前入口。
- 文件已经移动，但 Markdown、脚本或配置仍引用旧路径。
- 前台交付、内部工作底稿、运行缓存和敏感原件是否混在一起。

能从内容、修改时间、引用关系和项目规则确定的，直接修复。需要业务判断或会影响真实协作的，集中成一个确认点。

## 5. 执行整理

整理模式按以下顺序推进：

1. 修正当前真源和入口中的错误事实。
2. 合并重复说明，保留一个明确入口。
3. 把文件归到已有的合适位置；没有稳定需求时不新建分类层。
4. 将已结束阶段材料移入项目现有归档区；归档后仍保留来源和时间。
5. 搜索旧文件名、旧目录名和旧路径，修复全部有效引用。
6. 更新交接入口，使其只描述当前状态、下一动作和必要边界。

不要为了让目录“看起来完整”而创建空 README、空状态文件或空文件夹。

## 6. 五分钟接手测试

整理完成后，以一个不了解聊天历史的新成员视角检查：

- 能否在五分钟内找到项目目标和当前阶段？
- 能否找到需求、数据、当前成品和运行方式的唯一入口？
- 能否区分现役内容、历史材料和敏感后台？
- 能否知道下一步是什么、由谁决定、什么动作不能直接做？
- 文档中的关键路径、链接和命令是否真实可用？

任一答案为否，继续修复，不能只把问题写进报告后结束。

## 7. 输出

审计模式输出：

```markdown
## 项目整理审计
- 当前结构：
- 真源与冲突：
- 建议调整：
- 需要集中确认：
- 建议执行顺序：
```

整理模式输出：

```markdown
## 项目整理完成
- 已更新：
- 已移动或合并：
- 已修复引用：
- 未执行的高风险事项：
- 五分钟接手测试：通过 / 未通过
```

在结果末尾按 [references/pm-handoff-contract.md](references/pm-handoff-contract.md) 输出或更新 `pm_handoff`。未通过接手测试时，`next_gate` 保持 `ym-pmclean`。

## 边界

- `ym-pmintake`：澄清项目价值、MVP 和验收。
- `ym-pmclean`：整理单个项目的结构、真源、阶段材料和交接。
- `ym-pmsafety`：审查代码、数据、权限、部署和自动化风险。
- 个人或团队整体工作空间治理应使用对应的空间治理能力，不由 PM Clean 承接。