From e87cfdcb76a359d217130b33ffb4ed917b64d230 Mon Sep 17 00:00:00 2001 From: 1 <wentingyear@gmail.com> Date: Thu, 25 Jun 2026 20:56:54 +0800 Subject: [PATCH] fix: rebuild project-info system documents --- exp-doc/实验总纲.md | 114 ++++++++++++--------------------------------------------- 1 files changed, 24 insertions(+), 90 deletions(-) diff --git "a/exp-doc/\345\256\236\351\252\214\346\200\273\347\272\262.md" "b/exp-doc/\345\256\236\351\252\214\346\200\273\347\272\262.md" index 0fcf649..7626c34 100644 --- "a/exp-doc/\345\256\236\351\252\214\346\200\273\347\272\262.md" +++ "b/exp-doc/\345\256\236\351\252\214\346\200\273\347\272\262.md" @@ -1,95 +1,29 @@ -# 实验总纲模版 +# 实验总纲 -创建人员：<填写创建人员或 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. 当前总览 +## 1. 当前总览 -> 本节用于人和 AI 快速进入当前状态，可以随最新进展更新；详细实验记录仍必须追加到文件末尾。 +| 实验 ID | 名称 | 状态 | 结论 | +|---|---|---|---| +| `EXP-SMOKE-001` | 实验体系初始化 dry-run | 已记录，待审核员复核 | 环境链路可承接实验事项；无真实业务结论 | -- 当前主线：<当前实验主线或研究方向> -- 当前最新实验：<实验事项 ID / 名称 / 状态> -- 当前有效结论：<只写已被结果和审核支持的结论> -- 当前阻断项：<无/待补数据/设计未审/执行未审/其他> -- 当前下一步：<下一步动作> -- 关键入口：<实验设计.md / 实验执行日志.md / 实验审计报告.md / 结果包索引> +## 2. 实验事项：EXP-SMOKE-001 -## 1. 固定口径和长期约定 - -- 项目名称：<填写项目名称> -- 项目路径：<相对路径或项目标识> -- 实验记录维护方式：append-only；新实验、新结论、新修订追加到文件末尾，最新内容在最后。 -- 历史记录处理：历史结论不得删除；如失效，追加“失效/降读/替代”说明并指向证据。 -- 路径规则：项目内文件默认使用相对路径；不要默认写本机绝对路径。 -- 关键来源聊天记录规则：用户原始要求或其可打开路径必须进入对应实验块的背景。 - -## 2. 实验记录追加区 - -> 从这里开始按时间顺序追加。不要把最新实验插到文件开头；不要为每个实验创建独立总纲文件。 -> 推荐结构参考长期滚动账本：背景 -> 目标 -> 设计入口 -> 结果入口 -> 关键结果 -> 当前读法 -> 下一步。 - -## <YYYY-MM-DD> <实验事项 ID>：<实验名称> - -- 创建人员：<填写> -- 创建时间：<YYYY-MM-DD HH:mm:ss> -- 当前状态：<未开始/设计中/待设计审核/设计审核通过/执行中/待执行审核/完成/暂停/取消> -- 当前结论：<未形成/阶段结论/完成结论> - -### 背景、由来和关键聊天记录 - -- 背景：<为什么要做> -- 由来：<来自哪个讨论、需求、方法论、前序实验或异常> -- 原理来源：<上游文档、案例、数据观察或聊天路径> -- 关键来源聊天记录：<粘贴最重要原文，或给出可直接打开的路径> -- 聊天要求摘要：<把用户要求压成要点，方便审核员对照> - -### 目标和边界 - -- 主目标：<本实验最核心要回答的问题> -- 次目标：<可选> -- 不属于本轮目标：<明确不验证什么> -- 数据边界：<数据范围、时间范围、样本范围> -- 方法边界：<本轮使用/不使用的方法> -- 结论边界：<本轮最多能说明什么> - -### 设计、执行和审计入口 - -- 实验设计：`实验设计.md` 中 <设计 ID / 小节标题> -- 执行日志：`实验执行日志.md` 中 <run_id / 小节标题> -- 设计审核：`实验审计报告.md` 中 <audit_id / 小节标题> -- 执行审核：`实验审计报告.md` 中 <audit_id / 小节标题> -- 非审计问题 / 审计问题索引：`实验问题记录.md` 中 <issue_id / 小节标题；如无填写无> - -### 结果包和关键证据入口 - -- 结果包：<路径> -- summary/readout：<路径> -- 核心表：<路径> -- 核心图或可视化证据：<路径> -- manifest/hash/输入快照：<路径> - -### 关键结果 - -- <关键指标 1>：<取值和读法> -- <关键指标 2>：<取值和读法> -- <关键异常或缺口>：<无/说明> - -### 当前读法 - -- 可以读成：<证据支持的结论> -- 不能读成：<防止过读> -- 降读/失效记录：<如无填写无；如有说明原因和替代结论> - -### 下一步 - -- 下一步动作：<继续实验/补数据/补对照/回写方法论/进入实现/暂停> -- 继续条件：<满足什么条件才继续> -- 停止条件：<满足什么条件必须停止或降级> - -### 结论回写 - -- 回写目标：<方法论/需求/代码/数据/下一轮实验/暂停说明> -- 回写内容：<填写> -- 回写状态：<待回写/已回写/不回写> +- 实验 ID：EXP-SMOKE-001 +- 实验名称：实验体系初始化 dry-run +- 创建人员：management.admin +- 创建时间：2026-06-25T20:55:00+08:00 +- 当前状态：待审核员复核 +- 背景：修复 `project-info` 初始创建时实验体系目录和本地文档未按创建指南完整落地的问题。 +- 目标：验证 `exp-doc/`、`exp-data/`、设计、执行日志、审计报告和问题记录之间能形成最小可追溯链路。 +- 边界：本事项不是股市业务实验，不查询数据库、不生成统计结果、不产生交易建议。 +- 设计入口：`exp-doc/实验设计.md#实验设计exp-smoke-001` +- 执行入口：`exp-doc/实验执行日志.md#2026-06-25-run-exp-smoke-001` +- 审计入口：`exp-doc/实验审计报告.md#2026-06-25-audit-exp-smoke-001` +- 结果包入口：无真实结果包；本事项为体系 dry-run。 +- 当前结论：本地文档和数据目录已补齐，仍需审核员确认是否满足 `common/exp-doc/实验环境创建指南.md`。 -- Gitblit v1.9.3