my-vault/01_Projects/Personal-Tech/LLM_Evaluation/03-Practice/README.md

type, tags, status, created

type	tags	status	created
hub	llm-evaluation project-practice	active	2026-08-21

项目实践入口

这里用于放实际 Eval 项目，而不是继续积累理论笔记。学习材料告诉你“为什么”和“怎么做”（02-Why-Guide、01-LLM-Evaluation-Roadmap）；项目目录保存你亲自得到的证据。

项目列表

项目	状态	代码仓库	最近更新	一句话
（暂无——从 [[02-First-Week-Worksheet	首周工作表]] 开始，复制 [[01_Projects/Personal-Tech/LLM_Evaluation/03-Practice/_template/00-项目概览	_template/]] 建立第一个项目）

建议的第一批项目

按以下顺序推进。先完成一个小型、可重跑的闭环，再增加框架和自动化：

1. rag-eval-lab/ — 公开技术文档约束问答
2. agent-tool-eval/ — 模拟工具调用、权限与状态
3. code-agent-eval/ — 编译、测试、静态分析与回归

每个项目复制 [[01_Projects/Personal-Tech/LLM_Evaluation/03-Practice/_template/00-项目概览|_template/ 骨架]]（6 个文件）即可开始；骨架内的引导说明引用了工作表与路线图，不重复内容。

每个项目创建独立子目录，例如：

03-Practice/
└── 2026-我的第一个公开文档问答评测/
    ├── 00-项目概览.md
    ├── 01-任务与Rubric.md
    ├── 02-Case设计.md
    ├── 03-运行与盲评.md
    ├── 04-失败复盘.md
    └── 05-变更与回归.md

每个项目至少保留：

task.md
datasets/
rubrics/
runs/
scripts/
reports/

Obsidian 模板 ↔ 代码仓库目录 对照

同一份项目内容在 Obsidian（判断与决策）与代码仓库（可运行事实）中各存一份，对应关系如下：

工作表 / 模板（Obsidian 项目目录）	代码仓库目录（路线图 §4 的 llm-eval-lab/ 结构）
00-项目概览.md + 01-任务与Rubric.md	task.md + rubrics/
02-Case设计.md	datasets/（冻结的 eval 定义，JSONL）
03-运行与盲评.md	runs/（原始输出 + 盲评记录）
04-失败复盘.md	reports/（确认的失败入 datasets/regression/）
05-变更与回归.md	scripts/（validate / eval）+ CI 配置

为什么笔记和数据要分开

这个 Obsidian 专区保存思考与决策；代码仓库保存 JSONL、脚本和原始运行输出。两边互相链接即可：

放在 Obsidian 项目目录	放在代码仓库
为什么选这个题、成功条件、设计取舍	datasets/、runs/、scripts/、原始输出
rubric 的修改理由	可执行 schema 与校验脚本
失败模式、实验结论、下一个假设	机器生成报告、日志与图表
项目复盘、作品展示文字	README、依赖、CI 配置

原则： Obsidian 是你的“工程判断日志”，代码仓库是你的“可运行事实”。不要让任何一边替代另一边。

每个项目都要回答的五个问题

1. 用户想完成什么任务？
2. 什么情况算成功，什么情况算失败？
3. 你故意设计了哪些边界或负例？
4. 最常见的失败在哪里，为什么？
5. 修改后，你如何证明没有破坏原有能力？

项目模板

新项目的 00-项目概览.md 直接复制 _template/00-项目概览.md（骨架见 [[01_Projects/Personal-Tech/LLM_Evaluation/03-Practice/_template/00-项目概览|_template/]]）；本页不再内嵌模板副本，避免与模板文件漂移。

开始前

先完成 02-First-Week-Worksheet，再建立你的第一个项目目录。

---

返回 01_Projects/Personal-Tech/LLM_Evaluation/README。