AGENTS.md · 给 LLM 的/wiki 维护规范

[!abstract] 本文件的作用这是schema 层：告诉 LLM 知识图谱长什么样、命名怎么定、每次 ingest / query / lint 该做什么。LLM 遵守它，才是"有纪律的 wiki 维护者"，不是通用聊天机器人。人负责找源、探索、提问题；wiki 的增删改全部由 LLM 做。

0. 根目录与三层

层	路径	谁改
L0 原始层	`raw/`（含 `raw/incoming/`，新源落点）	人放源，LLM 只增不改
L1 单页层	`wiki/<主题>/<中文标题>.md`	LLM
L2 索引层	`index.md`、`log.md`	LLM（ingest/lint 后必更新）
规范层	本文件 `AGENTS.md` + `SCHEMA.md`	人与 LLM 共同演化

1. 命名

页面文件名一律中文，取直观短标题，一眼看出内容（如 肠屏障.md 三年级滑坡.md 碘酒褪色误区.md）。禁止用英文 slug 或拼音。
例外：index.md、log.md 保留英文命名（依赖方与检索命令按此写）。
主题目录：菌群机制 菌群实体 儿童教育 还原水 跨域桥——五主题永不合并。
单个主题超过 1000 页才允许拆分，拆分前先与人类确认。

2. Markdown 语法（Obsidian 方言，必须遵守）

frontmatter 用 YAML，字段见 [[SCHEMA]]（title / aliases / tags / entity_type / topic / sources / created / updated / schema_version）。
互链用 [[页面名]]；跨层引用原文用文件链接 [[raw/microbiome/xxx.md|原文]] §锚点。
提示块用 callout：> [!note] > [!tip]+ > [!warning] > [!abstract] > [!danger]。
标签用 YAML tags: 列表（如 知识图谱 / 菌群机制 / 概念），正文少用 #内联标签。
表格用管道表；多条并列用 - bullet。
代码块 ``` 仅在给命令示例时用。

3. 页面六节（缺一不可）

## 摘要（≤2 句）→ ## 定义（边界+别名+英文原名）→ ## 关键论点（bullet，每条 ≤60 字）→ ## 证据 · 来源（来源链接+锚点）→ ## 关联（基础/对比/应用/同域）→ callout 表述分层（学员面通俗 + 专家面机制）。

[!warning] 单页目标 < 1500 字。子概念不足 200 字就并入父概念页，不单独建页。

4. 三条工作流

4.1 Ingest（收资料）

人类把新源放进 raw/incoming/，或明确说"处理这个源"。
跑 python "E:/cfc/知识库/wiki/scripts/ingest.py" --file <路径|--url <链接|--list，脚本会复制入库、抽正文写带 frontmatter 的 raw 原文、登记队列、追加 log。
LLM 先通读 raw 原文，与人类过一遍要点（不要一口气闷头写 10 页）。
建页或改页：新实体独立成页；已有实体则更新对应页的 ## 关键论点 与 ## 证据 · 来源，并补反链。
- 批量吸收已有 raw 语料用 python "E:/cfc/知识库/wiki/scripts/absorb_raw.py"（先看空跑结果，确认 APPEND 表里的映射，再 --apply）。它在 ## 关键论点 追加一句、在 ## 证据 · 来源 追加原文出处、把 raw 写进 frontmatter sources，幂等可重复跑。
- 自写句子时避开 A/B 类禁词，尤其注意语料标题本身含禁词（如某篇原名含「治疗」），引用时只取规范后的短标题。
更新 index.md：在对应主题的表格里加一行（链接 + 类型 + 一句话）。
追加 log.md 一条 ## [日期] ingest | 标题 + 改了哪几页。
收尾必须跑 python "E:/cfc/知识库/wiki/scripts/lint.py"，orphans / dangling / index_drift / sections / oversized / raw_unused 六项归零才算 ingest 完成。

4.2 Query（查知识）

先读 index.md 定位主题与候选页（不靠 embedding，靠索引 + 链接）。
需要精确定位跑 python "E:/cfc/知识库/wiki/scripts/query.py" --keyword 关键词 | --backlinks 页面名 | --related 页面名。
读页综合回答，每句结论都要带来源（[[页面名]] 与 [[raw/…]]）。
好答案回写成新页（对比表、分析、发现的关联），登记进 index.md，并追加 ## [日期] query | 问题 → 产出页。
答案若涉及健康/水功效主张，先用 [[证据分层总纲]] 定级、过 [[禁词表（对外零容忍）]]。

4.3 Lint（体检）

跑 python "E:/cfc/知识库/wiki/scripts/lint.py"（支持 --json），产出：孤儿页、悬空 wikilink、index 与页不一致、章节缺失/超长、提及但无独立页的概念、raw 未被利用、跨页矛盾候选。
LLM 逐条判定：矛盾写 矛盾清单.md（不得静默覆盖），其余按严重度修复。
修完重跑 lint 确认清零，追加 ## [日期] lint | 修了什么 / 仍待办。

5. 硬约束（红线）

禁词（出稿前必查，详见 [[禁词表（对外零容忍）]]）：
- A 医疗类：治疗、治愈、疗效、根治、痊愈、抢救、延年益寿、防癌、抗癌、治病、减停药物 —— 禁用；
- B 伪科学类：小分子团、小分子水、六角水、活化细胞、远红外、磁化水、能量水、信息水、量子水、功能水 —— 禁用；
- C 漏斗类（学员面禁）：引流、升单、钩子、转化、促单 —— 仅讲师备注/内部经营文档可出现；
- D 教育越界类：测评＝诊断、测评＝临床结论、用测评替代就医 —— 禁用。
证据分层：对外主张必须标层级；学员面材料只接受 L1–L2 级（随机对照/权威共识），L3 及以下只进讲师备注。菌群侧语料为厂商科普二手转述，专家层须回溯期刊原文。
跨域不互背书：菌群与还原水只在「氧化压力」概念层相交，因果层不相交，不得互为佐证。
解读与干预不得混岗：[[桥 4 · 测—读—改同构]] 只复用 SOP 结构，医学解读与教育干预分属持证主体。
对外零销售话术：学员面材料不得出现 [[禁词表（对外零容忍）]] C 类词与任何机构经营/分佣信息。

6. 规模与性能约定

当前规模：5 主题 / 67 页 / 60 份 raw。检索靠 index.md + 中文 wikilink + query.py，不上向量库。
单主题 > 1000 页，或 index.md 超 2000 行时，才引入 qmd 一类本地检索（BM25 + 重排）。
全部为 markdown + git，天然有版本历史；重大改版可开分支Review。

7. 相关

[[index]]（入口）、[[SCHEMA]]（字段与实体类型）、[[log]]（时间线）、[[统一术语表]]、[[证据分层总纲]]、[[知识资产盘点]]

AGENTS.md 6.6 KB Histórico Raw