# Prompt 库使用说明

本目录存放 Book 3 各章配套的**阶段 Prompt**：每个文件是一段可以独立复制给 Coding Agent 的完整任务书，与书中章节一一对应。Prompt 只约定方法主线、输入输出与验收口径，不绑定任何具体数据集——占位符由你在使用前替换。

## 使用方式

1. **复制**：按任务打开对应文件，整段复制；
2. **替换占位符**：把 `<数据路径>`、`<结局变量>`、`<正类>`、`<训练比例>`、`<折数>` 等替换为项目的实际值；文件内所有 `<...>` 都必须替换，没有可留空的占位符；
3. **交给 Agent 执行**：将替换后的全文作为任务说明发给 Coding Agent；
4. **按"验收"节核对**：Agent 完成后，逐项对照该文件的"验收"清单检查产物；命中"暂停条件"时由你决定后再继续。

每个 Prompt 都逐字包含以下执行指令，含义是：Agent 先列计划但不等你二次确认，只有冲突或命中暂停条件才停——

> 先检查输入并给出简要计划，然后继续执行指定任务；不要在计划后等待用户再次确认。只有输入冲突、字典冲突、必须改变方法或命中暂停条件时停止。

## 六文件索引

| 文件 | 对应章节 | 覆盖任务 |
|---|---|---|
| [01_数据读取与核查.md](01_数据读取与核查.md) | 第2章 | 加载数据、建行 ID、确认结局与正类、数据字典、数据画像、缺失概览、原始快照只读 |
| [02_清理Table1与划分.md](02_清理Table1与划分.md) | 第2章 | 类型与编码核查、清理日志、Table 1、分层固定划分、split/fold 成员清单、冻结测试集 |
| [03_LASSO与Logistic.md](03_LASSO与Logistic.md) | 第3章 | 训练集内 LASSO 筛选、映射原始变量、Logistic 无惩罚重拟合、OR/CI、Nomogram |
| [04_完整内部验证.md](04_完整内部验证.md) | 第4章 | 折内独立重学的完整流程内部验证、OOF 预测、ROC/校准/DCA、逐折选变量审计 |
| [05_ML比较与最终测试.md](05_ML比较与最终测试.md) | 第5章 | 多模型同折比较、选模记录、先锁后测、Holdout Test 一次性评价 |
| [06_Python迁移.md](06_Python迁移.md) | 第6章 | Python 读取 R 导出的成员与特征契约、Pipeline 内预处理、带行 ID 的预测、记录实现差异 |

## 方法主线（六个文件共同遵守）

- 建模主线：LASSO（lambda.min）筛选 → 非零项映射回原始变量 → Logistic 无惩罚重拟合；
- 内部验证：每个 outer fold 内独立重学插补、编码、标准化与变量集合，严禁全训练集先筛变量再做 CV；
- 最终测试：先锁定（模型、配置、阈值、理由）再接触测试集，测试集只评价一次，测后不返回选优；
- Python 迁移：成员与 fold 一律读取 R 导出的 manifest，禁止重新划分、重建 fold 或重设种子抽样。

各阶段之间的产物通过文件交接（成员清单、特征契约、锁定配置），后一阶段的"数据说明"节会列出它要求的前序产物。占位符含义与示例取值可对照 `../Demo_R_Project/config/config.R`（Demo 的单一配置源）。