AI/ML 研究手册

主题

E - 全书级Artifact索引 ​

统一全书中的产物命名、建议路径、状态定义和人类/智能体交接规则

为什么需要这份索引 ​

如果这本书要同时服务人类研究者和智能体，就不能只告诉你“这一章应该做什么”，还必须告诉你：

  • 这一章会产出什么 artifact
  • artifact 的名字和最小字段是什么
  • 谁适合起草，谁必须复核
  • 下游章节会消费哪份产物

否则就会出现三类问题：

  • 人类读者把它当成泛泛方法建议
  • 智能体在不同章节发明不同的文件名和字段
  • 流程无法稳定串起来

这份附录就是全书的 artifact contract。

使用规则 ​

规则 1：一个 artifact 只承担一个主职责 ​

例如：

  • PAPER_TABLE.csv 负责结构化记录论文与 claim
  • NOVELTY_REPORT.md 负责 claim 级定位和风险判断
  • PILOT_LOG.csv 负责记录首轮实验信号与决策
  • RETROSPECTIVE.md 负责记录项目复盘和经验总结

不要把这些内容混在一个大笔记里。

规则 2：下游优先读取 reviewed 或 locked 版本 ​

如果某份 artifact 还只是智能体草稿，它不应被默认当作稳定输入。

规则 3：统一命名，优先使用固定后缀 ​

  • 表格：.csv
  • 决策和说明：.md
  • 程序消费数据：.json

规则 4：每份 artifact 都必须回答“谁来复核” ​

本书默认：

智能体可以起草和整理 artifact，但关键 artifact 进入下游主流程前必须经人复核。

生命周期状态 ​

建议所有 artifact 使用以下状态之一：

状态含义是否可作下游稳定输入
stub文件已创建，但内容基本为空否
working正在补充、修改中否
reviewed已经过人类复核，可供下游使用是
locked当前轮研究中冻结使用是
archived历史版本，仅保留追溯否

建议目录布局 ​

text
artifacts/
├── 01-scoping/
│   └── PROBLEM_NOTE.md
├── 02-literature/
│   ├── PAPER_TABLE.csv
│   ├── LITERATURE_MAP.md
│   ├── CONTRADICTION_LOG.md
│   └── OPEN_QUESTIONS.md
├── 03-ideas/
│   ├── IDEA_BACKLOG.csv
│   ├── IDEA_SCORECARD.md
│   ├── ELIMINATED_IDEAS.md
│   └── IDEA_REPORT.md
├── 04-novelty/
│   ├── CLOSEST_WORK_TABLE.csv
│   └── NOVELTY_REPORT.md
├── 05-experiments/
│   └── EXPERIMENT_PLAN.md
├── 06-pilot/
│   └── PILOT_LOG.csv
├── 07-analysis/
│   └── ANALYSIS_REPORT.md
├── 08-review-loop/
│   └── REVIEW_LOOP_LOG.md
├── 09-paper-plan/
│   ├── PAPER_PLAN.md
│   └── CLAIMS_EVIDENCE_MATRIX.csv
├── 10-figures/
│   └── FIGURE_SPEC.md
├── 11-writing/
│   └── CITATION_CHECK.md
├── 12-submission/
│   └── SUBMISSION_PACK.md
└── 13-retrospective/
    ├── RETROSPECTIVE.md
    └── ASSET_INDEX.md

目录名不是关键，关键是：

  • artifact 可定位
  • 状态可追踪
  • 交接边界清晰

Artifact 索引表 ​

说明：

  • 当前状态 = stable 表示对应章节已按这份 contract 重写完成
  • 当前状态 = provisional 表示 contract 已定义，正文仍待完全对齐
