--- schema: online-okf-skill-1 okf_schema: online-okf-1 input_commit: c5d5d525765d54262237dd13b408f2b9590f67a3 concept_version: store_id: fcfd44a3-3b74-4077-bb28-54e09686ffaa epoch: 34e87bb1-94ae-473e-8819-8bf58ed5087f committed_seq: 16 export_revision: 5dd5494dac885d3f32508b96941a9afbe691461a46f932e9c6eff3502d419ded manifest_sha256: 2c391ade665ad6762fd98c8704681ca19509af6b3df612a3d2b8c65f2926dce7 generated_by: scripts/export_online_okf_pilot.py name: limbo137-okf-concept-lookup description: 概念跨书对比与依赖溯源规范 --- # 子 Skill:概念跨书对比与依赖溯源(`/okf/skills/concept-lookup.md`) 本 Skill 规定如何读取单概念 OKF 卡片 `https://limbo137.top/okf/concepts/.md` 并做跨书对比。 ## 1. 卡片 YAML 各字段的解读顺序 1. `concept_id`:跨书唯一身份 UUID;同一 UUID 才是“同一概念”,仅标题相同不算。 2. `labels`:`en` / `zh-CN` 首选术语;`aliases[]` 是带 `pos`、`condition` 的受限别名(条件必须一起引用)。 3. `books[].first_mentions`:该书已登记的**最早已登记位置**(`status: earliest-registered`),不等于全书首次出现,更不等于唯一出处。 4. `books[].positions`:全部已登记出现位置(`role` 可能是 `source-reviewed-definition`、`discussion` 等)。 5. `books[].definitions`:已审定义记录,带 `definition_id`、`evidence`(证据 id 列表)、`conditions` 与 `dependency_status`。 6. `books[].definition_candidates`:`review_status: provisional-unreviewed` 的**待审候选**,只能作为线索,不得冒充正式定义。 7. `dependency_groups`:同书同版、作者显式陈述的依赖(`kind: recorded-author-statement-dependencies`,`completeness: recorded-only`)。成员里的 `target_concept_ids` 为空时,表示该依赖尚未映射到概念身份,**不得自行跨书补链**。 8. `reading_paths` / 卡片正文中的“各书的首次出现与定义”:按书分节,`definition_status` 分 `recorded` / `mention` / `not-recorded`。 ## 2. 跨书对比的固定五步 1. 用 `q` 或 UUID 定位概念卡片,记录其 `concept_version` 与 `input_commit`; 2. 逐书列出 `definition_status` 与 `definitions[].conditions`; 3. 对 `mention` 的书,只引用其出现位置(`positions`),不要提炼成“该书定义”; 4. 对 `not-recorded` 的书,表述为“当前已登记入库范围未收录”,不得推断“原书没有”; 5. 需要完整证明时,跳到对应 `/okf/books////
.md` 小节文件,引用英文块。 ## 3. 术语匹配 - 中文模糊说法先映射到 `labels.zh-CN` / `aliases`,再落到 `en` 标准名;`/okf/search-index.json` 的 `norm_terms` 已包含标题内英文括注与别名。 - 同一英文词在本书系内可能有不同中文译名(如 contorsion tensor 与“扭度张量”),引用时同时给出 `en` 与中文别名。 ## 4. 禁止 - 不得把不同 UUID 的同名概念合并成一个“共识定义”; - 不得用 `dependency_groups` 之外的材料补出“前置知识顺序”; - 不得省略 `conditions` 中登记的 OCR 修正说明。