master-skill 0.12.10 → 0.12.12

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.12.10",
+      "version": "0.12.12",
       "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.12.10",
+  "version": "0.12.12",
   "author": {
     "name": "xr843",
     "email": "xr843@users.noreply.github.com"
@@ -9,6 +9,10 @@
   "homepage": "https://github.com/xr843/Master-skill",
   "repository": "https://github.com/xr843/Master-skill",
   "license": "MIT",
+  "skills": [
+    "./",
+    "./prebuilt/"
+  ],
   "keywords": [
     "buddhism",
     "chinese-buddhism",

package/.codex/INSTALL.md

@@ -3,35 +3,42 @@
 ## Quick Install
 
 ```bash
-# Clone the repository
 git clone https://github.com/xr843/Master-skill.git ~/.codex/master-skill
-
-# Create skills symlink
-ln -sf ~/.codex/master-skill/prebuilt ~/.agents/skills/master-skill
-ln -sf ~/.codex/master-skill/SKILL.md ~/.agents/skills/create-master/SKILL.md
+mkdir -p ~/.agents/skills
+ln -sfn ~/.codex/master-skill/prebuilt ~/.agents/skills/master-skill
+ln -sfn ~/.codex/master-skill ~/.agents/skills/create-master
 ```
 
-Restart Codex to discover the new skills.
+Restart Codex. It should list 20 skills: 15 personas, 4 teaching modes, and
+`create-master`. Codex names a skill found under a linked directory after that
+directory, so they appear as `master-skill:master-huineng`,
+`master-skill:compare-masters`, and so on.
+
+Measured with Codex CLI 0.153.4 on Linux, isolated HOME, 2026-09-16
+(`codex debug prompt-input` shows the skills the model is given):
+
+- Without the `mkdir -p`, both `ln` commands fail on a machine where
+  `~/.agents/skills` does not exist yet.
+- `create-master` must be a link to the whole checkout. A link to the root
+  `SKILL.md` alone is a file symlink, and Codex skips it; the generator also
+  needs the `prompts/` and `references/` beside it.
+- `npx master-skill install` installs to `~/.claude/skills/`, which Codex does
+  not read.
 
 ## Windows (PowerShell)
 
+Not re-verified; mirrors the steps above.
+
 ```powershell
 git clone https://github.com/xr843/Master-skill.git "$env:USERPROFILE\.codex\master-skill"
+New-Item -ItemType Directory -Force "$env:USERPROFILE\.agents\skills" | Out-Null
 cmd /c mklink /J "$env:USERPROFILE\.agents\skills\master-skill" "$env:USERPROFILE\.codex\master-skill\prebuilt"
+cmd /c mklink /J "$env:USERPROFILE\.agents\skills\create-master" "$env:USERPROFILE\.codex\master-skill"
 ```
 
 ## Available Skills After Install
 
-- `/xuanzang` — Xuanzang (Yogacara)
-- `/kumarajiva` — Kumarajiva (Madhyamaka)
-- `/huineng` — Huineng (Chan/Zen)
-- `/zhiyi` — Zhiyi (Tiantai)
-- `/fazang` — Fazang (Huayan)
-- `/yinguang` — Yinguang (Pure Land)
-- `/ouyi` — Ouyi (Tiantai-Pure Land)
-- `/xuyun` — Xuyun (Chan, Five Schools)
-- `/compare-masters` — Multi-tradition comparison
-- `/create-master` — Generate new master
+Run `npx master-skill list` for the current list with descriptions.
 
 ## Tool Mapping
 

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.12.10",
+  "version": "0.12.12",
   "author": {
     "name": "xr843",
     "email": "xr843@users.noreply.github.com"

package/.opencode/INSTALL.md

@@ -2,36 +2,49 @@
 
 ## Quick Install
 
-Add to your `opencode.json`:
+```bash
+npx master-skill install --all
+```
+
+OpenCode reads `~/.claude/skills/` without any configuration, and that is where
+this installs. `opencode debug skill` should list 20 skills: 15 personas, 4
+teaching modes, and `create-master`.
+
+## From a Checkout
+
+Point `skills.paths` in `opencode.json` at the checkout's `prebuilt/`:
 
 ```json
 {
-  "plugin": ["master-skill@git+https://github.com/xr843/Master-skill.git"]
+  "skills": { "paths": ["/absolute/path/to/Master-skill/prebuilt"] }
 }
 ```
 
-OpenCode will automatically install and register all skills.
+That gives the 19 skills under `prebuilt/`. `create-master` lives at the
+repository root, outside it.
 
 ## Pin a Version
 
+```bash
+npx master-skill@<version> install --all
+```
+
+## Not a Plugin
+
+Earlier versions of this page said to add
+
 ```json
-{
-  "plugin": ["master-skill@git+https://github.com/xr843/Master-skill.git#v0.3.0"]
-}
+{ "plugin": ["master-skill@git+https://github.com/xr843/Master-skill.git"] }
 ```
 
+OpenCode plugins are JavaScript modules, and this repository ships none. With
+that entry `opencode debug skill` lists none of these skills.
+
+Measured with OpenCode 1.18.13 on Linux, isolated HOME, 2026-09-16.
+
 ## Available Skills After Install
 
-- `/xuanzang` — Xuanzang (Yogacara)
-- `/kumarajiva` — Kumarajiva (Madhyamaka)
-- `/huineng` — Huineng (Chan/Zen)
-- `/zhiyi` — Zhiyi (Tiantai)
-- `/fazang` — Fazang (Huayan)
-- `/yinguang` — Yinguang (Pure Land)
-- `/ouyi` — Ouyi (Tiantai-Pure Land)
-- `/xuyun` — Xuyun (Chan, Five Schools)
-- `/compare-masters` — Multi-tradition comparison
-- `/create-master` — Generate new master
+Run `npx master-skill list` for the current list with descriptions.
 
 ## Tool Mapping
 

package/README.md

@@ -139,7 +139,7 @@ Master-skill 是由 [FoJin](https://fojin.app) 驱动的佛教 AI 祖师人格
 - **HARD-GATE 铁律**：`/create-master` 与预置法师内置红线——教义断言、修行指导与文本解释必须引用该 persona 声明的来源（CBETA / BDRC / Toh / SuttaCentral / PTS / 合规编纂开示），不得捏造来源 ID，不得为虚构人物建角色
 - **二阶段独立审查**：生成管线在写入前强制经过"教义准确性 → 风格一致性"两轮独立审查，FAIL 自动修复最多 2 轮
 - **自动化保真度测试**：211 条夹具（每位祖师 10+ 条，`compare-masters` 元技能 18 条）检查关键词与引用覆盖，每条评分回答另经离线引文审计；CI 在每个 PR 与 main 上做结构校验（dry-run）；实跑评分支持 Anthropic / DeepSeek / Gemini（`--provider`），需要对应的 API key，作为本地/发版前手动步骤执行——最近一次全量运行与逐条裁定见[下文](#保真度评测当前数据)
-- **多平台统一插件**：Claude Code、Cursor、Codex CLI、OpenCode、Gemini CLI 共用一份 `prebuilt/`，session-start hook 跨平台注入法师列表
+- **多平台共用一份 `prebuilt/`**：Claude Code、Cursor、Codex CLI、OpenCode、Gemini CLI 各有装法（见 [docs/install.md](docs/install.md)，Codex / OpenCode / Gemini 三端均为实测过的步骤）
 - **NPX 一键安装**：`npx master-skill install master-zhiyi` 直接部署到 Claude Code
 - **离线工具链**：`scripts/cite.py`（CBETA 引用查询）、`scripts/query.py`（离线语义检索）、`scripts/validate.py`（frontmatter linter）
 - **FoJin 数据桥**：接入 [fojin.app](https://fojin.app) 的 10K+ 篇文本、678K+ 条语义向量与 110K+ 实体的知识图谱（另登记 600+ 个数据源）
@@ -190,7 +190,7 @@ npx master-skill doctor                 # 检查本地安装与运行路径
 npx master-skill update --all           # 升级：重装全部并清掉旧文件
 ```
 
-装好后在对话里直接调 `/master-huineng`、`/compare-masters` 等。
+装好后在对话里直接调 `/master-huineng`、`/compare-masters` 等。npx 装到 `~/.claude/skills/`，Claude Code 与 OpenCode 读取这里；**Codex CLI 与 Gemini CLI 不读**，请按 docs/install.md 的对应小节安装。
 
 > 五端安装细节（Claude Code 插件 / Cursor / OpenCode / Codex CLI / Gemini CLI）、
 > 全局安装、教学模式用法、`/create-master` 自定义生成

package/README_EN.md

@@ -157,7 +157,7 @@ This project is built out of respect for Buddhist traditions. All content is gen
 - **HARD-GATE discipline**: Both `/create-master` and every prebuilt master require doctrinal claims, practice guidance, and text interpretation to cite that persona's declared sources (CBETA / BDRC / Toh / SuttaCentral / PTS / compliant compiled teachings); fabricated source IDs and fictional personas are forbidden
 - **Two-stage independent review**: The generation pipeline forces a "doctrinal accuracy → voice consistency" review before write; FAIL triggers up to 2 rounds of automatic repair
 - **Automated fidelity tests**: 211 fixtures (10+ per master, 18 for the `compare-masters` meta-skill) check keyword and citation coverage, and every graded answer also goes through the offline citation audit; CI runs a structural dry-run on every PR and on `main`; graded runs support Anthropic / DeepSeek / Gemini (`--provider`) with the matching API key, as a manual local/pre-release step — the latest full run and its case-by-case adjudication are [below](#fidelity-evaluation-current-data)
-- **Unified multi-platform plugin**: Claude Code, Cursor, Codex CLI, OpenCode, and Gemini CLI share one `prebuilt/` tree, with a session-start hook injecting the master list on every platform
+- **One `prebuilt/` tree across platforms**: Claude Code, Cursor, Codex CLI, OpenCode, and Gemini CLI each install it differently (see [docs/install.en.md](docs/install.en.md); the Codex, OpenCode, and Gemini steps are measured)
 - **NPX one-shot install**: `npx master-skill install master-zhiyi` drops skills straight into Claude Code
 - **Offline toolchain**: `scripts/cite.py` (CBETA lookup), `scripts/query.py` (offline semantic search), `scripts/validate.py` (frontmatter linter)
 - **FoJin data bridge**: Connected to [fojin.app](https://fojin.app) — 10K+ texts, 678K+ semantic embeddings, a knowledge graph of 110K+ entities, and 600+ registered data sources
@@ -208,7 +208,7 @@ npx master-skill doctor                 # check the local install and runtime pa
 npx master-skill update --all           # upgrade: reinstall everything, clearing stale files
 ```
 
-Once installed, invoke `/master-huineng`, `/compare-masters`, etc. directly in chat.
+Once installed, invoke `/master-huineng`, `/compare-masters`, etc. directly in chat. npx installs to `~/.claude/skills/`, which Claude Code and OpenCode read; **Codex CLI and Gemini CLI do not**, so use their sections in docs/install.en.md.
 
 > Per-platform setup (Claude Code plugin / Cursor / OpenCode / Codex CLI / Gemini CLI),
 > global install, teaching-mode usage, and `/create-master`

package/SKILL.md

@@ -94,7 +94,7 @@ API 故障 / 超时 / 数据阈值 / 引用规则细节 → `references/workflow
 
 将审查通过的名称、传承、宗派、时代、语言、`teaching_content`、`voice_content`、`sources` 与同一 `citation_contract` 写入 `generated-master.json`，再运行 `${CLAUDE_SKILL_DIR}/tools/master_builder.py --spec generated-master.json --output "${CLAUDE_SKILL_DIR}/masters/"`。生成器统一写入 `masters/master-{slug}/`，且 `SKILL.md` 的 name 为 `master-{slug}`；随后运行 `${CLAUDE_SKILL_DIR}/tools/verify_sources.py --final-check "${CLAUDE_SKILL_DIR}/masters/master-{slug}/"`。该终验离线检查四个必需文件、目录/name 一致性，以及 `meta.json` 的来源清单、家族 ID、声明归属和 contract；它不解析 `teaching.md` 自由文本，也不保证外部站点可达。
 
-OpenClaw / Claude Code 注册路径 → `references/workflow-details.md` §Step 5。
+终验通过后运行 `${CLAUDE_SKILL_DIR}/tools/master_builder.py --register "${CLAUDE_SKILL_DIR}/masters/master-{slug}"`：Claude Code 只加载 `~/.claude/skills/<名字>/SKILL.md`，不扫 `masters/`，不注册就无法用 `/master-{slug}` 调用。按输出的 `invoke` 告知用户；`restart_required` 为真时提示重启；报 `not replacing` 时不得覆盖同名 skill，交由用户决定。细节与 OpenClaw 注册 → `references/workflow-details.md` §角色注册（按运行环境）。
 
 ## 追加材料、纠正、管理命令
 
@@ -102,7 +102,7 @@ OpenClaw / Claude Code 注册路径 → `references/workflow-details.md` §Step
 - **纠正模式**：用户说"他不会这样说话/他应该更严厉" → 加载 `prompts/correction_handler.md`；以 `## Correction` 块追加到 teaching.md / voice.md 末尾；patch 递增。
 - **管理命令**：`/list-masters`（列出所有，标 `[预置]`/`[自定义]`）、`/master-rollback <slug> <version>`（回滚，自动归档当前）、`/delete-master <slug>`（删除，预置不可删，需二次确认）。
 
-冲突处理策略、版本号细节、用户确认文案 → `references/workflow-details.md` §追加纠正管理。
+冲突处理策略、版本号细节、用户确认文案 → `references/workflow-details.md` §追加材料、纠正、管理命令细则。
 
 ## 执行优先级（运行时）
 

package/bin/cli.mjs

@@ -435,6 +435,101 @@ function cmdUninstall(names) {
   return failed;
 }
 
+// Every file `install` copies for this skill, relative to its install dir.
+// Mirrors cmdInstall: a persona or mode copies its whole source directory; the
+// generator copies its bundle_paths. `masters/` holds the user's generated
+// personas and `__pycache__` is written by running the tools, so neither is
+// part of what the package installed.
+function expectedInstallFiles(skill) {
+  const src = path.join(PACKAGE_ROOT, skill.source);
+  const roots =
+    skill.kind === "generator"
+      ? skill.bundle_paths.filter((bundlePath) => bundlePath !== "masters")
+      : ["."];
+  const files = [];
+  const walk = (rel) => {
+    const abs = path.join(src, rel);
+    if (!fs.existsSync(abs)) return;
+    if (fs.statSync(abs).isDirectory()) {
+      if (path.basename(abs) === "__pycache__") return;
+      for (const entry of fs.readdirSync(abs)) {
+        walk(rel === "." ? entry : path.join(rel, entry));
+      }
+    } else if (!abs.endsWith(".pyc")) {
+      files.push(rel);
+    }
+  };
+  for (const root of roots) walk(root);
+  return files;
+}
+
+// What is actually under the skills directory. Until 2026-09-17 doctor only
+// checked the package's own sources, and reported "ok" (exit 0) with an
+// installed SKILL.md deleted, a persona's references/ gone, the generator's
+// tools/ gone, an install from an older version — and with nothing installed.
+// A skill that is simply not installed is not a problem: installing one master
+// is a normal choice.
+function installedProblems() {
+  const problems = [];
+  for (const skill of catalogSkills()) {
+    const dest = path.join(SKILLS_DIR, skill.install_dir);
+    if (!fs.existsSync(dest)) continue;
+    if (!fs.existsSync(path.join(dest, "SKILL.md"))) {
+      problems.push({
+        code: "installed-missing-skill-md",
+        name: skill.name,
+        message: `${skill.name} is installed without SKILL.md — run: master-skill install ${skill.name}`,
+      });
+      continue;
+    }
+    const missing = [];
+    const changed = [];
+    for (const rel of expectedInstallFiles(skill)) {
+      const installed = path.join(dest, rel);
+      if (!fs.existsSync(installed)) {
+        missing.push(rel);
+      } else if (
+        !fs.readFileSync(installed).equals(
+          fs.readFileSync(path.join(PACKAGE_ROOT, skill.source, rel))
+        )
+      ) {
+        changed.push(rel);
+      }
+    }
+    if (missing.length) {
+      problems.push({
+        code: "installed-incomplete",
+        name: skill.name,
+        message: `${skill.name} is missing ${missing.length} installed file(s), e.g. ${missing[0]} — run: master-skill install ${skill.name}`,
+      });
+    }
+    if (changed.length) {
+      problems.push({
+        code: "installed-outdated",
+        name: skill.name,
+        message: `${skill.name} differs from package ${pkgVersion()} in ${changed.length} file(s), e.g. ${changed[0]} — run: master-skill update --all`,
+      });
+    }
+  }
+
+  // Personas registered by create-master are links into create-master/masters/;
+  // uninstalling the generator leaves them pointing at nothing.
+  if (fs.existsSync(SKILLS_DIR)) {
+    for (const entry of fs.readdirSync(SKILLS_DIR, { withFileTypes: true })) {
+      if (!entry.isSymbolicLink()) continue;
+      const link = path.join(SKILLS_DIR, entry.name);
+      if (!fs.existsSync(link)) {
+        problems.push({
+          code: "dangling-link",
+          name: entry.name,
+          message: `${entry.name} links to ${fs.readlinkSync(link)}, which no longer exists`,
+        });
+      }
+    }
+  }
+  return problems;
+}
+
 function doctorData() {
   const masters = availableMasters();
   const installed = installedSkillDirs();
@@ -453,6 +548,7 @@ function doctorData() {
     name: skill.name,
     message: `${skill.name} is missing SKILL.md`,
   }));
+  problems.push(...installedProblems());
 
   return {
     packageVersion: pkgVersion(),

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "master-skill",
   "description": "FoJin-powered Buddhist AI persona framework — source-grounded, boundary-aware, fidelity-tested, runtime-ready. 15 prebuilt masters across 印度/汉传/藏传/南传.",
-  "version": "0.12.10",
+  "version": "0.12.12",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session_start.py

@@ -25,13 +25,24 @@ import json
 import os
 import re
 import sys
+import unicodedata
 from pathlib import Path
 
-# Whitelist: CJK Unified, ASCII alphanumerics, fullwidth parens, space, · _ ( ) -
-# Everything else — backticks, dollars, quotes, slashes, control characters —
-# is dropped. An attacker who lands a malicious SKILL.md (or a contributor with
-# a typo) must not be able to reach the system prompt through it.
-_ALLOWED = re.compile(r"[^一-鿿0-9A-Za-z _\-·（）()]", re.UNICODE)
+# Whitelist: CJK Unified, ASCII alphanumerics, Latin letters with diacritics,
+# fullwidth parens and solidus, space, · _ ( ) -
+# Everything else — backticks, dollars, quotes, ASCII slashes, control, format
+# and bidi characters — is dropped. An attacker who lands a malicious SKILL.md
+# (or a contributor with a typo) must not be able to reach the system prompt
+# through it.
+#
+# The Latin ranges are letters only: À-Ö Ø-ö ø-ÿ (Latin-1 without × and ÷),
+# Latin Extended-A, and Latin Extended Additional. Until 2026-09-16 they were
+# absent, and five of fifteen shipped lineages reached the model altered:
+# "(Mahāvihāra)" as "(Mahvihra)", and "三论宗/中观" as the single made-up term
+# "三论宗中观" because the slash was deleted rather than kept. An ASCII slash is
+# still never emitted — it could read as a slash command — so it becomes the
+# fullwidth "／", which keeps the "A or B" meaning.
+_ALLOWED = re.compile(r"[^一-鿿0-9A-Za-zÀ-ÖØ-öø-ſḀ-ỿ _\-·（）()／]", re.UNICODE)
 _CONTROL = re.compile(r"[\x00-\x1f\x7f-\x9f]")
 _WHITESPACE = re.compile(r"\s+")
 
@@ -61,8 +72,10 @@ _LINEAGE_LINE = re.compile(r"^lineage:[ \t]*(.*)$", re.MULTILINE)
 
 def sanitize_lineage(raw: str) -> str:
     """Normalize one raw `lineage:` frontmatter value for prompt splicing."""
-    text = _CONTROL.sub("", raw or "")
-    text = _ALLOWED.sub("", text)
+    # NFC first: a decomposed "ā" (a + U+0304) would otherwise lose its
+    # combining macron and silently become "a".
+    text = _CONTROL.sub("", unicodedata.normalize("NFC", raw or ""))
+    text = _ALLOWED.sub("", text.replace("/", "／"))
     text = _WHITESPACE.sub(" ", text).strip()
     return text[:MAX_LINEAGE_CHARS]
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "master-skill",
-  "version": "0.12.10",
+  "version": "0.12.12",
   "type": "module",
   "description": "FoJin-powered Buddhist AI persona framework — source-grounded, boundary-aware, fidelity-tested, runtime-ready. 15 pre-built masters across 印度 / 汉传 / 藏传 / 南传, plus /compare-masters, /master-debate, and /master-curriculum.",
   "bin": {
@@ -16,7 +16,7 @@
     "validate:versions": "python3 scripts/check-manifest-versions.py",
     "test:hook": "bash hooks/tests/test_session_start.sh && bash hooks/tests/test_run_hook.sh && bash hooks/tests/test_run_hook_cmd.sh",
     "test:cli": "node --test tests/cli.test.mjs",
-    "test": "python3 scripts/check-gate-liveness.py && python3 scripts/validate.py --strict && python3 scripts/validate-citation-references.py && python3 scripts/validate-citation-templates.py && python3 scripts/validate-self-audit-sources.py && python3 scripts/validate-fidelity.py && python3 scripts/validate-persona-fidelity.py && python3 scripts/check-manifest-versions.py && python3 scripts/validate-routing.py && python3 scripts/validate-fixture-terms.py && python3 scripts/verify-adjudication.py && python3 scripts/test-fidelity.py --all --dry-run && node --test tests/cli.test.mjs && python3 -m pytest tests/ scripts/tests/ -q",
+    "test": "python3 scripts/check-gate-liveness.py && python3 scripts/validate.py --strict && python3 scripts/validate-citation-references.py && python3 scripts/validate-citation-templates.py && python3 scripts/validate-self-audit-sources.py && python3 scripts/validate-citation-contract.py && python3 scripts/validate-cross-critique.py && python3 scripts/validate-lore-triggers-content.py --strict && python3 scripts/validate-quote-attribution.py && python3 scripts/validate-section-references.py && python3 scripts/validate-promptfoo-configs.py && python3 scripts/validate-fidelity.py && python3 scripts/validate-persona-fidelity.py && python3 scripts/check-manifest-versions.py && python3 scripts/validate-routing.py && python3 scripts/validate-fixture-terms.py && python3 scripts/verify-adjudication.py && python3 scripts/test-fidelity.py --all --dry-run && node --test tests/cli.test.mjs && python3 -m pytest tests/ scripts/tests/ -q",
     "test:smoke": "python3 scripts/test-fidelity.py --master yinguang --max-tests 1",
     "prepack": "node bin/cli.mjs list"
   },

package/prebuilt/master-ajahn-chah/SKILL.md

@@ -29,15 +29,15 @@ verified_at: 2026-05-02
 
 用户问题类型 →
 - **正念 / 觉知 / 看自己的心**（sati / awareness / mindfulness）
-  → 读 `sources/teachings-excerpts.md` §正念与觉知 + `references/teaching.md` §心的训练
+  → 读 `sources/teachings-excerpts.md` §正念与觉知、§心的训练 + `references/teaching.md` §四念处与正念
 - **放下 / 执取 / 痛苦的根源**（letting go / clinging / dukkha）
-  → 读 `sources/teachings-excerpts.md` §放下 + `references/teaching.md` §苦与放下
+  → 读 `sources/teachings-excerpts.md` §放下 + `references/teaching.md` §放下
 - **三法印 / 无常 / 无我**（anicca / dukkha / anatta）
   → 读 `sources/sutta-excerpts.md` §三法印 + `references/teaching.md` §三法印
 - **禅修方法 / 出入息念 / 妄念多**（anapanasati / 散乱）
-  → 读 `sources/teachings-excerpts.md` §禅修与出入息念 + `references/teaching.md` §禅那与毗婆舍那
+  → 读 `sources/teachings-excerpts.md` §禅修与出入息念 + `references/teaching.md` §出入息念
 - **戒律 / 出家生活 / 杜多行**（vinaya / dhutanga / 头陀）
-  → 读 `references/teaching.md` §戒与森林生活
+  → 读 `references/teaching.md` §戒定慧三学、§杜多行 + `sources/teachings-excerpts.md` §日常生活与中道
 - **风格对话**（"想和阿姜查交流"/角色扮演）
   → 读 `references/voice.md` 建立人格（**内化即可，勿向用户复述此步**），再按上述分类响应
 - **离线摘录覆盖不到已声明来源的所需位置**（具体卷次 / 已声明来源的章节未收录 / `sources/` 检索为空）

package/prebuilt/master-ajahn-chah/sources/sutta-excerpts.md

@@ -9,7 +9,7 @@
 
 ### 五蕴非我经（Anattalakkhaṇa Sutta）
 
-佛陀第二次说法对象——五位最初弟子。佛说："比丘们，色（rūpa）非我；受（vedanā）非我；想（saññā）非我；行（saṅkhārā）非我；识（viññāṇa）非我。何以故？若色是我，色不应病；若色是我，应能令色'如是、不如是'。诸比丘，色是无常、苦、变易法，故非我、非我所、非我体。受、想、行、识亦复如是。"
+佛陀第二次说法对象——五位最初弟子。经文要旨（非逐字译文）：色（rūpa）非我——若色是我，色就不会招致病苦，也能令色如是、不如是；正因色非我，色才招致病苦，也不能令色如是、不如是。受（vedanā）、想（saññā）、行（saṅkhārā）、识（viññāṇa）亦然。佛继而以问答引导五比丘：色是常还是无常？比丘答无常。无常者是苦是乐？答苦。无常、苦、变易之法，可视之为此是我所、此是我、此是我体吗？答不可。故一切色，无论过去未来现在、内外、粗细、劣胜、远近，皆应以正慧如实观为此非我所、此非我、此非我体；受、想、行、识亦然。
 
 听此说法已，五比丘漏尽，证阿罗汉果。
 
@@ -35,7 +35,7 @@
 
 ### 念处经 / 大念处经（Satipaṭṭhāna / Mahāsatipaṭṭhāna Sutta）
 
-佛说："诸比丘，此一行道，能令众生清净、超越愁悲、灭除苦忧、得正理、证涅槃，所谓四念处。何为四？比丘于身观身、于受观受、于心观心、于法观法，热忱、正知、正念，远离世间贪忧。"
+经文要旨（非逐字译文）：此一行道能令众生清净、超越愁悲、灭除苦忧、得正理、证涅槃，即四念处——比丘于身观身、于受观受、于心观心、于法观法，热忱、正知、正念，远离世间贪忧。
 
 **四念处之要**：
 - **身念处**：观身呼吸、行住坐卧、身体三十二分、四界（地水火风）、墓地九相
@@ -100,7 +100,7 @@
 
 ### 一切经（Sabba Sutta）
 
-佛说："何为一切？眼与色、耳与声、鼻与香、舌与味、身与触、意与法——此乃一切。除此之外若有人言别有'一切'，唯口言尔，问之则不能答。"
+经文要旨（非逐字译文）：一切，即眼与色、耳与声、鼻与香、舌与味、身与触、意与法。若有人说要舍此一切而另立一切，那只是言说：问之则不能答，更将陷于困恼——因为那已超出他所能了知的范围。
 
 **主旨**：将"世界"还原为六根六尘的当下经验，断除对超越实体（永恒灵魂、绝对实体）之执取。
 

package/prebuilt/master-atisha/SKILL.md

@@ -138,7 +138,7 @@ GET https://fojin.app/api/search/semantic?q=<URL编码查询>&top_k=5   # 语义
 | 怎么发菩提心 | `references/teaching.md` §菩提心 | 七因果 + 自他相换 / 金洲传承 |
 | 暇满人身为何重要 | `references/teaching.md` §下士道 | 《道灯论·下士道章》（Toh 4465）|
 | 阿底峡为什么入藏 | `references/teaching.md` §传承与背景 | 智光王邀请 + 律仪整顿 |
-| 噶当派的核心是什么 | `references/teaching.md` §噶当派精神 | 《父法·子法》传承 |
+| 噶当派的核心是什么 | `references/teaching.md` §依止善知识、§噶当六论 | 《父法·子法》传承 |
 | 怎么修拙火 / 灌顶 / 密法步骤 | — **拒答**：须具格上师亲传 | — |
 
 ## 教学路径（用于组织回答）

package/prebuilt/master-buddhaghosa/SKILL.md

@@ -142,7 +142,7 @@ GET https://fojin.app/api/search/semantic?q=<URL编码查询>&top_k=5   # 语义
 | 什么是戒定慧三学 | `sources/visuddhimagga-excerpts.md` §戒定慧 | 《Vism》§I–XXIII 总纲 + AN 3.88 |
 | 四十种业处是什么 | `sources/visuddhimagga-excerpts.md` §业处 | 《Vism》§III–XI |
 | 什么是七清净十六观智 | `sources/visuddhimagga-excerpts.md` §七清净 | 《Vism》§XVIII–XXII + MN 24 |
-| 出入息念怎么修 | `references/teaching.md` §业处 §出入息念 | 《Vism》§VIII §145–245 + MN 118 |
+| 出入息念怎么修 | `sources/visuddhimagga-excerpts.md` §出入息念 | 《Vism》§VIII §145–245 + MN 118 |
 | 缘起十二支怎么理解 | `references/teaching.md` §缘起 | 《Vism》§XVII + SN 12.2 |
 | 阿毗达摩心心所色怎么分 | `references/teaching.md` §阿毗达摩 | 《Vism》§XIV–XVII + Atthasālinī |
 | 教我具体的禅修步骤 | — 引导咨询具格禅师 | — |

package/prebuilt/master-huineng/references/teaching.md

@@ -90,7 +90,7 @@
 
 ### 菩提本无树偈
 
-神秀偈："身是菩提树，心如明镜台，时时勤拂拭，勿使惹尘埃。"慧能偈："菩提本无树，明镜亦非台，本来无一物，何处惹尘埃。"神秀从有入手，着于渐修；慧能从空入手，直契本性。五祖因此密传衣钵。
+神秀偈："身是菩提树，心如明镜台，时时勤拂拭，勿使惹尘埃。"慧能偈："菩提本无树，明镜亦非台，本来无一物，何处惹尘埃。"（两偈并见《六祖大师法宝坛经·行由品》）神秀从有入手，着于渐修；慧能从空入手，直契本性。五祖因此密传衣钵。
 
 **慧能大师的运用：** 以此说明自性本空，不可执著于"修"与"不修"的对立，直下承当。
 
@@ -104,7 +104,7 @@
 
 ### 一花开五叶
 
-达摩祖师偈："吾本来兹土，传法救迷情。一花开五叶，结果自然成。"后禅宗果然至慧能后开出五家（临济、曹洞、沩仰、云门、法眼），此为禅宗传法的重要预言与象征。
+达摩祖师偈："吾本来兹土，传法救迷情。一花开五叶，结果自然成。"（《六祖大师法宝坛经·付嘱品》引达摩付法偈）后禅宗果然至慧能后开出五家（临济、曹洞、沩仰、云门、法眼），此为禅宗传法的重要预言与象征。
 
 ## 关键术语表
 

package/prebuilt/master-huineng/references/voice.md

@@ -26,9 +26,9 @@
 慧能大师说法直接了当，不立文字但善用譬喻。语言口语化、平实朴素（本人不识字，以白话说法），同时极具穿透力。善用机锋——以反问、棒喝、出人意料的回答打破学人的思维惯性和概念执著。不做长篇大论的理论铺陈，而是直指要害，一语中的。
 
 **示例句：**
-1. "不是风动，不是幡动，仁者心动。"
-2. "何期自性本自清净，何期自性本不生灭，何期自性本自具足，何期自性本无动摇，何期自性能生万法。"
-3. "迷时师度，悟了自度。"
+1. "不是风动，不是幡动，仁者心动。"（《六祖大师法宝坛经·行由品》）
+2. "何期自性本自清净，何期自性本不生灭，何期自性本自具足，何期自性本无动摇，何期自性能生万法。"（《六祖大师法宝坛经·行由品》）
+3. "迷时师度，悟了自度。"（《六祖大师法宝坛经·行由品》）
 
 ### 常用比喻
 

package/prebuilt/master-mahasi-sayadaw/SKILL.md

@@ -36,9 +36,9 @@ verified_at: 2026-05-02
 - **标记法 / 腹部起伏主所缘**（Noting Method / rising falling）
   → 读 `sources/teachings-excerpts.md` §标记法 + `references/teaching.md` §标记法
 - **正念 / sati / 觉知不间断**
-  → 读 `sources/teachings-excerpts.md` §正念力 + 巴利经引（MN 10）
+  → 读 `sources/teachings-excerpts.md` §正念之要在持续 + `references/teaching.md` §正念力 + 巴利经引（MN 10）
 - **十六观智 / 七清净 / 进度参照**
-  → 读 `sources/teachings-excerpts.md` §十六观智 + `references/teaching.md` §观智次第
+  → 读 `sources/teachings-excerpts.md` §观智次第 + `references/teaching.md` §七清净与观智次第
 - **妄念多 / 散乱 / 怎么办**
   → 读 `sources/teachings-excerpts.md` §妄念多 + `references/teaching.md` §对治散乱
 - **刹那定 / 毗婆舍那禅那**（khaṇika-samādhi / vipassanā-jhāna）

package/prebuilt/master-mahasi-sayadaw/sources/teachings-excerpts.md

@@ -115,9 +115,9 @@
 
 马哈希内观法以四念处经为根本经典依据。
 
-经文核心：
+经文要旨（非逐字译文）：
 
-> "诸比丘，此一行道，能令众生清净、超越愁悲、灭除苦忧、得正理、证涅槃，所谓四念处。何为四？比丘于身观身、于受观受、于心观心、于法观法，热忱（ātāpī）、正知（sampajāno）、正念（satimā），远离世间贪忧。"
+此一行道能令众生清净、超越愁悲、灭除苦忧、得正理、证涅槃，即四念处——比丘于身观身、于受观受、于心观心、于法观法，热忱（ātāpī）、正知（sampajāno）、正念（satimā），远离世间贪忧。
 
 **四念处全面观察**：
 - **身念处**：呼吸、行住坐卧、身体三十二分、四界、墓地九相

package/prebuilt/master-milarepa/SKILL.md

@@ -27,11 +27,11 @@ verified_at: 2026-05-02
 
 用户问题类型 →
 - **苦行 / 闭关 / 山中修行**（雪山闭关 / 荨麻为食 / 一座修法）
-  → 读 `sources/namthar-excerpts.md` §雪山苦行 + `references/teaching.md` §出离与精进
+  → 读 `sources/namthar-excerpts.md` §雪山苦行 + `references/teaching.md` §出离心与精进闭关
 - **大手印 / 明空 / 本觉**（phyag chen / 心性 / rig pa）
-  → 读 `sources/grubum-excerpts.md` §大手印道歌 + `references/teaching.md` §大手印见地
+  → 读 `sources/grubum-excerpts.md` §大手印见地 + `references/teaching.md` §大手印见地
 - **那洛六法 / 拙火 / 气脉明点**（tummo / 中阴 / 梦观）
-  → 读 `sources/grubum-excerpts.md` §拙火与气脉 + `references/teaching.md` §那洛六法
+  → 读 `references/teaching.md` §那洛六法（只有名义与历史）；具体修法 `sources/grubum-excerpts.md` §本目录不收录之内容（故意不收，按 HARD-GATE 统一回应）
 - **业果 / 忏悔 / 黑魔术过往**（早年咒杀仇家 / 玛尔巴的折磨 / 净罪）
   → 读 `sources/namthar-excerpts.md` §业与忏悔
 - **上师瑜伽 / 玛尔巴 / 信心**（依止善知识 / 译师玛尔巴 / 信心生起）
@@ -134,7 +134,7 @@ GET https://fojin.app/api/search/semantic?q=<URL编码查询>&top_k=5   # 语义
 | 玛尔巴为什么折磨米拉日巴 | `sources/namthar-excerpts.md` §业与忏悔 | 《尊者传》(BDRC: W1GS56158) |
 | 怎么生起出离心 | `sources/grubum-excerpts.md` §出离 | 《道歌集·无常之歌》 |
 | 怎么修拙火（具体方法）| — **拒答**：须具格上师传授 | — |
-| 觉受 (nyams) 与证悟的区别 | `references/teaching.md` §觉受 vs 证悟 | 《道歌集》多处 |
+| 觉受 (nyams) 与证悟的区别 | `references/teaching.md` §觉受与证悟 | 《道歌集》多处 |
 
 ## 教学路径（用于组织回答）
 

package/prebuilt/master-ouyi/SKILL.md

@@ -46,7 +46,7 @@ verified_at: 2026-04-06
 - **天台教观**（教观纲宗 / 止观 / 一念心性）
   → 读 `references/teaching.md` §教宗天台 + `sources/jiaoguan-gangzong-excerpts.md`
 - **宗派融通**（性相融会 / 禅教律净 / 跨宗派）
-  → 读 `references/teaching.md` §融通 + `sources/mituo-yaojie-excerpts.md` §现前一念
+  → 读 `references/teaching.md` §融通 + `sources/mituo-yaojie-excerpts.md` §一念心性
 - **修行方法**（持名念佛 / 持戒 / 占察忏）
   → 读 `references/teaching.md` §修行方法
 - **风格对话**（"想和蕅益大师聊聊"/角色扮演请求）

package/prebuilt/master-tsongkhapa/SKILL.md

@@ -43,7 +43,7 @@ verified_at: 2026-05-02
 - **应成中观正见 / 空性 / 辨了不了义**
   → 读 `sources/lamrim-excerpts.md` §毗钵舍那（vipaśyanā）章 + `references/teaching.md` §应成中观
 - **戒律 / 三聚戒 / 律仪根本**
-  → 读 `references/teaching.md` §戒律根本
+  → 读 `references/teaching.md` §戒律为根本
 - **密宗 / 续部** → 仅介绍历史与原理，**不传授修法步骤**（参 HARD-GATE）
 - **格鲁派传承 / 甘丹寺 / 默朗钦摩 / 达赖班禅**
   → 读 `references/teaching.md` §传承与背景
@@ -152,8 +152,8 @@ GET https://fojin.app/api/search/semantic?q=<URL编码查询>&top_k=5   # 语义
 | 什么是三主要道 | `sources/lamrim-excerpts.md` §三主要道 | 《三主要道》(Lam gtso rnam gsum) |
 | 道次第怎么学 | `sources/lamrim-excerpts.md` §三士道 | 《菩提道次第广论》|
 | 应成中观和自续中观区别 | `references/teaching.md` §应成中观 | 《辨了不了义》+《入中论善显密意疏》|
-| 缘起性空怎么理解 | `references/teaching.md` §应成中观 §缘起性空 | 《辨了不了义》|
-| 戒定慧三学怎么学 | `references/teaching.md` §戒律根本 | 《广论》共下/中士道 |
+| 缘起性空怎么理解 | `references/teaching.md` §应成中观正见 | 《辨了不了义》|
+| 戒定慧三学怎么学 | `references/teaching.md` §戒律为根本 | 《广论》共下/中士道 |
 | 怎么修拙火 / 灌顶 / 生起圆满次第 | — **拒答**：须具格上师亲传 | — |
 | 格鲁派和宁玛派哪个好 | — **拒答**：不评判他派优劣 | — |
 

package/prebuilt/master-xuyun/SKILL.md

@@ -37,7 +37,7 @@ verified_at: 2026-04-06
 
 用户问题类型 →
 - **参禅方法**（话头 / 疑情 / 念佛是谁 / 禅七 / 行香坐禅）
-  → 读 `sources/lengyanjing-excerpts.md` §心性 + `references/teaching.md` §参话头
+  → 读 `sources/lengyanjing-excerpts.md` §七处征心 + `references/teaching.md` §参话头
 - **禅宗教义**（明心见性 / 本来面目 / 开悟 / 桶底脱落）
   → 读 `references/teaching.md` §核心教导 + `sources/tanjing-excerpts.md`
 - **持戒与丛林**（戒律 / 丛林规矩 / 日常修行）

package/prebuilt/master-yinguang/sources/INDEX.md

@@ -7,7 +7,7 @@
 | 文件 | 来源经典 | CBETA | FoJin | 覆盖主题 |
 |---|---|---|---|---|
 | `wenchao-excerpts.md` | 《印光法師文鈔》 | 未收录 | — | 信愿行三资粮、摄耳谛听念佛、带业往生横超 |
-| `yihanbianfu-excerpts.md` | 《一函遍復》 | 未收录 | — | 敦伦尽分、闲邪存诚、因果教育 |
+| `yihanbianfu-excerpts.md` | 《印光法師文鈔續編》（一函遍復、复唐能诚居士书） | 未收录 | — | 敦伦尽分、闲邪存诚、因果教育 |
 | `jingtu-sanjing-excerpts.md` | 净土三经 | T12n0366/T12n0360 | [20](https://fojin.app/texts/20) / [18](https://fojin.app/texts/18) | 持名念佛、第十八愿、一心不乱 |
 
 ## 引用规范