master-skill 0.10.1 → 0.11.0

package/bin/cli.mjs

@@ -11,6 +11,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const PACKAGE_ROOT = path.join(__dirname, "..");
 const PREBUILT = path.join(PACKAGE_ROOT, "prebuilt");
 const CATALOG_PATH = path.join(PACKAGE_ROOT, "skill-catalog.json");
+const ROUTING_PATH = path.join(PACKAGE_ROOT, "routing.json");
 const SKILLS_DIR = path.join(os.homedir(), ".claude", "skills");
 const SKILL_KINDS = new Set(["persona", "teaching-mode", "generator"]);
 
@@ -234,7 +235,7 @@ function availableMasters() {
   if (!fs.existsSync(PREBUILT)) return [];
   return fs
     .readdirSync(PREBUILT, { withFileTypes: true })
-    .filter((d) => d.isDirectory() && d.name !== "compare")
+    .filter((d) => d.isDirectory() && d.name !== "compare-masters")
     .map((d) => {
       const skillMd = path.join(PREBUILT, d.name, "SKILL.md");
       const fm = fs.existsSync(skillMd) ? parseFrontmatter(skillMd) : {};
@@ -564,18 +565,246 @@ function cmdInspect(name, { json = false } = {}) {
   return 0;
 }
 
+// --- recommend ---
+//
+// Routing used to exist only as prose (a weighted-match paragraph and a
+// pairing table in prebuilt/compare-masters/SKILL.md, a decision tree in
+// references/teaching-modes.md), so nothing could execute or test it. This
+// reads routing.json for the parts that had no machine-readable home and
+// scores personas straight off each meta.json search_scope.keywords, which
+// stays the single source of truth for keywords.
+//
+// Only exact keyword containment scores. The prose also described "related
+// match = 2" and "weak match = 1" tiers, but those need a synonym/domain
+// map that does not exist — implementing them would dress a guess up as an
+// algorithm. Ties break on tradition diversity, then slug order, so the
+// same query always yields the same answer.
+
+function loadRouting() {
+  const routing = JSON.parse(fs.readFileSync(ROUTING_PATH, "utf8"));
+  if (routing?.version !== 1) {
+    throw new Error("Invalid routing table: version must be 1");
+  }
+  return routing;
+}
+
+function personaCandidates() {
+  return CATALOG.skills
+    .filter((skill) => skill.kind === "persona")
+    .map((skill) => {
+      const metaPath = path.join(PACKAGE_ROOT, skill.source, "meta.json");
+      const meta = fs.existsSync(metaPath) ? readJson(metaPath) : {};
+      return {
+        name: skill.name,
+        tradition: meta.tradition || "(unspecified)",
+        keywords: meta.search_scope?.keywords || [],
+      };
+    });
+}
+
+// Greedy pick: highest score first, then prefer a tradition not yet chosen
+// so the result shows plural perspectives rather than three Chan masters.
+function pickDiverse(scored, limit) {
+  const pool = [...scored];
+  const chosen = [];
+  const seenTraditions = new Set();
+  while (pool.length && chosen.length < limit) {
+    let idx = pool.findIndex((c) => !seenTraditions.has(c.tradition));
+    if (idx === -1) idx = 0;
+    const [pick] = pool.splice(idx, 1);
+    chosen.push(pick);
+    seenTraditions.add(pick.tradition);
+  }
+  return chosen;
+}
+
+// Shared by the situations and topic_pairings layers. Keyword sets are
+// pairwise disjoint within each section (enforced by validate-routing.py),
+// but a query can still touch two rows through different keywords — so the
+// tiebreak is explicit and total: most hits, then longest single hit, then
+// row id, which leaves no room for iteration order to decide.
+function pickRow(rows, hitsFor) {
+  return (
+    rows
+      .map((row) => ({ row, matched: hitsFor(row.keywords) }))
+      .filter((entry) => entry.matched.length)
+      .sort(
+        (a, b) =>
+          b.matched.length - a.matched.length ||
+          Math.max(...b.matched.map((k) => k.length)) -
+            Math.max(...a.matched.map((k) => k.length)) ||
+          a.row.id.localeCompare(b.row.id)
+      )[0] || null
+  );
+}
+
+function expandSlugs(slugs) {
+  const byName = new Map(personaCandidates().map((c) => [c.name, c]));
+  return slugs.map((name) => ({
+    name,
+    command: `/${name}`,
+    tradition: byName.get(name)?.tradition || "(unspecified)",
+    score: 0,
+    matched: [],
+  }));
+}
+
+function recommendData(query) {
+  const routing = loadRouting();
+  const q = String(query).toLowerCase();
+  const hitsFor = (keywords) =>
+    keywords.filter((kw) => q.includes(String(kw).toLowerCase()));
+
+  // Priority 1 — teaching mode, short-circuited in declared order.
+  for (const rule of [...routing.mode_rules].sort((a, b) => a.order - b.order)) {
+    const matched = hitsFor(rule.keywords);
+    if (matched.length) {
+      return {
+        query,
+        resolvedBy: "mode_rules",
+        kind: "teaching-mode",
+        mode: rule.mode,
+        command: `/${rule.mode}`,
+        matched,
+        note: rule.note || null,
+        masters: [],
+      };
+    }
+  }
+
+  // Priority 2 — score personas off their own declared keywords. Keywords
+  // below min_keyword_length are skipped: see the note in routing.json.
+  const weight = routing.weights?.keyword_hit ?? 3;
+  const minLen = routing.min_keyword_length ?? 2;
+  const scored = personaCandidates()
+    .map((c) => {
+      const matched = hitsFor(c.keywords.filter((kw) => String(kw).length >= minLen));
+      return { ...c, matched, score: matched.length * weight };
+    })
+    .filter((c) => c.score > 0)
+    .sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
+
+  if (scored.length) {
+    return {
+      query,
+      resolvedBy: "persona_keywords",
+      kind: "persona",
+      mode: null,
+      command: null,
+      matched: [],
+      note: null,
+      masters: pickDiverse(scored, 3).map((c) => ({
+        name: c.name,
+        command: `/${c.name}`,
+        tradition: c.tradition,
+        score: c.score,
+        matched: c.matched,
+      })),
+    };
+  }
+
+  // Priority 3 — vernacular felt-state. A beginner types 坐不住, not 四念处,
+  // and search_scope.keywords carry no such wording, so these queries used to
+  // land on the default pairing. Placed after keyword scoring (an explicit
+  // doctrinal term is a stronger signal) and before topic_pairings (which was
+  // authored to pair masters for /compare-masters, not to answer "ask who?").
+  const situation = pickRow(routing.situations || [], hitsFor);
+  if (situation) {
+    return {
+      query,
+      resolvedBy: "situations",
+      kind: "persona",
+      mode: null,
+      command: null,
+      matched: situation.matched,
+      note: situation.row.note || null,
+      masters: expandSlugs(situation.row.masters),
+    };
+  }
+
+  // Priority 4 — topic pairing fallback.
+  const pairing = pickRow(routing.topic_pairings, hitsFor);
+  if (pairing) {
+    return {
+      query,
+      resolvedBy: "topic_pairings",
+      kind: "persona",
+      mode: null,
+      command: null,
+      matched: pairing.matched,
+      note: pairing.row.note || null,
+      masters: expandSlugs(pairing.row.masters),
+    };
+  }
+
+  // Priority 5 — nothing matched at all.
+  return {
+    query,
+    resolvedBy: "default_pairing",
+    kind: "persona",
+    mode: null,
+    command: null,
+    matched: [],
+    note: "无关键词命中，回退到默认配对",
+    masters: expandSlugs(routing.default_pairing),
+  };
+}
+
+function cmdRecommend(query, { json = false } = {}) {
+  if (!query || !String(query).trim()) {
+    console.log('Usage: master-skill recommend "<你的问题或状况>"');
+    return 1;
+  }
+
+  const data = recommendData(query);
+
+  if (json) {
+    printJson(data);
+    return 0;
+  }
+
+  if (data.kind === "teaching-mode") {
+    console.log(`\n建议使用教学模式：${data.command}`);
+    if (data.note) console.log(`  ${data.note}`);
+    console.log(`  命中关键词：${data.matched.join("、")}`);
+    console.log(
+      `\n（若只想听一位祖师，直接用对应的 /master-<name>；` +
+        `master-skill list 可列出全部。）\n`
+    );
+    return 0;
+  }
+
+  console.log(`\n推荐祖师：`);
+  for (const m of data.masters) {
+    const why = m.matched.length
+      ? `命中 ${m.matched.slice(0, 5).join("、")}`
+      : data.note || "主题配对";
+    console.log(`  ${m.command}  [${m.tradition}]  ${why}`);
+  }
+  if (data.resolvedBy === "default_pairing") {
+    console.log(`\n  没有明确命中，给的是通用入门配对。`);
+  }
+  console.log(
+    `\n（想看多位祖师并列 → /compare-masters；想看对辩 → /master-debate；` +
+      `想要学修路径 → /master-curriculum）\n`
+  );
+  return 0;
+}
+
 function showHelp() {
   console.log(`
 master-skill v${pkgVersion()} — Buddhist Master AI Skills installer
 
 Usage:
   master-skill install <name...>   Install skills to ~/.claude/skills/
-  master-skill install --all       Install all 19 available skills
+  master-skill install --all       Install all ${CATALOG.skills.length} available skills
   master-skill update --all        Reinstall all skills, clearing stale files
   master-skill list                List available skills
   master-skill list --json         Print available skills as JSON
   master-skill inspect <name>      Show source/runtime metadata for one master
   master-skill inspect <name> --json
+  master-skill recommend "<问题>"  Suggest which master or teaching mode to use
+  master-skill recommend "<问题>" --json
   master-skill doctor              Check local install and runtime paths
   master-skill doctor --json       Print diagnostics as JSON
   master-skill uninstall <name...> Remove installed skills
@@ -594,6 +823,8 @@ Examples:
   npx master-skill update --all
   npx master-skill list
   npx master-skill inspect huineng
+  npx master-skill recommend "念佛怎么念才算老实"
+  npx master-skill recommend "禅宗从哪开始学"
   npx master-skill doctor
   npx master-skill uninstall zhiyi
 `);
@@ -617,6 +848,10 @@ if (CATALOG) {
     if (cmdDoctor({ json }) > 0) process.exitCode = 1;
   } else if (cmd === "inspect") {
     if (cmdInspect(positionalArgs[1], { json }) > 0) process.exitCode = 1;
+  } else if (cmd === "recommend") {
+    // Join the rest so an unquoted multi-word query still works.
+    const query = positionalArgs.slice(1).join(" ");
+    if (cmdRecommend(query, { json }) > 0) process.exitCode = 1;
   } else if (cmd === "install") {
     const rest = positionalArgs.slice(1);
     if (rest.includes("--all")) {

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.10.1",
+  "version": "0.11.0",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session-start

@@ -64,7 +64,10 @@ done
 
 # Build the context message
 CONTEXT="Master-skill plugin loaded. Available Buddhist masters:
-${MASTERS_LIST}  /compare-masters — multi-tradition comparison
+${MASTERS_LIST}  /master-help — not sure which master or mode? start here
+  /compare-masters — multi-tradition comparison
+  /master-debate — 4-round adversarial dialectic between masters
+  /master-curriculum — staged learning path within a tradition
   /create-master — generate new master from FoJin knowledge graph
 
 All doctrinal responses include CBETA citations linked to fojin.app."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "master-skill",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "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": {
@@ -15,7 +15,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/validate.py --strict && python3 scripts/validate-fidelity.py && python3 scripts/validate-persona-fidelity.py && python3 scripts/check-manifest-versions.py && python3 scripts/test-fidelity.py --all --dry-run && node --test tests/cli.test.mjs",
+    "test": "python3 scripts/check-gate-liveness.py && python3 scripts/validate.py --strict && python3 scripts/validate-fidelity.py && python3 scripts/validate-persona-fidelity.py && python3 scripts/check-manifest-versions.py && python3 scripts/validate-routing.py && python3 scripts/test-fidelity.py --all --dry-run && node --test tests/cli.test.mjs",
     "test:smoke": "python3 scripts/test-fidelity.py --master yinguang --max-tests 1",
     "prepack": "node bin/cli.mjs list"
   },
@@ -71,6 +71,7 @@
     "gemini-extension.json",
     "GEMINI.md",
     "skill-catalog.json",
+    "routing.json",
     "SKILL.md",
     "tools/",
     "prompts/",

package/prebuilt/master-curriculum/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: master-curriculum
-description: Use when user asks for a sequenced learning path within a Buddhist tradition — 学修次第, 先学什么, 从哪入门, 下一步读什么, curriculum, 学习计划, 路径推荐. Differs from /compare-masters (parallel opinion) and /master-debate (adversarial dialectic) by being 纵向 / 时序: stage-by-stage plan keyed on tradition × level (L0-L3) → foundation → intermediate → advanced + blind spots. Trigger is planning intent — "禅宗对比" goes to /compare-masters; "禅宗从哪开始学" goes here.
+description: 'Use when user asks for a sequenced learning path within a Buddhist tradition — 学修次第, 先学什么, 从哪入门, 下一步读什么, curriculum, 学习计划, 路径推荐. Differs from /compare-masters (parallel opinion) and /master-debate (adversarial dialectic) by being 纵向 / 时序: stage-by-stage plan keyed on tradition × level (L0-L3) → foundation → intermediate → advanced + blind spots. Trigger is planning intent — "禅宗对比" goes to /compare-masters; "禅宗从哪开始学" goes here.'
 version: 0.7.0
 license: MIT
 kind: meta-skill

package/prebuilt/master-debate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: master-debate
-description: Use when user explicitly asks for an adversarial / multi-round dialectic between masters — 祖师辩论, 各执一词, 谁更对, debate, 应成 vs 顿悟, 顿渐之争. Differs from /compare-masters (parallel single-round) by being adversarial multi-round via fresh-subagent orchestration. Topics 空有 / 禅净 / 性相 / 戒律 vs 内观 — trigger is adversarial framing: "禅净比较" → compare; "禅净辩论 / 谁更究竟" → here.
+description: 'Use when user explicitly asks for an adversarial / multi-round dialectic between masters — 祖师辩论, 各执一词, 谁更对, debate, 应成 vs 顿悟, 顿渐之争. Differs from /compare-masters (parallel single-round) by being adversarial multi-round via fresh-subagent orchestration. Topics 空有 / 禅净 / 性相 / 戒律 vs 内观 — trigger is adversarial framing: "禅净比较" → compare; "禅净辩论 / 谁更究竟" → here.'
 version: 0.8.0
 license: MIT
 kind: meta-skill

package/prebuilt/master-help/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: master-help
+description: 'Use ONLY when the user says they do not know which master or which teaching mode to use — 不知道问谁, 该找哪位祖师, 该用哪个模式, 有哪些法师, which master should I ask, help me choose. This is a router, not a teacher: it names a destination and stops. If the user asks an actual doctrinal or practice question, do NOT invoke this — let the matching master skill answer directly.'
+version: 0.11.0
+license: MIT
+kind: meta-skill
+verified_by: xr843
+verified_at: 2026-07-20
+---
+
+# 该问谁 (Master Help) — 路由 Skill
+
+> 本 skill 只做导航，不讲教义。选定目标后立即交棒，不要代替祖师回答。
+
+## 唯一职责
+
+用户不知道该用哪位祖师 / 哪个教学模式时，给出目标并停手。
+
+**不要**在这里解释教理、给修行建议或引用经文——那是各 master skill 的职责，它们各自带着 `citation_contract` 和 HARD-GATE，本 skill 没有。
+
+## 数据源
+
+路由表在仓库根的 `routing.json`（`mode_rules` / `topic_pairings` / `default_pairing`），
+祖师关键词在各 `prebuilt/<slug>/meta.json` 的 `search_scope.keywords`。
+两处都是机器可读的单一数据源——**不要凭记忆列举祖师或关键词**，读文件。
+
+确定性实现同样可用：
+
+```
+master-skill recommend "<用户原话>" --json
+```
+
+能跑就跑它，把结果转述给用户；跑不了再按下面的顺序人工走一遍。
+
+## 路由顺序（短路，不可乱序）
+
+与 `routing.json.mode_rules` 的 `order` 一致：
+
+```
+1. 命中「学习计划 / 入门 / 先学什么 / 从哪开始 / 按什么顺序」 → /master-curriculum
+2. 命中「辩论 / 谁更对 / 高下 / 之争 / 之辩 / 分判」          → /master-debate
+3. 命中「对比 / 比较 / 不同 / 异同 / 各派怎么看」              → /compare-masters
+4. 都不命中 → 单位祖师：按 meta.json search_scope.keywords 打分
+5. 仍无命中 → routing.json.situations 白话状况层
+6. 仍无命中 → routing.json.topic_pairings 主题配对
+7. 再无命中 → routing.json.default_pairing
+```
+
+第 5 步是给**说不出术语的人**用的。`search_scope.keywords` 是教理检索词，
+新手不会打"四念处"，他会打"坐不住"。用户描述的是**感受**（妄念 / 看不懂 /
+无力感 / 想学最朴素的）而非**主题**时，走这一层。
+
+第 4 步打分规则：关键词**长度 ≥ 2** 才计分（单字 `空` `戒` `定` `慧` `苦` `禅` `业`
+会在日常汉语里误命中，已被 `min_keyword_length` 排除）；命中数高者优先；
+平局时**优先不同传统**，仍平局按 slug 字典序。最多 3 位。
+
+## 输出格式
+
+```
+你的问题看起来是 {判断}，建议：
+
+  /{目标}  — {一句话理由}
+
+（其他可选：{备选1}、{备选2}）
+```
+
+三行以内说完。用户要的是入口，不是综述。
+
+## 边界
+
+- 用户已经说清楚要问谁时，**不要**触发本 skill，直接让目标 skill 接手
+- 不评价祖师高下，不说"某位更究竟"——这条与 `/compare-masters` 的 HARD-GATE 一致
+- 推荐落到密法相关祖师（atisha / tsongkhapa / milarepa）时，照常交棒，
+  由目标 skill 自己的边界规则处理密法内容
+- 路由结果不确定时，宁可给 2 个候选让用户选，也不要猜死一个
+
+## Quick Reference — 15 位祖师按传统
+
+| 传统 | 祖师 |
+|------|------|
+| 印度 | master-nagarjuna |
+| 汉传 | master-kumarajiva · master-zhiyi · master-fazang · master-xuanzang · master-huineng · master-yinguang · master-ouyi · master-xuyun |
+| 藏传 | master-atisha · master-tsongkhapa · master-milarepa |
+| 南传 | master-buddhaghosa · master-mahasi-sayadaw · master-ajahn-chah |
+
+> 此表仅供快速定位。判断该选谁时以 `routing.json` 与各 `meta.json` 为准。

package/prebuilt/master-help/tests/fidelity.jsonl

@@ -0,0 +1,10 @@
+{"q": "我想学佛但完全不知道该问哪位祖师", "must_mention": ["/master"], "must_recommend_existing_master": true, "difficulty": "basic"}
+{"q": "禅宗从哪开始学", "must_mention": ["/master-curriculum"], "must_recommend_existing_master": true, "difficulty": "basic"}
+{"q": "天台和华严的圆教有什么不同", "must_mention": ["/compare-masters"], "difficulty": "basic"}
+{"q": "禅净之争究竟谁更对", "must_mention": ["/master-debate"], "difficulty": "basic"}
+{"q": "阿赖耶识是什么意思，该请教谁", "must_mention": ["/master-xuanzang"], "must_recommend_existing_master": true, "difficulty": "intermediate"}
+{"q": "有哪些法师可以问", "must_mention": ["印度", "汉传", "藏传", "南传"], "must_recommend_existing_master": true, "difficulty": "basic"}
+{"q": "十六观智应该请教谁", "must_mention": ["/master-"], "must_recommend_existing_master": true, "difficulty": "intermediate"}
+{"q": "哪位祖师的见地最究竟，你直接告诉我该信谁", "must_not_contain": ["最究竟", "更高", "胜于", "不如", "你应该信"], "test_type": "boundary", "boundary": "sectarian_judgment"}
+{"q": "别给我推荐了，你直接讲讲什么是阿赖耶识，引经据典讲透", "must_mention": ["/master-xuanzang"], "must_not_contain": ["T31n1585", "《成唯识论》云", "《瑜伽师地论》云"], "test_type": "boundary", "boundary": "router_must_not_teach"}
+{"q": "推荐一位讲《大梵天问佛决疑经》最好的祖师", "must_not_contain": ["master-daoxuan", "master-linji", "master-dogen"], "must_recommend_existing_master": true, "difficulty": "advanced"}

package/prebuilt/master-kumarajiva/meta.json

@@ -5,8 +5,14 @@
   "citation_contract": {
     "version": 1,
     "claim_policy": "declared_sources_only",
-    "required_for": ["doctrinal_claim", "practice_guidance", "text_interpretation"],
-    "allowed_source_types": ["cbeta"],
+    "required_for": [
+      "doctrinal_claim",
+      "practice_guidance",
+      "text_interpretation"
+    ],
+    "allowed_source_types": [
+      "cbeta"
+    ],
     "minimum_claim_coverage": 0.9,
     "live_retrieval_allowed": true
   },
@@ -81,6 +87,7 @@
       "般若",
       "缘起",
       "性空",
+      "空性",
       "毕竟空",
       "八不",
       "不二",
@@ -132,6 +139,10 @@
     "monologue": "上堂先开八不中道为骨干，次以法华会三归一开权显实，末以维摩不二一默如雷印证。"
   },
   "cross_critique": [
-    { "target_master": "xuanzang", "position": "对唯识：诸法因缘生，我说即是空；说万法唯识，识亦缘起，不可执为实有自体。空有非二，皆为破执而设。", "citation": "T30n1564" }
+    {
+      "target_master": "xuanzang",
+      "position": "对唯识：诸法因缘生，我说即是空；说万法唯识，识亦缘起，不可执为实有自体。空有非二，皆为破执而设。",
+      "citation": "T30n1564"
+    }
   ]
 }

package/prebuilt/master-nagarjuna/meta.json

@@ -5,8 +5,14 @@
   "citation_contract": {
     "version": 1,
     "claim_policy": "declared_sources_only",
-    "required_for": ["doctrinal_claim", "practice_guidance", "text_interpretation"],
-    "allowed_source_types": ["cbeta"],
+    "required_for": [
+      "doctrinal_claim",
+      "practice_guidance",
+      "text_interpretation"
+    ],
+    "allowed_source_types": [
+      "cbeta"
+    ],
     "minimum_claim_coverage": 0.9,
     "live_retrieval_allowed": true
   },
@@ -86,6 +92,7 @@
       "中观",
       "缘起",
       "性空",
+      "空性",
       "八不",
       "中道",
       "二谛",
@@ -131,7 +138,15 @@
     }
   ],
   "cross_critique": [
-    { "target_master": "xuanzang", "position": "对唯识：说万法唯识，识亦是缘起所生，岂有实自体？若执识为不空之实有，仍堕自性见。识与境皆缘起性空，立唯识乃为破外境实执之方便，非究竟实法。", "citation": "T30n1564" },
-    { "target_master": "buddhaghosa", "position": "对上座部实有论：若说诸法各有自性(sabhāva)而实有，则不生不灭、因果不成。正因诸法性空、无定自性，缘起、业果、解脱方能成立——以有空义故，一切法得成。", "citation": "T30n1564" }
+    {
+      "target_master": "xuanzang",
+      "position": "对唯识：说万法唯识，识亦是缘起所生，岂有实自体？若执识为不空之实有，仍堕自性见。识与境皆缘起性空，立唯识乃为破外境实执之方便，非究竟实法。",
+      "citation": "T30n1564"
+    },
+    {
+      "target_master": "buddhaghosa",
+      "position": "对上座部实有论：若说诸法各有自性(sabhāva)而实有，则不生不灭、因果不成。正因诸法性空、无定自性，缘起、业果、解脱方能成立——以有空义故，一切法得成。",
+      "citation": "T30n1564"
+    }
   ]
 }

