ecm-setup-file-organize

name	ecm-setup-file-organize
description	资本市场项目文件归位 Skill。基于 ecm-setup-file-classify 输出的分类标签结果，把文件物理归位（默认复制策略）到项目对应 DD 章节目录中，并生成"文件索引表.md"。触发场景：按标签归位文件、把文件搬到对应目录、按分类结果整理文件、生成文件索引表、文件整理入库、根据 classify 结果移动文件等。支持多标签文件复制到多个目录（保证下游 DD skill 都能读到）。
version	0.1.0
license	MIT
module	ecm-setup
user_role	项目组律师
phase	["启动阶段"]
category	["项目管理","文件处理"]
depends_on	{"internal_skills":["ecm-setup-file-classify"]}

ecm-setup-file-organize

定位与边界

本 skill 负责：

• 读取 ecm-setup-file-classify 的分类结果（或用户粘贴的等价格式）
• 按"标签→目录"映射把文件物理复制（默认）或移动到对应子目录
• 生成 文件索引表.md（按标签索引 + 按文件名索引），作为下游 DD skill 的入口
• 输出归位摘要（统计、多标签文件清单、冲突/异常列表）

本 skill 不负责：

• 读文件内容做分类（由 ecm-setup-file-classify 做）
• 对文件改名、压缩、转格式
• 在 02-99-未分类文件/ 之外的目录做归位

免责声明

本 skill 的归位操作是物理文件操作，可能产生不可逆后果（尤其是 move 策略）。默认使用安全的 copy 策略。律师须在执行前复核分类结果的准确性。完整免责声明见 DISCLAIMER.md。

资深律师执行标准

执行本 skill 时，必须同时遵循 senior-lawyer-execution-standards.md。本 skill 的任何输出不得突破四条底线：事实可追溯、法源可核验、风险可分级、建议可落地；无法核验时必须显式标注。

本 skill 的实务加固点

• 先索引后移动：执行归位前必须生成原路径索引；移动后保留原路径、目标路径、标签和处理时间。
• 冲突不覆盖：同名文件、不同版本、扫描件与可编辑件并存时必须保留全部版本并标注差异，不得覆盖。
• 多标签处理：多标签文件优先放入主目录，同时在索引表中建立交叉引用，避免复制多个副本造成版本失控。
• 缺类提示：核心 DD 目录无文件时必须输出缺失清单，提示后续向客户补充索取。

前置依赖

• 标签定义：shared/terminology/classification-labels.md
• 目录结构 + 标签→目录映射：shared/templates/project-folder-structure.md（唯一权威）
• 上游 skill：ecm-setup-file-classify（必须先跑）

---

核心原则

1. 多标签文件 → 默认复制到多个目录，不做"优先级选择"

一份章程既属 entity 也属 charter——默认两份都复制到对应目录。原因：

• 下游 DD skill 是按目录读文件的，漏到哪个都会导致该章尽调的输入丢失
• 磁盘空间成本远低于"尽调漏看关键文件"的业务成本

2. 原始文件保留，不删除

归位是 copy 操作，源目录（通常是 02-99-未分类文件/）的原始文件保留。律师按需自行决定何时清空 02-99（建议归档到 05-底稿和附件/原始文件归档/，而不是删除）。

3. 不改文件名

保持客户原始文件名。名字里的空格、中文、特殊字符都保留——这是律师回溯客户邮件的线索。

---

输入

1. 分类结果（必填）：file-classify 的输出，或等价格式的"文件→标签"映射
2. 项目根目录（必填）：例如 /Users/xxx/ECM-ABC/
3. 归位策略（可选，默认 copy）：
   • copy：多标签复制到多个目录（推荐，默认）
   • move：多标签只移入第一个匹配目录，原目录清空（不推荐，只在律师明确要求时使用）
   • symlink：多标签在主目录保留原文件，其他目录创建快捷方式（高级，跨平台不一致，仅在 Unix/macOS 使用）

---

处理流程

步骤 1：解析分类结果

接受以下三种输入：

1. 上一轮对话里刚跑完的 file-classify 输出（直接从上下文读取）
2. 用户提供的 Markdown 格式表格（"按文件分类"章节那种）
3. 简单文本列表（文件名 + 标签，空格或逗号分隔）

不论来源，都转成内部统一的 {相对路径 → 标签列表} 映射。

步骤 2：确认策略

如果用户未指定策略：

• 单标签文件 ≥ 80% → 默认 copy 策略，不追问
• 多标签文件 > 30% → 输出一段提示并让用户确认（"本批文件中 xx% 为多标签，默认使用 copy 策略，是否继续？")

如果用户选择 move，额外确认一次（"move 策略会导致原目录 02-99-未分类文件 为空，原始文件无备份，确认？"）。

步骤 3：执行归位

对每个文件：

1. 查表（标签→目录映射）得到目标目录列表
2. 对每个目标目录：
   • 确认目标目录存在（不存在则报错中止——这通常意味着 project-init 没跑过）
   • 检查目标目录下是否已有同名文件（冲突处理见下一节）
   • 按策略执行 cp / mv / ln -s

步骤 4：冲突处理

目标目录已有同名文件时：

情况	默认行为	可配置
两个文件的 MD5 完全相同	跳过（已在目标处）	强制覆盖也可
两个文件大小不同或内容不同	询问律师：覆盖 / 跳过 / 重命名为 xxx_v2.pdf	可批量一次性决定
目标是本 skill 前一轮执行产生的复制品	覆盖（假定是重跑）