Artifact建议路径主要生产章节主要用途最低必填字段起草方人类必审点下游消费当前状态
PROBLEM_NOTE.mdartifacts/01-scoping/01定义研究问题、边界和 kill condition，不绑定具体解法question, motivation, testable_hypothesis, boundary, non_goals, kill_conditionHuman 或 Agent问题是否重要且可测，且未过早绑定方法02, 03, 04stable
PAPER_TABLE.csvartifacts/02-literature/02结构化记录论文、claim、证据和限制paper, year, venue, core_claim, evidence, relevance, confidenceAgent 初整 + Human 校正claim 是否与原文一致03, 04, 11stable
LITERATURE_MAP.mdartifacts/02-literature/02组织领域图谱和方法簇method_clusters, consensus, disagreements, positioningAgent 初稿 + Human 定稿分组是否合理03, 09stable
CONTRADICTION_LOG.mdartifacts/02-literature/02记录冲突结论和待核查原因issue, claim_a, claim_b, suspected_reason, next_checkHuman 主导冲突是否真实存在03, 07stable
OPEN_QUESTIONS.mdartifacts/02-literature/02记录未解决问题和潜在机会question, why_unresolved, why_it_matters, possible_experimentHuman 或 Agent问题是否值得继续03, 04stable
IDEA_BACKLOG.csvartifacts/03-ideas/03围绕同一问题的候选解法池idea_id, linked_problem, title, method_sketch, intervention_point, source, mve, risk, statusAgent 扩展 + Human 筛选是否真的在回答同一个问题04, 05, 06stable
IDEA_SCORECARD.mdartifacts/03-ideas/03多维打分和保留理由scores, rationale, decisionAgent 初稿 + Human 决策打分是否反映真实优先级04, 08stable
ELIMINATED_IDEAS.mdartifacts/03-ideas/03记录被淘汰的 idea 和原因idea, elimination_reason, revisit_conditionHuman 主导淘汰是否合理06, 08stable
IDEA_REPORT.mdartifacts/03-ideas/03输出候选解法 shortlist 和执行顺序ranked_ideas, linked_problem, strongest_objection, next_actionsHuman 定稿top ideas 是否共享同一个问题定义04, 05, 06stable
CLOSEST_WORK_TABLE.csvartifacts/04-novelty/04记录每条 claim 的 closest workclaim_id, prior_work, overlap, difference, riskAgent 初整是否找全真正威胁项05, 11stable
NOVELTY_REPORT.mdartifacts/04-novelty/04claim 级 novelty 判断和定位claims, closest_work, overlap, difference, novelty_assessment, positioningAgent 初查 + Human 定位差异化是否站得住05, 08, 11stable
EXPERIMENT_PLAN.mdartifacts/05-experiments/05把 claim 变成实验计划hypothesis, baselines, datasets, metrics, success_criteria, budget, stop_rulesHuman 主导 + Agent 草拟计划是否足以回答问题06, 07, 08stable
PILOT_LOG.csvartifacts/06-pilot/06记录 pilot 配置、信号和决策idea_id, setup, runtime, metric, signal, decisionAgent 记录 + Human 判读signal 是否可信07, 08stable
ANALYSIS_REPORT.mdartifacts/07-analysis/07汇总 claim 状态、发现、异常和建议summary, key_findings, anomalies, recommendations, claim_statusAgent 初稿 + Human 解释是否过度解读08, 09, 11stable
REVIEW_LOOP_LOG.mdartifacts/08-review-loop/08记录每轮审稿、修复和结果round, verdict, issues, fixes, rerun_summary, statusAgent 记录 + Human 决策修复是否真正完成09, 11, 12stable
PAPER_PLAN.mdartifacts/09-paper-plan/09规划论文主张、结构和叙事title, target_venue, core_claims, section_plan, timelineHuman 主导 + Agent 整理叙事是否收敛10, 11, 12stable
CLAIMS_EVIDENCE_MATRIX.csvartifacts/09-paper-plan/09对齐 claim 与证据claim, evidence, location, statusHuman 主导每个 claim 是否有支撑10, 11stable
FIGURE_SPEC.mdartifacts/10-figures/10定义每张图要回答的问题和数据来源figure_id, question, source_data, plot_type, statusHuman 主导 + Agent 草拟图是否真正服务 claim11stable
CITATION_CHECK.mdartifacts/11-writing/11核对关键 claim 与引用支撑claim, citation, verification_status, notesAgent 初查 + Human 终审是否存在误引12stable
SUBMISSION_PACK.mdartifacts/12-submission/12投稿前最终检查与风险说明venue, checklist, rebuttal_readiness, final_risksHuman 主导是否达到可投状态13, 复盘stable
RETROSPECTIVE.mdartifacts/13-retrospective/13记录项目起点、终点、有效决策、误判和下一步建议project_snapshot, worked, failed, fragile, decision_review, next_actionsAgent 初稿 + Human 定稿教训是否真实、可复用下个项目, worked examplestable
ASSET_INDEX.mdartifacts/13-retrospective/13索引可复用 prompt、脚本、模板、checklist、失败案例和 skill 候选asset_name, type, source, reuse_rule, status, notesAgent 整理 + Human 筛选是否真的值得资产化下个项目, skill 提炼stable

推荐的交接规则 ​

Human -> Agent ​

最适合交给智能体的输入：

  • 已界定边界的问题定义
  • 已整理的论文表格和文献图谱
  • 已写明字段的 artifact 模板

Agent -> Human ​

最适合交还给人的输出：

  • 候选列表
  • 打分草稿
  • 初步对比表
  • 检索线索和引用核查结果
  • 资产候选清单和复盘草稿

Human 必须卡住的 6 个关键口 ​

  1. 问题值不值得做
  2. closest work 到底是谁
  3. claim 是否被证据真正支撑
  4. 异常和负结果是否被如实解释
  5. 是否达到可以投稿的状态
  6. 哪些经验值得制度化复用

一个可选的全局主链图（LaTeX/TikZ） ​

如果你想在首页或前言里放一张“全书级 artifact 流图”，可以直接使用下面的 LaTeX 代码：

Global artifact flow in this handbook. The workflow is shared by humans and agents, but key gates remain human-reviewed all the way through retrospective and assetization.
Global artifact flow in this handbook. The workflow is shared by humans and agents, but key gates remain human-reviewed all the way through retrospective and assetization.

使用时需要：

latex
\usepackage{tikz}
\usetikzlibrary{positioning,arrows.meta}

当前建议 ​

当前重写进度下：

  1. 01-13 已经显式接入这份索引表，对应 artifact 已升级为 stable
  2. 下一步最值得做的是用一个真实 AI/ML 项目跑通整条链，验证 worked example
  3. 之后可把 ASSET_INDEX.md 中最稳定的条目继续升格为正式 skill 或模板库

你可以把这份附录理解成“全书的 API 文档”：正文讲方法，附录 E 讲输入、输出和交接契约。