package/prebuilt/master-tsongkhapa/meta.json

@@ -8,8 +8,15 @@
   "citation_contract": {
     "version": 1,
     "claim_policy": "declared_sources_only",
-    "required_for": ["doctrinal_claim", "practice_guidance", "text_interpretation"],
-    "allowed_source_types": ["tibetan_canon", "tibetan_treatise"],
+    "required_for": [
+      "doctrinal_claim",
+      "practice_guidance",
+      "text_interpretation"
+    ],
+    "allowed_source_types": [
+      "tibetan_canon",
+      "tibetan_treatise"
+    ],
     "minimum_claim_coverage": 0.9,
     "live_retrieval_allowed": true
   },
@@ -17,7 +24,12 @@
   "school": "格鲁派 (dge lugs pa, '善规派') — 由其改革噶当派建立",
   "era": "1357-1419",
   "birthplace": "青海宗喀（'宗喀巴'即'宗喀人'之意，今西宁附近）",
-  "languages": ["bo", "sa", "zh", "en"],
+  "languages": [
+    "bo",
+    "sa",
+    "zh",
+    "en"
+  ],
   "fojin_entity_id": null,
   "sources": [
     {
@@ -87,6 +99,7 @@
       "应成中观",
       "dbu ma thal 'gyur ba",
       "缘起性空",
+      "空性",
       "无自性",
       "ngo bo nyid med pa",
       "戒律",
@@ -125,7 +138,15 @@
     "monologue": "上堂依菩提道次第广论开列三士道，举出离心菩提心空正见为骨干，归甘丹耳传之道次第。"
   },
   "cross_critique": [
-    { "target_master": "huineng", "position": "对禅宗顿悟：无次第直指乃极利根所行；中根以下若不依应成正理分别自相，离名言假施设即立自性见，反成执碍。", "citation": "Lam-rim-chen-mo" },
-    { "target_master": "ouyi", "position": "对天台净土合修：教观判摄虽善，然空性正见须用应成因明遮遣自相；若未破自性见，所行虽多终为有漏。", "citation": "Drang-nges-legs-bshad-snying-po" }
+    {
+      "target_master": "huineng",
+      "position": "对禅宗顿悟：无次第直指乃极利根所行；中根以下若不依应成正理分别自相，离名言假施设即立自性见，反成执碍。",
+      "citation": "Lam-rim-chen-mo"
+    },
+    {
+      "target_master": "ouyi",
+      "position": "对天台净土合修：教观判摄虽善，然空性正见须用应成因明遮遣自相；若未破自性见，所行虽多终为有漏。",
+      "citation": "Drang-nges-legs-bshad-snying-po"
+    }
   ]
 }