询问律师时批量展示冲突清单，一次性决定——不要一个文件一次确认。

步骤 5：生成索引表

在项目根目录下写入 文件索引表.md（见下方"索引表格式"）。

步骤 6：输出归位摘要

# 文件归位摘要

**执行时间**：{YYYY-MM-DD HH:MM}
**项目根目录**：`{绝对路径}`
**策略**：{copy / move / symlink}

## 操作统计
- 总文件数：{N}
- 单标签文件：{A}（{A/N}%）
- 多标签文件：{B}（{B/N}%）
- 无法归位：{C}（见下方异常）

## 多标签文件清单
| 文件名 | 标签 | 复制到 |
|-------|------|-------|
| 公司章程.pdf | entity, charter | 02-02-主体资格/, 02-10-公司治理/ |

## 冲突处理记录
| 文件名 | 冲突位置 | 处理方式 |
|-------|---------|---------|
| 营业执照.pdf | 02-02-主体资格/ | 覆盖（MD5 相同） |

## 异常
- （无法归位 / 跳过 / 需人工介入的文件清单）

## 下一步
**建议立即调用**：`ecm-dd:dd-approval`（或按 project-init 生成的 roadmap 继续）

文件索引表已生成：`{ROOT}/文件索引表.md`

---

索引表格式

文件索引表.md 是下游 DD skill 查找输入文件的主入口，格式严格。

# ECM 项目文件索引表

**生成时间**：{YYYY-MM-DD HH:MM}
**项目根目录**：`{绝对路径}`
**本表对应的 classify 结果日期**：{YYYY-MM-DD}

---

## 一、按标签索引

### approval（批准和授权 → 02-01-批准和授权/）
| 文件名 | 所在路径 | 其他标签 | 备注 |
|-------|---------|----------|------|
| 董事会决议 2024-01.pdf | 02-01-批准和授权/ | — | 关于本次发行的决议 |
| 2023 年第一次临时股东会决议.pdf | 02-01-批准和授权/ | shareholders | 同时进入 02-05-股东及实控人/ |

### entity（主体资格 → 02-02-主体资格/）
| 文件名 | 所在路径 | 其他标签 | 备注 |
|-------|---------|----------|------|
| 公司章程.pdf | 02-02-主体资格/ | charter | 同时进入 02-10-公司治理/ |
| 营业执照.pdf | 02-02-主体资格/ | — | |

...（其他标签类似展开，**必须列出全部 19 个标签**，即使某个标签下无文件，标注"（无文件）"）

## 二、按文件名索引（A–Z）

| 文件名 | 标签 | 所在路径（首位） |
|-------|------|----------------|
| 2023 年第一次临时股东会决议.pdf | approval, shareholders | 02-01-批准和授权/ |
| 公司章程.pdf | entity, charter | 02-02-主体资格/ |
| 营业执照.pdf | entity | 02-02-主体资格/ |
| ... | ... | ... |

## 三、多标签文件清单

| 文件名 | 全部标签 | 全部目录 |
|-------|--------|---------|
| 公司章程.pdf | entity, charter | 02-02-主体资格/, 02-10-公司治理/ |
| 2023 年第一次临时股东会决议.pdf | approval, shareholders | 02-01-批准和授权/, 02-05-股东及实控人/ |

## 四、类别缺失提示

- `litigation` 下无任何文件——建议向客户补充索取"无诉讼/仲裁/处罚证明"
- `environment` 下无任何文件——如业务涉及生产，建议索取环评批复等

---

硬性要求

1. 目标目录不存在时禁止继续执行——报错并提示律师先跑 ecm-setup-project-init
2. 索引表必须生成——即使归位本身失败部分，索引表也要把成功归位的记下来
3. 索引表里 19 个标签都要列出，无文件的标签标注"（无文件）"，便于下游检查类别缺失
4. move 策略需要额外确认——默认执行路径不会走 move
5. 冲突解决用批量决策——不要一个文件一个询问

---

与下游 skill 的接口

• 下游 DD skill（ecm-dd-*）读文件的入口是 {ROOT}/文件索引表.md + 对应章节目录
• 下游 ecm-dd-data-verify 读文件时也可以通过索引表定位相关文件
• 下游 ecm-draft-report-assembly 会用索引表来回溯"这个结论是基于哪份文件出的"

因此索引表的完整性和准确性是本 skill 最核心的产出——归位操作失败没关系（可以重跑），索引表写错会污染下游所有 skill。

---

FAQ

Q：如果律师手动移动过一些文件，怎么办？ A：本 skill 仍然按分类结果重新复制。如果目标目录已有同名文件（MD5 相同）会跳过。不会清理律师手动移动产生的额外副本。

Q：索引表能否增量更新？ A：当前版本是全量重写。如果后续有新文件补充，重新跑 file-classify + file-organize，索引表会被覆盖。将来可能加增量模式。

Q：文件内容有中文乱码怎么办？ A：这是编码问题，本 skill 不处理。提示律师先用其他工具转码，再重新跑分类。

Q：能否生成 Excel 版的索引表？ A：当前只生成 Markdown。下游 DD skill 优先读 Markdown。需要 Excel 版可在 report-assembly 阶段基于索引表生成。