master-skill 0.10.1 → 0.11.0

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "master-skill",
       "description": "FoJin-powered Buddhist AI persona framework — source-grounded, boundary-aware, fidelity-tested, runtime-ready. 15 prebuilt masters across 印度/汉传/藏传/南传 plus compare, debate, and curriculum meta-skills.",
-      "version": "0.10.1",
+      "version": "0.11.0",
       "source": "./",
       "author": {
         "name": "xr843",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "master-skill",
   "description": "FoJin-powered Buddhist AI persona framework — source-grounded, boundary-aware, fidelity-tested, runtime-ready. 15 prebuilt masters across 印度/汉传/藏传/南传 plus compare, debate, and curriculum meta-skills.",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "author": {
     "name": "xr843",
     "email": "xr843@users.noreply.github.com"

package/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "master-skill",
   "displayName": "Master Skill",
   "description": "FoJin-powered Buddhist AI persona framework — source-grounded, boundary-aware, fidelity-tested, runtime-ready. 15 prebuilt masters across 印度/汉传/藏传/南传.",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "author": {
     "name": "xr843",
     "email": "xr843@users.noreply.github.com"

package/GEMINI.md

@@ -1,2 +1,2 @@
 @./SKILL.md
-@./prebuilt/compare/SKILL.md
+@./prebuilt/compare-masters/SKILL.md

package/README.md

@@ -148,7 +148,7 @@ Master-skill 是由 [FoJin](https://fojin.app) 驱动的佛教 AI 祖师人格
 - **渐进式披露**：SKILL.md 以决策树 + Quick Ref 为主，`references/`、`sources/` 按需加载，Context 随查随取
 - **HARD-GATE 铁律**：`/create-master` 与预置法师内置红线——教义断言、修行指导与文本解释必须引用该 persona 声明的来源（CBETA / BDRC / Toh / SuttaCentral / PTS / 合规编纂开示），不得捏造来源 ID，不得为虚构人物建角色
 - **二阶段独立审查**：生成管线在写入前强制经过"教义准确性 → 风格一致性"两轮独立审查，FAIL 自动修复最多 2 轮
-- **自动化保真度测试**：每位祖师 `tests/fidelity.jsonl` 10+ 条 Q&A（`compare-masters` 元技能 18 条），验证引用和关键词覆盖；CI 在每次推送时 dry-run 验证（结构校验）；实跑评分需 `ANTHROPIC_API_KEY`，作为本地/发版前手动步骤执行
+- **自动化保真度测试**：每位祖师 `tests/fidelity.jsonl` 10+ 条 Q&A（`compare-masters` 元技能 18 条），验证引用和关键词覆盖；CI 在每次推送时 dry-run 验证（结构校验）；实跑评分需 `ANTHROPIC_API_KEY`，作为本地/发版前手动步骤执行——首份[实测基线](#保真度基线首次实测)已提交：59/84 已测通过（70%），全量 211 条覆盖率 40%（详见 [eval/reports/](eval/reports/)）
 - **多平台统一插件**：Claude Code、Cursor、Codex CLI、OpenCode、Gemini CLI 共用一份 `prebuilt/`，session-start hook 跨平台注入法师列表
 - **NPX 一键安装**：`npx master-skill install master-zhiyi` 直接部署到 Claude Code
 - **离线工具链**：`scripts/cite.py`（CBETA 引用查询）、`scripts/query.py`（离线语义检索）、`scripts/validate.py`（frontmatter linter）
@@ -163,156 +163,51 @@ Master-skill 的核心不是"角色扮演提示词集合"，而是一个可验
 |---|---|
 | 有来源 | 每位祖师声明 `sources[]`、离线 excerpts、FoJin live fallback 与引用自审 |
 | 守边界 | `ETHICS.md`、每位祖师 Layer 0 HARD-GATE、版权 Tier 与教界越界报告机制 |
-| 可评测 | `tests/fidelity.jsonl`、persona-fidelity schema、promptfoo RAW / SPE / CUS 评测层 |
+| 可评测 | `tests/fidelity.jsonl`、persona-fidelity schema、promptfoo RAW / SPE / CUS 评测层，[实测基线见下](#保真度基线首次实测) |
 | 可运行 | `prebuilt/master-*` AgentSkills、npm CLI、多平台 hooks、FoJin runtime contract |
 
 后续 v1.0 路线以框架稳定为优先：见 [docs/v1-framework-roadmap.md](docs/v1-framework-roadmap.md) 与 [docs/fojin-runtime-contract.md](docs/fojin-runtime-contract.md)。
 
----
-
-## 开发者安装
-
-> 👤 **只是想体验？** 直接用 [fojin.app/chat](https://fojin.app/chat)，跳过下面的安装步骤。
-> 🛠️ **本节面向**：Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI 用户，希望在终端 AgentSkill 环境中直接调用 `/master-xuanzang` `/master-huineng` 等命令。
+### 保真度基线（首次实测）
 
-### 安装
+`tests/fidelity.jsonl` 曾经只是"存在的夹具"——`scripts/test-fidelity.py` 只打印到终端，仓库里从未提交过一次真实评分。2026-08-18 首次跑出并提交了这份基线（commit [`c697d5d`](https://github.com/xr843/Master-skill/commit/c697d5d3be78ce6738cf1f969ca057c7e4c16bb5)，模型 `claude-sonnet-4-6`）：
 
-**NPX 一键安装（推荐，无需常驻）**
-
-`npx master-skill install --all` 一次安装全部 19 个 Skill：15 位祖师、3 个教学模式，以及 `create-master` 生成器。`create-master` 会复制自包含的运行时，因此临时 npx 包目录被清理后仍可使用；重新安装或 `update --all` 会更新运行时，但保留 `create-master/masters/` 中用户生成的 persona。
-
-```bash
-# 安装指定祖师
-npx master-skill install master-zhiyi master-fazang master-huineng
-
-# 单独安装公共教学模式或自定义生成器
-npx master-skill install compare-masters
-npx master-skill install create-master
-
-# 安装全部 19 个 Skill
-npx master-skill install --all
-
-# 查看全部可安装 Skill
-npx master-skill list
-```
+| | 数值 |
+|---|---|
+| 已测通过 / 已测总数 | **59 / 84（70%）** |
+| 全量夹具覆盖率 | 84 / 211（40%）—— 运行途中 API 账户余额耗尽（HTTP 400），非限流也非代码缺陷，剩余 127 条**未测**，不计入失败 |
+| 真实失败聚集 | 关键词未覆盖 14/25；禁用词命中 12/25；引用缺失 5/25；虚构引用 0——**但该审计只在 84 条里的 6 条上真正运行过**，见下 |
+| 分测试类型 | 常规教理 43/48 = **89.6%**；守边界 12/26 = **46.2%**；抗压守引用 4/10 = **40.0%** —— 弱项是护栏，不是教理内容 |
+| ⚠️ 量具告警 | 12 条禁用词失败里有 **10 条，禁用词本就出现在提问中**（陷阱题），而检查是对回答做纯子串匹配——正确的驳斥与真正的越界会被同等判失败。**故真实值落在 70.2%–75.0%**（10 条中仅 4 条剔除该项后会翻成 PASS，其余 6 条另有检查未过），详见基线报告 |
+| ⚠️ 伪造引用审计的实际口径 | 该审计**逐条夹具选配**，全仓 211 条里只有 7 条开启（6 条属 `master-curriculum`、1 条属 `master-huineng`），本次实测到的只有 6 条——**15 位祖师无一被查过伪造引用**。且审计器的 ID 正则只认 CBETA 经号，声明 `PTS:` / `Toh:` / `BDRC:` / `SuttaCentral` 的六位南传、藏传祖师即便开启也无法触发。本行于 2026-08-31 更正，此前表述为「零虚构引用」 |
 
-**全局安装（频繁使用 / 离线场景）**
+这是**关键词/引用字符串覆盖率检查，不是教义正确性或 LLM 判分的答案质量**。完整表格、失败案例与方法论说明见 **[eval/reports/BASELINE.md](eval/reports/BASELINE.md)**。
 
-```bash
-npm install -g master-skill            # 一次性装到 $PATH
-master-skill install master-zhiyi      # 之后省掉 npx，直接调
-master-skill list
-npm update -g master-skill             # 升到下一个 minor / patch
-```
-
-**Claude Code（插件方式）**
+---
 
-```bash
-# npx（上方）与 git clone 手动安装为正式发布渠道：
-git clone https://github.com/xr843/Master-skill ~/Master-skill
-cd ~/Master-skill && pip install -r requirements.txt
-for d in prebuilt/master-*/; do ln -sf "$(pwd)/$d" ~/.claude/skills/"$(basename $d)"; done
-ln -sf "$(pwd)/prebuilt/compare" ~/.claude/skills/compare-masters
-ln -sf "$(pwd)" ~/.claude/skills/create-master
-```
+## 开发者安装
 
-**Cursor**
+> 👤 **只是想体验？** 直接用 [fojin.app/chat](https://fojin.app/chat)，无需安装。
+> 🛠️ **本节面向** Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI 用户。
 
 ```bash
-git clone https://github.com/xr843/Master-skill ~/Master-skill
-# Cursor 自动检测 .cursor-plugin/plugin.json 并注册技能
-```
-
-**OpenCode**
-
-在 `opencode.json` 中添加：
-
-```json
-{
-  "plugin": ["master-skill@git+https://github.com/xr843/Master-skill.git"]
-}
-```
-
-**Codex CLI**
-
-参见 [.codex/INSTALL.md](.codex/INSTALL.md)
-
-**Gemini CLI**
-
-本项目包含 `gemini-extension.json` 和 `GEMINI.md`，Gemini CLI 自动发现并加载。
-
-### 使用预置法师
-
-在支持 AgentSkills 的环境（Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI）中直接调用：
-
-```
-# 印度
-/master-nagarjuna      — 龙树菩萨（印度·中观｜八宗共祖）
-
-# 汉传
-/master-xuanzang       — 玄奘法师（法相唯识宗）
-/master-kumarajiva     — 鸠摩罗什（三论宗/中观）
-/master-huineng        — 慧能大师（禅宗六祖）
-/master-zhiyi          — 智顗大师（天台宗）
-/master-fazang         — 法藏大师（华严宗）
-/master-yinguang       — 印光大师（净土宗）
-/master-ouyi           — 蕅益大师（天台/净土·跨宗派）
-/master-xuyun          — 虚云老和尚（禅宗·五宗兼嗣）
-
-# 藏传
-/master-atisha         — 阿底峡尊者（噶当派开祖 · 三士道 · 982-1054）
-/master-tsongkhapa     — 宗喀巴大师（格鲁派创始人 · 三主要道 · 应成中观）
-/master-milarepa       — 米拉日巴尊者（噶举派 · 大手印 · 那洛六法）
-
-# 南传
-/master-buddhaghosa    — 觉音尊者（上座部论师 · 《清净道论》· 5世纪）
-/master-mahasi-sayadaw — 马哈希尊者（缅甸内观 · 标记法 · 1904-1982）
-/master-ajahn-chah     — 阿姜查（泰国森林禅林派 · 巴蓬寺传承）
+npx master-skill install --all          # 一次装全部 20 个 Skill
+npx master-skill install master-huineng # 或只装一位
+npx master-skill list                   # 看全部可装的
+npx master-skill recommend "念佛怎么念才算老实"   # 不知道该问谁？让它推荐
 ```
 
-### 教学模式（v0.7）
+装好后在对话里直接调 `/master-huineng`、`/compare-masters` 等。
 
-- **`/compare-masters`** — 多位法师对同一问题的并列对比（横向 / 单轮）
-- **`/master-debate`** — 祖师就争议议题做多轮交叉辩论（v0.8 起：**每轮派 fresh subagent**，只携带对方上一轮 ≤80 字摘要 + 本方 cross_critique 弹药；轮数由 `debate_protocol.per_pair_overrides` 决定，默认 4 轮，`huineng-vs-tsongkhapa` / `ouyi-vs-tsongkhapa` 默认 5 轮）
-- **`/master-curriculum`** — 按你的传统（禅 / 净 / 天台 / 华严 / 唯识 / 中观 / 格鲁 / 上座部）与当前位置（L0-L3）给出有时序的学修路径
-
-**`/compare-masters` 用法示例：**
-
-```
-# 自动选择相关法师
-/compare-masters 什么是空性
-
-# 手动指定法师（推荐，结果更精准）
-/compare-masters 什么是遍行因 --masters master-xuanzang,master-zhiyi,master-ouyi
-
-# 自然语言触发
-请慧能和印光对比回答"如何看待念佛"
-比较禅宗和净土宗对修行的看法
-```
-
-**选择逻辑**：系统先尝试从用户提问中提取关键词，与每位法师的核心概念匹配；若无强匹配，则按主题映射兜底（念佛/禅修/唯识中观/判教等）。**如果自动选的法师不符合预期，直接用 `--masters` 手动指定**。
-
-### 自定义生成
-
-```
-/create-master 弘一大师
-```
-
-或自然语言触发：
-
-```
-帮我创建一个弘一大师的教学角色
-```
-
-系统将引导完成三步信息录入，然后自动从 FoJin 采集数据、生成教义分析与风格文件。
-
----
+> 五端安装细节（Claude Code 插件 / Cursor / OpenCode / Codex CLI / Gemini CLI）、
+> 全局安装、教学模式用法、`/create-master` 自定义生成
+> → **[docs/install.md](docs/install.md)**
 
 ## 桌面管理器
 
-原生桌面控制台(纯 Rust,egui,单二进制,无 Electron),统一管理 17 个 master skill 的安装状态、fidelity 评测覆盖率、运行追踪与质量门禁:
+原生桌面控制台(纯 Rust,egui,单二进制,无 Electron),统一管理 19 个 master skill 的安装状态、fidelity 评测覆盖率、运行追踪与质量门禁:
 
-![Master-skill Desktop Manager](https://raw.githubusercontent.com/xr843/Master-skill/master/docs/assets/desktop-manager.png)
+![Master-skill Desktop Manager](https://raw.githubusercontent.com/xr843/Master-skill/main/docs/assets/desktop-manager.png)
 
 **下载**:[Releases](https://github.com/xr843/Master-skill/releases) 提供 Linux / Windows / macOS 预编译二进制,下载后直接运行(仓库根目录下执行,需本地已 clone 本仓库)。Linux / macOS 下载后需先 `chmod +x` 赋予可执行权限;macOS 上二进制未签名,首次运行需右键"打开"或执行 `xattr -d com.apple.quarantine <文件名>` 解除隔离。
 
@@ -328,153 +223,33 @@ cd desktop && cargo build --release
 
 ## 预置法师
 
-### 龙树菩萨（Nāgārjuna，约150-250） — 印度 · 中观
-
-大乘中观奠基者，汉传尊为「八宗共祖」——三论、天台、净土、华严、禅皆溯源于他，藏传应成中观亦以他为根本所依。立「八不中道」破一切戏论，以「众因缘生法，我说即是空」开显缘起性空，依二谛说法而归于毕竟空、戏论寂灭，并以难易二道判摄修行。所著《中论》为后世中观学之根本论典，《大智度论》则为般若义海之百科。
-主要来源：CBETA《中论》T30n1564、《大智度论》T25n1509、《十二门论》T30n1568、《迴诤论》T32n1631、《十住毗婆沙论》T26n1521。
-调用命令：`/master-nagarjuna`
-
-### 玄奘法师（602-664）
-
-唐代高僧，中国佛教史上最伟大的译经家。西行求法十七年，遍学印度诸部，归国后主持译经事业，译出经论七十五部一千三百三十五卷。创立法相唯识宗，以严谨精确的翻译风格著称，确立"五种不翻"原则。
-主要来源：CBETA《大般若经》《瑜伽师地论》《成唯识论》《心经》等。
-调用命令：`/master-xuanzang`
-
-### 鸠摩罗什（Kumarajiva，344-413）
-
-龟兹出身，后秦长安译经，中国四大译经家之一。其译文以文学性和流畅度著称，《妙法莲华经》《金刚经》《维摩诘经》《中论》等译本至今最为通行。奠定了三论宗（中观）在中国的基础。
-主要来源：CBETA《妙法莲华经》《金刚经》《维摩诘经》《中论》《大智度论》等。
-调用命令：`/master-kumarajiva`
-
-### 慧能大师（638-713）
-
-禅宗六祖，南宗禅创立者。不识文字的卖柴樵夫，闻《金刚经》而开悟，得五祖弘忍传法。著《六祖坛经》——中国人著作中唯一被尊为"经"者。主张"直指人心，见性成佛"，开顿悟法门。
-主要来源：CBETA《六祖大师法宝坛经》T48n2008。
-调用命令：`/master-huineng`
-
-### 智顗大师（538-597）
-
-天台宗创始人，被尊为"东土小释迦"。建立中国佛教第一个完整的判教体系（五时八教），著天台三大部《摩诃止观》《法华玄义》《法华文句》。核心思想：一念三千、三谛圆融、止观双修。
-主要来源：CBETA《摩诃止观》T46n1911、《法华玄义》T33n1718 等。
-调用命令：`/master-zhiyi`
-
-### 法藏大师（643-712）
-
-华严宗三祖，华严哲学体系的实际创立者。武则天国师，以"金师子章"为武后说华严义。核心思想：法界缘起、四法界、十玄门、六相圆融——一切现象互含互摄，事事无碍。
-主要来源：CBETA《华严经探玄记》T35n1733、《华严五教章》T45n1866 等。
-调用命令：`/master-fazang`
-
-### 印光大师（1861-1940）
-
-汉传净土宗第十三代祖师，近代净土复兴的核心人物。
-文字平实恳切，戒行严谨，以书信形式广度众生，著有《印光法师文钞》三编。
-主要来源：CBETA 汉文大藏经，含文钞正编、续编、三编及净土三经。
-调用命令：`/master-yinguang`
-
-### 蕅益大师（1599-1655）
-
-明末四大高僧之一，净土宗九祖。"教宗天台，行归净土"——融通禅、教、律、净四宗，是中国佛教史上最重要的跨宗派综合者。其《阿弥陀经要解》被印光大师赞为"即使古佛再来，也不能超过其上"。
-主要来源：CBETA《阿弥陀经要解》T37n1762、《教观纲宗》等。
-调用命令：`/master-ouyi`
-
-### 虚云老和尚（1840-1959）
-
-近代禅宗泰斗，世寿一百二十岁，一身兼嗣禅门五宗（临济、曹洞、沩仰、云门、法眼）法脉——佛教史上绝无仅有。复兴六大祖庭，历经清末、民国、新中国三个时代。主张参话头、老实修行、禅净双修。
-主要来源：CBETA《楞严经》《金刚经》《六祖坛经》等。
-调用命令：`/master-xuyun`
-
-### 阿底峡尊者（Atiśa Dīpaṃkara, 982-1054） — 藏传 · 噶当派 · 印藏桥梁
-
-印度孟加拉萨霍尔国王子出身，超戒寺住持。1042 年应藏王智光邀请入藏，著《菩提道灯论》(Bodhipathapradīpa)——藏地后弘期道次第之祖。首座弟子仲敦巴建热振寺，开**噶当派**（佛语教授派）。后被宗喀巴新噶当派（即格鲁派）继承。藏传四派（宁玛、萨迦、噶举、格鲁）皆视其为根本师之一。
-主要来源：Toh 4465《菩提道灯论》（sDe dge bsTan 'gyur 标准编号）+ 噶当口耳传承《父法·子法》。
-调用命令：`/master-atisha`
-
-### 宗喀巴大师（Tsongkhapa, 1357-1419） — 藏传 · 格鲁派创始人
-
-藏传佛教**格鲁派**（"善规派"，俗称"黄教"）创始人，达赖喇嘛与班禅喇嘛传承根基。出生于青海宗喀（今西宁附近），师承萨迦派仁达瓦等。深感当时藏地戒律松弛、显密混淆，立"三主要道"（出离心 / 菩提心 / 清净见）为道次第凝练，著《菩提道次第广论》《密宗道次第广论》《辨了不了义善说藏论》。1409 年建甘丹寺（dGa' ldan），格鲁派开山祖庭。
-主要来源：宗喀巴全集 gsung 'bum（BDRC.io 检索 'tsong kha pa'）。汉译参考法尊法师本。
-调用命令：`/master-tsongkhapa`
-
-> ⚠️ 续部具体修法步骤、灌顶仪轨、生起圆满次第细节、本尊咒语、明点观想**只介绍历史与原理，不传授具体修法步骤**。
-
-### 米拉日巴尊者（Milarepa, 1052-1135） — 藏传 · 噶举派
-
-藏传佛教噶举派精神祖师，"瑜伽士"传统（不入寺院、山中闭关、以歌教化）的典范。早年咒杀仇家造重业，依止玛尔巴译师净罪求法，于雪山闭关数十年以荨麻为食。以**道歌（mGur）**说法，影响后世整个藏传佛教。
-主要来源：BDRC《米拉日巴道歌集》（W1KG14334，《十万歌集》mGur 'bum）、《密勒日巴尊者传》（W22272）。
-调用命令：`/master-milarepa`
-
-> ⚠️ 那洛六法、拙火、生起／圆满次第等密法**只介绍历史与原理，不传授具体修法步骤**。具体修持必须依止具格上师亲传与灌顶。
-
-### 觉音尊者（Buddhaghosa, 5世纪） — 南传 · 上座部论师
-
-上座部佛教史上最具影响力的注释家与论师。原为印度南部婆罗门学者，赴斯里兰卡大寺（Mahāvihāra），将古僧伽罗注释翻译为巴利语。著《清净道论》(Visuddhimagga)——以**戒（sīla）、定（samādhi）、慧（paññā）三学**为骨架，系统组织上座部禅修与教理之百科全书（23 章）。其著作奠定南传上座部正统教理体系——东南亚一切论师皆依其判摄。
-主要来源：PTS edition《清净道论》(Visuddhimagga) + 四部尼柯耶注释（aṭṭhakathā）+ Samantapāsādikā 律藏注释 + Atthasālinī 阿毗达摩注释。
-调用命令：`/master-buddhaghosa`
-
-### 马哈希尊者（Mahāsi Sayādaw U Sobhana, 1904-1982） — 南传 · 缅甸内观传统
-
-缅甸现代最具国际影响力的内观禅修大师之一。1947 年起主持仰光 Mahasi Sasana Yeiktha，形成**'马哈希内观法'**（标记法 / Noting Method）——以观察腹部起伏为主所缘，系统培育七清净十六观智。1954-1956 年第六次结集（Chaṭṭha Saṅgāyana）任**'最终编辑长老'**，审定整个巴利三藏。其法系深刻影响美国 Insight Meditation Society 三位创办人（Goldstein、Kornfield、Salzberg）。
-主要来源：《Manual of Insight》(Wisdom Publications, 2016)、《The Progress of Insight》(BPS Sri Lanka)、《Practical Vipassanā Meditation Exercises》(Mahasi Sasana Yeiktha)。
-调用命令：`/master-mahasi-sayadaw`
-
-> ⚠️ **本平台 AI 不得对个体作证果判定或观智阶位确认**——印证须由具格禅师面对面访谈鉴定。这是马哈希教学体系最严肃的 guardrail。
-
-### 阿姜查 Ajahn Chah Subhaddo（1918-1992） — 南传 · 泰国森林禅林派
-
-泰国森林禅林派最具国际影响力的禅师之一。以巴利戒律严格持守、四念处禅修、朴素生活化教学著称。其英语弟子（阿姜苏美多、阿姜帕沙诺等）建立了无畏山林、阿马罗筏底、奇泰罗等海外分院，将森林禅林派传至欧美。代表名言："如果你少放下一点，你就少一点苦。"
-主要来源：巴利三藏（SuttaCentral）+ 公开开示集《Food for the Heart》《A Still Forest Pool》《Living Dhamma》。
-调用命令：`/master-ajahn-chah`
-
----
+十五位祖师，四大传统。命令即技能名，装好后直接在对话里调用。
+
+| 命令 | 祖师 | 传统 · 宗派 | 年代 |
+|---|---|---|---|
+| `/master-nagarjuna` | 龙树菩萨 | 印度 · 中观（八宗共祖） | 约 150-250 |
+| `/master-kumarajiva` | 鸠摩罗什 | 汉传 · 三论／中观 | 344-413 |
+| `/master-zhiyi` | 智顗大师 | 汉传 · 天台 | 538-597 |
+| `/master-xuanzang` | 玄奘法师 | 汉传 · 法相唯识 | 602-664 |
+| `/master-huineng` | 慧能大师 | 汉传 · 禅宗六祖 | 638-713 |
+| `/master-fazang` | 法藏大师 | 汉传 · 华严 | 643-712 |
+| `/master-ouyi` | 蕅益大师 | 汉传 · 天台／净土（跨宗派） | 1599-1655 |
+| `/master-xuyun` | 虚云老和尚 | 汉传 · 禅宗五宗兼嗣 | 1840-1959 |
+| `/master-yinguang` | 印光大师 | 汉传 · 净土 | 1861-1940 |
+| `/master-atisha` | 阿底峡尊者 | 藏传 · 噶当（三士道） | 982-1054 |
+| `/master-milarepa` | 米拉日巴尊者 | 藏传 · 噶举（大手印） | 1052-1135 |
+| `/master-tsongkhapa` | 宗喀巴大师 | 藏传 · 格鲁（应成中观） | 1357-1419 |
+| `/master-buddhaghosa` | 觉音尊者 | 南传 · 上座部论师 | 5 世纪 |
+| `/master-mahasi-sayadaw` | 马哈希尊者 | 南传 · 缅甸内观 | 1904-1982 |
+| `/master-ajahn-chah` | 阿姜查 | 南传 · 泰国森林禅林派 | 1918-1992 |
+
+**教学模式**：`/compare-masters` 并列对比 · `/master-debate` 多轮对辩 · `/master-curriculum` 学修路径 · `/master-help` 我该问谁 · `/create-master` 自定义生成
+
+> 每位祖师的生平、核心思想与声明来源 → **[docs/masters.md](docs/masters.md)**
 
 ## 架构图
 
-```
-用户请求
-    |
-    v
-session-start hook ──> 自动注入法师列表（5 端统一）
-    |
-    v
-SKILL.md (AgentSkills 入口：决策树 + Quick Ref)
-    |
-    +-- 预置法师 --> prebuilt/{slug}/
-    |                   +-- SKILL.md          (决策树 + <HARD-GATE> 铁律)
-    |                   +-- meta.json         (version / lineage / provenance)
-    |                   +-- references/       (按需加载)
-    |                   |   +-- teaching.md
-    |                   |   +-- voice.md
-    |                   +-- sources/          (离线经文片段)
-    |                   |   +-- *.md (声明来源的离线段落)
-    |                   +-- tests/
-    |                       +-- fidelity.jsonl  (保真度样例, CI dry-run)
-    |
-    +-- 工具链
-    |   +-- scripts/validate.py         (frontmatter linter)
-    |   +-- scripts/cite.py             (CBETA 引用查询)
-    |   +-- scripts/query.py            (离线语义检索)
-    |   +-- scripts/test-fidelity.py    (保真度测试)
-    |   +-- scripts/validate-fidelity.py
-    |   +-- bin/cli.mjs                 (NPX installer)
-    |
-    +-- 自定义生成 (/create-master, 带 HARD-GATE)
-          +-- Step 1-2  prompts/intake.md → tools/sutra_collector.py
-          |             └─> FoJin API (KG + 语义检索 + 文本)
-          +-- Step 3    prompts/{sutra,voice}_analyzer.md → 两阶段分析
-          +-- Step 3.5  二阶段独立审查 ──┬─ prompts/doctrine_reviewer.md
-          |                             └─ prompts/voice_reviewer.md
-          +-- Step 4-5  tools/master_builder.py → tools/skill_writer.py
-                        └─> tools/verify_sources.py (写入前最终验证)
-
-多平台插件统一入口：
-  .claude-plugin/    → Claude Code      (hooks/run-hook.cmd → session-start)
-  .cursor-plugin/    → Cursor           (hooks/hooks-cursor.json)
-  .codex/            → Codex CLI        (.codex/INSTALL.md)
-  .opencode/         → OpenCode         (opencode.json 引用)
-  gemini-extension.json → Gemini CLI    (GEMINI.md 自动加载)
-```
-
----
+目录结构与数据流 → **[docs/architecture.md](docs/architecture.md)**
 
 ## 与 FoJin 的关系
 
@@ -508,27 +283,7 @@ Master-skill 通过 `tools/fojin_bridge.py` 接入 FoJin API，实现：
 
 ## 常见问题
 
-**Q：FoJin API 不可达时还能用吗？**
-
-能。每位预置法师的 `prebuilt/<name>/sources/` 收录了该法师核心经典的关键段落（离线经文片段）。FoJin 不可用时，法师会降级到离线模式并在回答中声明"当前使用离线片段"。`/create-master` 管线遇到 API 故障会提示用户切换手动输入模式，由用户粘贴经文原文继续生成。
-
-**Q：CBETA 引用格式是什么样的？来源如何验证？**
-
-CBETA 引证使用 `Txxn####` 形式的经号（例如《妙法蓮華經》→ `T09n0262`）；藏传、南传与编纂开示分别使用 persona 在 `meta.json.sources[]` 中声明的 BDRC / Toh、SuttaCentral / PTS 或 teaching ID。`scripts/validate-citation-contract.py` 与 `tools/verify_sources.py --check-links/--final-check` 离线检查来源家族、ID 格式、声明归属和合同一致性；它们不解析正文自由文本，也不保证外部链接 HTTP 可达。旧版 `verify_sources.py --fix` 在线审计只覆盖 CBETA / FoJin 链接。
-
-**Q：`npx master-skill install` 执行失败、报 ENOTEMPTY 或权限错误怎么办？**
-
-先清理 `~/.claude/skills/master-<name>/` 残留目录再重试。如果是 npm 缓存问题，`npm cache clean --force` 后重跑 NPX。Windows 用户请在 Git Bash 或 WSL 中执行，避免 cmd.exe 的路径转义问题。
-
-**Q：生成的法师内容和历史记载不符，怎么纠正？**
-
-直接在对话中告诉法师"他不会这样说话"或"他应该更严厉一些"。`/create-master` 的纠正模式会识别纠正类型（教义纠正 → 追加到 `teaching.md`；风格纠正 → 追加到 `voice.md`），以 `## Correction` 块形式记录并自动递增 patch 版本号。纠正记录的优先级高于分析生成的内容。
-
-**Q：如何贡献一位新的预置法师？**
-
-见下方「贡献指南」。基本流程：遵循 v0.3 目录结构生成 `prebuilt/<name>/`、跑通 `scripts/validate.py --strict`、补齐 `tests/fidelity.jsonl` 的 5 条以上样例，然后提 PR。
-
----
+安装、调用、检索的常见问题 → **[docs/troubleshooting.md](docs/troubleshooting.md)**
 
 ## 贡献指南