| | |
|---|
| | | # 实验设计模版 |
|---|
| | | # 实验设计 |
|---|
| | | |
|---|
| | | 创建人员：<填写创建人员或 AI> |
|---|
| | | 文件职责：记录项目内所有实验的设计、步骤、依赖、产物、判定标准、设计审核和执行结果回填；对应管理系统里的事项计划账本。 |
|---|
| | | 管理规范/模板：common/exp-doc/实验规范.md；本文件由 common/exp-doc/实验设计模版.md 实例化。 |
|---|
| | | 引用文件：<填写实验总纲、实验执行日志、实验审计报告、实验存储体系、来源聊天记录或上游文档> |
|---|
| | | 创建人员：management.admin |
|---|
| | | 文件职责：记录 `project-info` 项目实验设计、步骤、依赖、产物和判定标准。 |
|---|
| | | 管理规范/模板：../../common/exp-doc/实验设计模版.md；../../common/exp-doc/实验环境创建指南.md。 |
|---|
| | | 引用文件：实验规范.md；实验总纲.md；实验执行日志.md；实验审计报告.md；实验存储体系.md。 |
|---|
| | | 记录方式：append-only 设计账本；设计审核通过后才能执行正式实验。 |
|---|
| | | |
|---|
| | | ## 0. 当前设计总览 |
|---|
| | | ## 实验设计：EXP-SMOKE-001 |
|---|
| | | |
|---|
| | | > 本节用于快速查看当前正在推进的实验设计，可以随最新进展更新；详细设计记录仍必须追加到文件末尾。 |
|---|
| | | - 所属实验：EXP-SMOKE-001 / 实验体系初始化 dry-run |
|---|
| | | - 设计人员：management.admin |
|---|
| | | - 创建时间：2026-06-25T20:55:00+08:00 |
|---|
| | | - 当前状态：待审核员复核 |
|---|
| | | |
|---|
| | | - 当前最新设计：<设计 ID / 实验事项 ID / 状态> |
|---|
| | | - 当前可执行设计：<设计 ID 列表；必须已通过设计审核> |
|---|
| | | - 当前阻断设计：<设计 ID / 阻断原因> |
|---|
| | | - 当前下一步：<设计修订/等待审核/进入执行/暂停> |
|---|
| | | ### 目标和边界 |
|---|
| | | |
|---|
| | | ## 0A. 文档定位和证据索引职责 |
|---|
| | | - 目标：验证项目实验体系环境能从总纲追到设计、执行日志和审计报告。 |
|---|
| | | - 边界：不查询真实数据库、不读取 K 线、不生成统计结果包、不产生业务结论。 |
|---|
| | | |
|---|
| | | - 本文件是项目内具体实验设计与证据索引主入口。 |
|---|
| | | - 它负责回答：每个实验想解决什么问题、怎么验证、当前状态是什么、关键证据和结果包在哪里。 |
|---|
| | | - 实验总纲回答“为什么做和最后怎么读”；实验设计回答“具体怎么做、证据在哪里、结果包是什么”。 |
|---|
| | | - 后续新增实验、修订实验边界、回填执行结果，都应追加到本文件末尾，不得覆盖历史设计。 |
|---|
| | | ### 检查项 |
|---|
| | | |
|---|
| | | ## 1. 固定设计口径 |
|---|
| | | 1. `exp-doc/` 下基础文档存在，且每个文档包含创建人员、文件职责、管理规范/模板、引用文件、记录方式。 |
|---|
| | | 2. `exp-data/raw/`、`exp-data/result/`、`exp-data/img/`、`exp-data/tmp/` 存在，并通过 `.gitkeep` 保证 Git 克隆后目录保留。 |
|---|
| | | 3. 本地规范和审计规范引用 common 规范，并声明不得削弱 common 硬约束。 |
|---|
| | | 4. `实验存储体系.md` 写清正式结果包、图片、readout、manifest、intermediate 和 tmp 禁止事项。 |
|---|
| | | 5. 项目配置清单和 `mbx.project.yaml` 已登记实验体系目录、文档和角色。 |
|---|
| | | |
|---|
| | | - 维护方式：append-only；新设计、新修订、新执行回填追加到文件末尾，最新内容在最后。 |
|---|
| | | - 旧设计处理：不得删除；若失效，追加“失效/降读/被替代”说明。 |
|---|
| | | - 设计与计划合并：本文件同时记录“要怎么验证”和“按什么步骤执行”。 |
|---|
| | | - 设计审核要求：设计审核通过后才能执行；未通过则追加修订块，不覆盖旧设计。 |
|---|
| | | - 路径规则：项目内文件默认使用相对路径。 |
|---|
| | | ### PASS / FAIL / HELD |
|---|
| | | |
|---|
| | | ## 2. 实验设计追加区 |
|---|
| | | |
|---|
| | | > 从这里开始按时间顺序追加。结构尽量像可执行计划，不要写成厚重需求文档。 |
|---|
| | | > 每个实验设计块必须能回答：为什么这样跑、用什么数据、怎么判定、产物在哪里、审核状态是什么。 |
|---|
| | | |
|---|
| | | ## <YYYY-MM-DD> <设计 ID>：<实验名称> |
|---|
| | | |
|---|
| | | - 所属实验事项：<实验事项 ID / 名称> |
|---|
| | | - 创建人员：<填写> |
|---|
| | | - 创建时间：<YYYY-MM-DD HH:mm:ss> |
|---|
| | | - 当前状态：<设计中/待设计审核/设计审核通过/执行中/完成/暂停/取消> |
|---|
| | | - 当前结论：<当前阶段结论> |
|---|
| | | - 来源聊天记录：<引用实验总纲中的关键聊天记录；如无说明原因> |
|---|
| | | |
|---|
| | | ### 当前约定 |
|---|
| | | |
|---|
| | | - 本轮要验证：<核心问题> |
|---|
| | | - 本轮不验证：<排除范围> |
|---|
| | | - 与来源聊天要求的一致性：<逐条说明如何承接用户要求> |
|---|
| | | - 前置依赖：<前序实验、数据、文档、人工反馈> |
|---|
| | | |
|---|
| | | ### 实验方法和样本 |
|---|
| | | |
|---|
| | | - 核心假设：<填写> |
|---|
| | | - 数据源：<数据路径、表、接口、版本> |
|---|
| | | - 样本范围：<时间、对象、过滤条件> |
|---|
| | | - 实验组：<如何构造> |
|---|
| | | - 对照组：<如何构造；如不需要，说明原因> |
|---|
| | | - 边界样本：<容易误判或需要专门观察的样本> |
|---|
| | | - 防偏差要求：<样本污染、源数据切换、口径替换等> |
|---|
| | | - 是否需要防未来函数：<是/否/不适用> |
|---|
| | | - 判断理由：<根据实验目标说明为什么需要或不需要> |
|---|
| | | |
|---|
| | | ### 执行顺序 |
|---|
| | | |
|---|
| | | 1. <步骤 ID>：<步骤名称；输入；输出；判定> |
|---|
| | | 2. <步骤 ID>：<步骤名称；输入；输出；判定> |
|---|
| | | 3. <步骤 ID>：<步骤名称；输入；输出；判定> |
|---|
| | | |
|---|
| | | ### 字段、指标和状态 |
|---|
| | | |
|---|
| | | | 名称 | 类型 | 定义 | 来源 | 计算/判定口径 | 输出位置 | 备注 | |
|---|
| | | |---|---|---|---|---|---|---| |
|---|
| | | | <字段/状态/指标> | <字段/状态/指标> | <填写> | <输入表/脚本/人工/外部> | <填写> | <结果包/summary/readout> | <可为空> | |
|---|
| | | |
|---|
| | | ### 输出产物 |
|---|
| | | |
|---|
| | | - 结果包目录：<路径> |
|---|
| | | - 核心输出表：<路径/文件名> |
|---|
| | | - 核心图表：<路径/文件名> |
|---|
| | | - summary/readout：<路径/文件名> |
|---|
| | | - manifest/输入快照：<路径/文件名> |
|---|
| | | - 执行日志：`实验执行日志.md` 中 <run_id / 小节标题> |
|---|
| | | |
|---|
| | | ### 判定标准 |
|---|
| | | |
|---|
| | | - PASS：<什么结果算通过> |
|---|
| | | - FAIL：<什么结果算失败> |
|---|
| | | - HELD：<什么情况下只能暂挂，不能判断> |
|---|
| | | - 降读规则：<结果不充分时如何降读> |
|---|
| | | - 停止或转向条件：<什么情况下不继续跑，改为补数据/改设计/暂停> |
|---|
| | | |
|---|
| | | ### 风险和不做事项 |
|---|
| | | |
|---|
| | | - 关键风险：<样本不足、口径不稳、源数据缺失、计算成本高、人工审核未回收等> |
|---|
| | | - 阻断项：<没有这些就不能继续的前置条件> |
|---|
| | | - 可接受缺口：<不影响本轮目标的小缺口> |
|---|
| | | - 本轮不做：<明确不做的事情> |
|---|
| | | |
|---|
| | | ### 设计审核 |
|---|
| | | |
|---|
| | | - 设计审核状态：<待审核/通过/未通过> |
|---|
| | | - 审核人：<填写> |
|---|
| | | - 审核时间：<YYYY-MM-DD HH:mm:ss> |
|---|
| | | - 审核结论：<填写> |
|---|
| | | - 未通过问题：<如无填写无> |
|---|
| | | - 复审记录：<路径或摘要> |
|---|
| | | |
|---|
| | | ### 执行结果回填 |
|---|
| | | |
|---|
| | | - run_id：<填写；未执行则待补> |
|---|
| | | - 结果包：<路径；未执行则待补> |
|---|
| | | - 关键结果：<摘要> |
|---|
| | | - 当前读法：<PASS/FAIL/HELD/降读/失效> |
|---|
| | | - 是否纳入实验总纲结论：<是/否；说明> |
|---|
| | | - PASS：上述检查项全部满足，且审核员确认没有旧项目业务内容混入。 |
|---|
| | | - FAIL：基础文档缺失、目录缺失、规范冲突、审计入口错误或混入其他项目结论。 |
|---|
| | | - HELD：需要人类确认项目范围或审核员无法读取必要文档。 |
|---|
