研究规范 v1.0
项目：5v5 腰旗橄榄球训练体系研究（
~/Documents/研究报告/flag-football-5v5） 生效：2026-11-01 ｜ 维护：本项目负责人 ｜ 变更须记入 §11 变更日志
1 定位与适用范围
本项目做的是可训练性研究，不是文献综述。判定标准只有一条：
每条结论都必须能被翻译成「谁、在什么位置、做什么动作、练几组、怎么算达标」。
不满足这条的内容，只能进 02-笔记/ 当过程材料，不能进 03-产出/ 和 04-知识库/。
适用范围：5v5 腰旗橄榄球（IFAF / NFL FLAG 两套规则并行），成人及高中业余竞技水平。
2 研究流程与关卡
| 阶段 | 做什么 | 产物 | 关卡 |
|---|---|---|---|
| P0 立项 | 定研究问题、边界、交付物、验收标准 | 立项卡（§12 模板） | G0 |
| P1 语料普查 | 元数据层抓取、去重、分类、可复现 | 01-语料/ |
G1 |
| P2 证据提取 | 字幕/关键帧/规则原文，逐字引文 + 快照 | evidence/ + 02-笔记/ |
— |
| P3 结构化 | 原子知识卡 + 手册章节 | 04-知识库/ + 03-产出/ |
G2 |
| P4 交付 | 手册定稿、测试方案、复盘 | 03-产出/（v1.0） |
G3 |
关卡判据
- G0 立项：问题能被证据回答（不是「腰旗怎么练」这种无边界的问法）；边界写清不研究什么；验收可测。
- G1 大纲：章节能覆盖问题；语料量够撑起每章（每章 ≥ 3 条独立来源）；缺口显式列出。
- G2 初稿：随机抽 ≥ 30% 的结论回溯到证据编号，全部可打开；数字复算一致；推算与实测分开写。
- G3 定稿：§10 检查表全过；换人/换模型复核一遍无重大异议；缺口与限制写进正文而非藏在脚注。
大课题的会审按既有流程走：多角色独立审阅 → 交叉回应 → 漏洞审核 → 跨模型复审（见技能
multi-expert-review、agy-gemini-review）。
3 证据分级与采信门槛
| 级别 | 证据类型 | 能支撑什么 | 采信门槛 |
|---|---|---|---|
| L0 | 官方规则书、协会技术手册（IFAF / NFL FLAG / USA Football） | 规则约束、场地尺寸、计时、犯规 | 须附条文号 + 原文快照 |
| L1 | 官方教练频道/课程（NFL FLAG、IFAF Classroom、MOJO 教案） | 技术要点、drill 组织 | 1 源可用；涉及"最优/必须"须 2 源 |
| L2 | 高播放教练频道（≥10 万播放，如 Coach D、Flag Football Academy） | 技术细节、纠错点 | 须双源互证，或与 L0/L1 一致 |
| L3 | 单一视频、个人观点、论坛 | 假设与线索 | 只能写进 02-笔记/，禁止直接成结论 |
| L4 | 本项目推断、通用训练学类比 | 参数取值（组次、距离） | 必须显式标「推断」，并给验证方式 |
三条硬规则
- 未经 L0/L1 确认的数字（7 秒、码数、人数）不得写成事实，只能写「按 XX 规则」并附来源。
- 同一结论的多个来源若互相矛盾，两个都写出来，注明适用条件，不做平均数。
- 视频标题级信息（只有标题、播放量、时长）算「元数据证据」，只能证明该主题被讨论过，不能证明其技术内容。
4 引文与数字规范
- 逐字引文：英文 ≤ 25 词、中文 ≤ 40 字，附
mm:ss时间戳、URL、抓取日期、快照路径。 - 转述：保留全部限定词（"up to"、"in our experience"、"for youth"），不得升级为绝对判断。
- 数字三件套：口径（谁的统计）+ 分母（多少条）+ 日期（何时抓取）。例：
445 条腰旗相关视频（分母 731，2026-11-01 抓取）。 - 不可复现的数字不进正文：只写在
02-笔记/，标注来源不可得。
5 目录职责与写权限
| 目录 | 装什么 | 写权限 | 生命周期 |
|---|---|---|---|
01-语料/ |
原始抓取（json）、去重清单、语料说明 | 脚本可写，人工不改 | 长期只增 |
02-笔记/ |
拆片笔记、对照表、假设、草稿 | 自由写 | 可废弃，进 99-归档/ |
03-产出/ |
大纲、手册、报告、卡片册 | 受控（带版本号） | 版本迭代，旧版归档 |
04-知识库/ |
原子知识卡、术语表、drill 库、索引 | 受控（一卡一结论） | 持续维护 |
evidence/ |
引文台账、原文快照、抓取日志 | 只追加，不修改不删除 | 永久 |
scripts/ |
抓取、统计、检索脚本 | 自由写，须可跑通 | 长期 |
99-归档/ |
废弃稿、旧版本、过期语料 | 只读 | 冻结 |
规则：产出可删改，证据不可删改。证据要更正就追加一条 EV-xxx-r2 并注明取代关系。
6 命名规范
| 对象 | 格式 | 例 |
|---|---|---|
| 目录 | NN-中文名 |
04-知识库 |
| 产出 | <类型>-<主题>-v<主>.<次>.md |
训练手册-分板块-位置技术-v1.0.md |
| 定稿 | 同上 + -final |
...-v1.0-final.md |
| 知识卡 | 卡-<短名>.md（≤ 12 字） |
卡-拔旗追角.md |
| 证据 | EV-<三位序号>-<短名> |
EV-001-ifaf-rulebook-blitz |
| 快照 | 同编号 + 扩展名 | EV-001.html |
| 日期 | YYYY-MM-DD |
2026-11-01 |
禁用：最新、最终版2、副本、新建文档、空格与全角标点在文件名中。
7 版本与变更
v0.x= 迭代稿；v1.0= 定稿；定稿后改内容升次版本（v1.1），改结构升主版本（v2.0）。- 每次实质改动在文末变更日志写三行：改了什么 / 为什么 / 影响哪些章节。
- 数字变更必须回指证据编号；无编号的数字变更视为未完成。
- 定稿冻结：
03-产出/内旧版移入99-归档/，保留原文件名加-archived-YYYY-MM-DD。
8 写作规范
- 结论先行：每节第一句给结论，后面才是依据。
- 口径分离：规则要求 / 教练经验 / 本项目推断，三者用不同措辞，不混写。
- 可执行：动作要点写角度、距离、秒数、组次；写不出参数的，标「参数待定」。
- 不夸大：不用「最有效」「唯一正确」「专业级」，除非有对照数据。
- 缺口显式：写「本版未验证」，不写成模糊的「有待进一步研究」。
- 中文表达：术语首现给中英对照（见
04-知识库/术语表.md），此后统一用中文。
9 AI 协作规范
- 派单必须含：目标 / 边界 / 输入路径 / 输出路径 / 验收标准 / 禁改范围。
- AI 产出一律视为草稿，须证据回溯后才能进
03-产出/。 - 禁止以「看起来合理」替代核证；无法核证的写「未核证推断」。
- 派单与产出记录进
evidence/派单记录.md（任务、模型、产出路径、验收结论）。 - 生成内容的数字若来自模型而非语料，按 L4 处理。
10 质量检查表（G3 前逐项勾）
- [ ] 每个结论有来源或明确标「推断」
- [ ] 所有规则数字附条文/来源，标了规则版本
- [ ] 抽查 30% 结论能回溯到
evidence/编号 - [ ] 语料统计可一键复现（
scripts/跑通，数字一致） - [ ] 两套规则差异处均有
【规则分叉】标记 - [ ] 训练参数给出组次/距离/时长，写不出者标「参数待定」
- [ ] 缺口与限制写在正文，不在脚注
- [ ] 术语中英对照齐全，全文用词一致
- [ ] 变更日志完整，旧版已归档
- [ ] 索引（
04-知识库/索引.md）与实际文件一致
11 变更日志
| 日期 | 版本 | 改了什么 | 为什么 |
|---|---|---|---|
| 2026-11-01 | v1.0 | 建立规范：五阶段流程、L0–L4 证据分级、目录职责、命名、关卡与检查表 | 项目从散稿转为可维护研究体系 |
12 模板清单
| 模板 | 路径 | 用途 |
|---|---|---|
| 立项卡 | 规范/模板/模板-立项卡.md |
P0 阶段，一页说清问题与验收 |
| 研究大纲 | 规范/模板/模板-研究大纲.md |
P1 产出，章节 + 来源 + 缺口 |
| 知识卡 | 规范/模板/模板-知识卡.md |
P3 原子结论，进 04-知识库/ |
| 证据台账 | 规范/模板/模板-证据台账.md |
引文与快照登记 |
| 拆片笔记 | 规范/模板/模板-拆片笔记.md |
单条视频/单篇文章的结构化摘录 |
知识库规范 v1.0
知识库位置：
04-知识库/｜ 上游：01-语料/、02-笔记/、evidence/｜ 下游：03-产出/配套：规范/研究规范.md（证据分级在此沿用，不另立标准）
1 三层结构
01-语料/ 元数据层：731 条视频、标题、播放、时长、tag ← 只证明「被讨论过」
↓ 拆片
02-笔记/ 过程层：单条视频的结构化摘录、对照表、假设 ← 可以是错的
↓ 提纯
04-知识库/ 结论层：一卡一结论，带证据等级与出处 ← 只放能站住的
↓ 使用
03-产出/ 交付层：手册、报告、卡片册 ← 引用卡片，不直接引笔记
铁律：产出只能引卡片（卡-*）或证据（EV-*），不能引笔记里的临时判断。
2 卡片字段（必填，缺一不进库）
---
id: 卡-拔旗追角
标题: 拔旗的第一原则是追角，不是追人
一句话: 逼近角度决定成败，速度只决定余量
证据等级: L1
状态: 待核
适用规则: IFAF 5v5 / NFL FLAG 通用
标签: [防守, 拔旗, 通用技术]
来源: [EV-004, EV-011]
指向: 03-产出/训练手册-分板块-位置技术-v1.0.md §13
更新: 2026-11-01
---
| 字段 | 规则 |
|---|---|
id |
与文件名一致，卡- 开头，≤ 12 字 |
标题 |
一句可被反驳的断言，不写「关于……的说明」 |
一句话 |
≤ 30 字，卡片的核心判据 |
证据等级 |
L0–L4（见研究规范 §3），只填实际达到的最高级 |
状态 |
已核 / 待核 / 推断 三选一 |
适用规则 |
规则分叉必须写明；通用则写「通用」 |
标签 |
从 §4 受控词表取值，3–6 个 |
来源 |
证据编号列表，至少 1 个；L4 可空但须写「无外部来源」 |
指向 |
被哪份产出的哪一节使用，便于反查 |
更新 |
最后实质修改日期 |
3 粒度与长度
- 一卡一结论：卡片必须能被单独反驳。出现「并且/另外/同时」串三个结论时拆卡。
- 长度 ≤ 60 行；超过说明该拆。
- 必须有判据：数字、距离、秒数、组次、或可观察的判定标准（如「髋部低于肩」）。
- 必须有反例：常见误读或失效条件。没有反例的卡视为未想清楚。
4 标签受控词表
只从下表取词，新增须在 索引.md 登记后再用：
| 维度 | 取值 |
|---|---|
| 大类 | 进攻 防守 规则 训练法 体能 评估 |
| 位置 | QB C WR RB Rusher LB CB S 全位置 |
| 技术 | 传球 接球 路线 开球 交接 挡位 冲传 盯人 区域 拔旗 追角 护旗 |
| 规则 | 7秒 无跑区 突袭 合法接触 场地 |
| 证据 | L0 L1 L2 L3 L4 待核 |
5 状态流转
推断 ──补证据──> 待核 ──逐字核证──> 已核
↑ │ │
└──证据失效───────┴──────────────────┘
- 只有
已核的卡片可以支撑产出里的「必须/最优」类表述。 待核支撑「通常/建议」类表述，正文须标「待核」。推断只支撑「本方案取值」，正文须标「推断」。
6 索引与检索
04-知识库/索引.md 是唯一入口，三张表：按板块、按位置、待核清单。
检索：
scripts/kb.sh 关键词 # 全文（卡片 + 产出）
scripts/kb.sh -t 拔旗 # 按标签
scripts/kb.sh -s 待核 # 按状态
scripts/kb.sh -l # 列全部卡片及状态
根库检索（跨项目）：~/Documents/研究报告/kb_search.sh 关键词，默认跳过 evidence/。
7 维护节奏
| 频率 | 动作 |
|---|---|
| 每次新增产出 | 补卡（新结论）+ 更新 指向 字段 |
| 每次核证 | 卡状态升级 + 证据台账补条目 + 索引同步 |
| 每月 | 扫「待核清单」，处理过期项；合并重复卡；废弃卡移入 99-归档/ |
| 每版定稿 | 全库对账：卡片数、索引行数、产出引用是否全部存在 |
8 质量红线
- 无来源、无判据的卡不入库。
- 同一结论多个来源矛盾时，卡内并列写出，不取平均。
- 卡片不得复制产出原文超过 3 行（避免双份维护）。
- 索引与实际文件不一致时，以文件为准并立刻修索引。
- 任何「专业/权威/最有效」类措辞，须有 L0/L1 支撑，否则删。