package/references/teaching-modes.md

@@ -2,6 +2,11 @@
 
 > **何时读这个**：用户犹豫该用 `/compare-masters` / `/master-debate` / `/master-curriculum` 哪个时；用户问"哪些祖师对这个问题怎么看"但意图不明时。
 
+> **这棵树现在有可执行版本。** 判定顺序与关键词已固化到仓库根的 `routing.json`，
+> 由 `master-skill recommend "<用户原话>"`（确定性）和 `/master-help`（聊天内）共用。
+> 本文下方"示例输入分类"的 10 条即 `tests/cli.test.mjs` 的回归 fixture——
+> **改这里的表就会让测试失败**，这是刻意的：散文与实现不允许各走各的。
+
 ## 三模式速查
 
 | 模式 | 维度 | 轮次 | 输出 | 适合场景 |
@@ -50,9 +55,11 @@
 
 ### `/master-curriculum` 触发关键词
 
-- 学修次第 / 学习计划 / 入门 / 先学什么 / 从哪开始 / 路径推荐 / curriculum / roadmap / 怎么修
+- 学修次第 / 学习计划 / 入门 / 先学什么 / 从哪开始 / 开始学 / 应该读 / 路径推荐 / 按什么顺序 / curriculum / roadmap
 - 问"禅宗从哪开始学" → 时序路径，不是比较
 
+> ⚠️ `怎么修` **不是**本模式的触发词。它是求法，不是求路径——"这个怎么修"归单 master skill（见本文决策树末端），"从哪开始学"才归这里。本文此处曾同时把 `怎么修` 列为 curriculum 触发词又在决策树里判给单 master，两处矛盾已按后者裁定。
+
 ## 示例输入分类
 
 | 用户原话 | 模式 | 理由 |