Material to Deliverable

# Material to Deliverable

把 `00_input/` 中的真实资料整理成可检查、可追溯、可交付的文字文件。

## 启动条件

仅在同时满足以下条件时执行。

- 用户提供或指定了本地项目目录。
- `00_input/` 中至少有一份真实材料。
- 用户希望得到汇报、方案、复盘、调研或课程展示之一。

目录不明确时，只问项目目录。交付类型不明确时，只问交付类型。没有真实材料时停止，不生成示例或替代材料。

## 每次都要读取

开始处理前完整读取：

- [证据与安全规则](references/evidence-and-safety.md)
- [文件合同](references/file-contract.md)

确认交付类型以后，再读取 [交付类型规则](references/deliverable-types.md) 中对应的一节。

## 工作流程

### 1. 确认项目与初始化

项目尚未初始化时，从本 Skill 的安装目录调用脚本，并传入明确的项目路径：

```bash
python3 <skill-directory>/scripts/init_project.py /absolute/path/to/project
```

不要假设用户项目当前目录中存在 `scripts/`。先根据本文件位置解析 `<skill-directory>`，再执行脚本。

如果 `01_working/` 已存在，读取已有状态并继续，不重新初始化，不覆盖文件。

### 2. 检查输入与敏感信息

列出 `00_input/` 中全部文件，记录无法读取或来源不明的文件。不要修改、移动或重命名原始材料。

先做敏感信息检查。发现姓名、个人联系方式、账号、客户资料、合同、财务、健康、教育记录、凭证、内部路径或其他可能受限的信息时：

1. 只在 `02_material-index.md` 记录风险类型与文件位置，不复制敏感值。
2. 立即暂停。
3. 请用户确认其有权处理这些材料，或请用户提供脱敏副本。

未经用户确认，不继续提纲、写作和交付。

### 3. 澄清任务

每次只问一个会改变成品的问题，最多七个。优先确认接收者、使用场景、希望促成的决定、截止时间、交付类型、必须保留和禁止出现的内容。

用户回答“不知道”时，写入待确认事项，不替用户补答案。将结果写入 `01_task-brief.md`，展示摘要，等待用户确认。

### 4. 建立材料索引与缺口

逐份材料填写 `02_material-index.md`，分清：

- 来源能够直接支持的事实
- 当事人或机构自述
- 访谈、反馈或局部观察
- 用户本人判断
- 待确认信息

将冲突、缺失、无法读取、需要脱敏和证据不足的内容写入 `03_gaps-and-conflicts.md`。少量材料不能扩大为普遍结论。

阻断性缺口仍存在时继续提问或停止，不生成主成品。

### 5. 创建带来源提纲

根据交付类型创建 `04_source-backed-outline.md`。每个部分必须写清要回答的问题、使用的材料、允许得出的结论、用户判断、待确认项和验收方式。

展示提纲摘要与来源覆盖情况，等待用户确认。未确认前不写主成品。

### 6. 生成成品与来源索引

根据确认后的提纲生成：

- `05_main-deliverable.md`
- `06_one-page-summary.md`
- `07_source-index.md`