master-skill 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/.claude-plugin/plugin.json +2 -2
  3. package/.cursor-plugin/plugin.json +2 -2
  4. package/README.md +60 -12
  5. package/README_EN.md +57 -11
  6. package/SKILL.md +55 -298
  7. package/gemini-extension.json +2 -2
  8. package/hooks/session-start +40 -2
  9. package/hooks/tests/test_session_start.sh +149 -0
  10. package/package.json +7 -3
  11. package/prebuilt/compare/SKILL.md +1 -1
  12. package/prebuilt/compare/tests/fidelity.jsonl +13 -0
  13. package/prebuilt/master-ajahn-chah/meta.json +17 -1
  14. package/prebuilt/master-atisha/meta.json +17 -1
  15. package/prebuilt/master-buddhaghosa/meta.json +26 -1
  16. package/prebuilt/master-curriculum/SKILL.md +87 -0
  17. package/prebuilt/master-curriculum/references/chan.md +29 -0
  18. package/prebuilt/master-curriculum/references/gelug-madhyamaka.md +33 -0
  19. package/prebuilt/master-curriculum/references/huayan.md +28 -0
  20. package/prebuilt/master-curriculum/references/jingtu.md +29 -0
  21. package/prebuilt/master-curriculum/references/sanlun-zhongguan.md +30 -0
  22. package/prebuilt/master-curriculum/references/theravada-vipassana.md +39 -0
  23. package/prebuilt/master-curriculum/references/tiantai.md +30 -0
  24. package/prebuilt/master-curriculum/references/weishi.md +31 -0
  25. package/prebuilt/master-curriculum/tests/fidelity.jsonl +8 -0
  26. package/prebuilt/master-debate/SKILL.md +274 -0
  27. package/prebuilt/master-debate/meta.json +25 -0
  28. package/prebuilt/master-debate/tests/fidelity.jsonl +8 -0
  29. package/prebuilt/master-fazang/meta.json +25 -0
  30. package/prebuilt/master-huineng/meta.json +37 -0
  31. package/prebuilt/master-huineng/references/teaching.md +1 -1
  32. package/prebuilt/master-huineng/sources/INDEX.md +1 -1
  33. package/prebuilt/master-huineng/sources/tanjing-excerpts.md +17 -1
  34. package/prebuilt/master-kumarajiva/meta.json +16 -0
  35. package/prebuilt/master-kumarajiva/references/teaching.md +2 -2
  36. package/prebuilt/master-mahasi-sayadaw/meta.json +17 -1
  37. package/prebuilt/master-milarepa/meta.json +26 -1
  38. package/prebuilt/master-ouyi/meta.json +17 -0
  39. package/prebuilt/master-ouyi/references/teaching.md +4 -4
  40. package/prebuilt/master-ouyi/sources/INDEX.md +1 -1
  41. package/prebuilt/master-ouyi/sources/jiaoguan-gangzong-excerpts.md +3 -3
  42. package/prebuilt/master-tsongkhapa/meta.json +18 -1
  43. package/prebuilt/master-xuanzang/meta.json +16 -0
  44. package/prebuilt/master-xuanzang/references/teaching.md +5 -5
  45. package/prebuilt/master-xuanzang/references/voice.md +1 -1
  46. package/prebuilt/master-xuyun/meta.json +39 -0
  47. package/prebuilt/master-yinguang/SKILL.md +1 -1
  48. package/prebuilt/master-yinguang/meta.json +17 -0
  49. package/prebuilt/master-yinguang/references/teaching.md +7 -7
  50. package/prebuilt/master-yinguang/references/voice.md +1 -1
  51. package/prebuilt/master-yinguang/sources/INDEX.md +3 -3
  52. package/prebuilt/master-yinguang/sources/wenchao-excerpts.md +4 -4
  53. package/prebuilt/master-yinguang/sources/yihanbianfu-excerpts.md +3 -3
  54. package/prebuilt/master-zhiyi/meta.json +28 -0
  55. package/prebuilt/master-zhiyi/references/teaching.md +2 -2
  56. package/scripts/check-manifest-versions.py +142 -0
  57. package/scripts/tests/test_check_manifest_versions.py +217 -0
  58. package/scripts/tests/test_debate_protocol.py +159 -0
  59. package/scripts/tests/test_validate_cross_critique.py +149 -0
  60. package/scripts/tests/test_validate_curriculum_sources.py +144 -0
  61. package/scripts/tests/test_validate_lore_triggers_content.py +372 -0
  62. package/scripts/tests/test_validate_persona_fidelity.py +317 -0
  63. package/scripts/tests/test_validate_promptfoo_configs.py +386 -0
  64. package/scripts/validate-cross-critique.py +137 -0
  65. package/scripts/validate-curriculum-sources.py +111 -0
  66. package/scripts/validate-fidelity.py +16 -1
  67. package/scripts/validate-lore-triggers-content.py +393 -0
  68. package/scripts/validate-persona-fidelity.py +210 -0
  69. package/scripts/validate-promptfoo-configs.py +383 -0
  70. package/scripts/validate.py +212 -4
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "master-skill",
3
- "description": "Buddhist Master AI Skills — 15 historical masters across 汉传/藏传/南传 with source-cited teachings",
3
+ "description": "Buddhist Master AI Skills — 14 historical masters across 汉传/藏传/南传 plus 3 teaching meta-skills (compare / debate / curriculum), with source-cited teachings",
4
4
  "owner": {
5
5
  "name": "xr843",
6
6
  "email": "xr843@users.noreply.github.com"
@@ -8,8 +8,8 @@
8
8
  "plugins": [
9
9
  {
10
10
  "name": "master-skill",
11
- "description": "Buddhist Master AI teaching personas — 15 prebuilt masters across 汉传/藏传/南传 invokable via /master-<slug> slash commands, with source-cited doctrinal responses (CBETA / BDRC / SuttaCentral / PTS Vism), RAG-grounded in FoJin knowledge graph",
12
- "version": "0.6.0",
11
+ "description": "Buddhist Master AI teaching personas — 14 prebuilt masters across 汉传/藏传/南传 plus 3 teaching meta-skills (compare-masters / master-debate / master-curriculum), invokable via /master-<slug> slash commands, with source-cited doctrinal responses (CBETA / BDRC / SuttaCentral / PTS Vism), RAG-grounded in FoJin knowledge graph",
12
+ "version": "0.8.0",
13
13
  "source": "./",
14
14
  "author": {
15
15
  "name": "xr843",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "master-skill",
3
- "description": "Buddhist Master AI teaching personas — 15 prebuilt masters across 汉传/藏传/南传 invokable via /master-<slug> slash commands, with source-cited doctrinal responses (CBETA / BDRC / SuttaCentral / PTS Vism), RAG-grounded in FoJin knowledge graph",
4
- "version": "0.6.0",
3
+ "description": "Buddhist Master AI teaching personas — 14 prebuilt masters across 汉传/藏传/南传 plus 3 teaching meta-skills (compare-masters / master-debate / master-curriculum), invokable via /master-<slug> slash commands, with source-cited doctrinal responses (CBETA / BDRC / SuttaCentral / PTS Vism), RAG-grounded in FoJin knowledge graph",
4
+ "version": "0.8.0",
5
5
  "author": {
6
6
  "name": "xr843",
7
7
  "email": "xr843@users.noreply.github.com"
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "master-skill",
3
3
  "displayName": "Master Skill",
4
- "description": "Buddhist Master AI teaching personas — 15 prebuilt masters across 汉传/藏传/南传 invokable via /master-<slug> slash commands, with source-cited doctrinal responses (CBETA / BDRC / SuttaCentral / PTS Vism), RAG-grounded in FoJin knowledge graph",
5
- "version": "0.6.0",
4
+ "description": "Buddhist Master AI teaching personas — 14 prebuilt masters across 汉传/藏传/南传 invokable via /master-<slug> slash commands, with source-cited doctrinal responses (CBETA / BDRC / SuttaCentral / PTS Vism), RAG-grounded in FoJin knowledge graph",
5
+ "version": "0.8.0",
6
6
  "author": {
7
7
  "name": "xr843",
8
8
  "email": "xr843@users.noreply.github.com"
package/README.md CHANGED
@@ -6,12 +6,18 @@
6
6
  </p>
7
7
 
8
8
  <p align="center">
9
+ <a href="https://www.npmjs.com/package/master-skill"><img src="https://img.shields.io/npm/v/master-skill.svg?label=npm&color=cb3837" alt="npm version"></a>
10
+ <a href="https://www.npmjs.com/package/master-skill"><img src="https://img.shields.io/npm/dm/master-skill.svg?color=cb3837" alt="npm downloads"></a>
9
11
  <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
10
12
  <img src="https://img.shields.io/badge/Python-3.9+-green.svg" alt="Python 3.9+">
11
13
  <img src="https://img.shields.io/badge/Claude%20Code-Skill-purple.svg" alt="Claude Code Skill">
12
14
  <img src="https://img.shields.io/badge/AgentSkills-Standard-orange.svg" alt="AgentSkills Standard">
13
15
  </p>
14
16
 
17
+ <p align="center">
18
+ <sub><em>Secured by SHA-pinned GitHub Actions · npm provenance · OIDC Trusted Publishing — see <a href="SECURITY.md">SECURITY.md</a>.</em></sub>
19
+ </p>
20
+
15
21
  <p align="center">
16
22
  翻开《瑜伽师地论》百卷,不知从何读起?<br>
17
23
  想学禅宗,不知应当亲近哪位祖师?<br>
@@ -21,7 +27,7 @@
21
27
 
22
28
  <p align="center">
23
29
  <strong>依据三大佛教传统祖师大德的教学风格,通达 AI 学习伙伴</strong><br>
24
- 15 位祖师 · 汉传 / 藏传 / 南传跨传统 · CBETA / BDRC / SuttaCentral / PTS Vism 真实出处 · AgentSkills 标准
30
+ 14 位祖师 · 汉传 / 藏传 / 南传跨传统 · CBETA / BDRC / SuttaCentral / PTS Vism 真实出处 · AgentSkills 标准
25
31
  </p>
26
32
 
27
33
  <p align="center">
@@ -42,10 +48,10 @@
42
48
 
43
49
  ### 👉 [打开 fojin.app/chat](https://fojin.app/chat)
44
50
 
45
- 在 AI 问答页面左下角点击「法师模式」,从 15 位三大传统祖师中选一位即可开始对话。
51
+ 在 AI 问答页面左下角点击「法师模式」,从 14 位三大传统祖师中选一位即可开始对话。
46
52
 
47
53
  - 无需安装、无需注册
48
- - 所有 `/compare-masters` 多祖师对比功能同样可用(含跨传统对比)
54
+ - 三种教学模式均可用:`/compare-masters` 多祖师对比、`/master-debate` 祖师辩论、`/master-curriculum` 学修路径(含跨传统)
49
55
  - 内置 FoJin 的 503 个数据源、678K+ 语义向量做实时经证检索
50
56
  - 每条回答附原典出处(CBETA 经号 / BDRC 藏文典籍号 / SuttaCentral 巴利经号)
51
57
 
@@ -64,19 +70,48 @@
64
70
  | "想学完整的道次第" | `/master-atisha` `/master-tsongkhapa`(噶当三士道 → 格鲁《广论》) |
65
71
  | "想了解上座部论藏体系" | `/master-buddhaghosa`(《清净道论》戒定慧 + 七清净十六观智) |
66
72
  | "想做密集内观禅修" | `/master-mahasi-sayadaw`(缅甸内观 · 标记法 · 腹部起伏) |
67
- | "想跨传统比较看一个问题" | `/compare-masters`(自动配对汉藏南传视角) |
73
+ | "想跨传统比较看一个问题" | `/compare-masters`(自动配对汉藏南传视角)· `/master-debate`(争议议题辩论)· `/master-curriculum`(按传统给学修路径) |
68
74
 
69
75
  > 开发者、Claude Code / Cursor 用户可跳到下方 [开发者安装](#开发者安装) 小节,以 AgentSkill 形式在终端内使用。
70
76
 
71
77
  ---
72
78
 
79
+ ## 效果示例
80
+
81
+ 下面是一次真实的 `/master-huineng`(慧能大师)问答——注意每个教义断言都附 CBETA 经证,且回答风格贴合祖师本人(直指、平实、善用譬喻):
82
+
83
+ ```text
84
+ 你:我想参禅但坐不住、念头太多,该怎么办?
85
+
86
+ 慧能大师:
87
+ 你说「坐不住」,是把坐姿当成了禅;你说「念头太多」,是把念头当成了
88
+ 敌人。这两样都不是禅。
89
+
90
+ 何名坐禅?外于一切善恶境界,心念不起,名为「坐」;内见自性不动,名
91
+ 为「禅」。坐不是腿的事,是心于境上不起执的事。
92
+ 【《六祖大师法宝坛经·坐禅品》】→ https://fojin.app/texts/58
93
+
94
+ 念头来了不必怕。「于诸境上心不染,曰无念」——不是要你没有念头,是念
95
+ 起而不随它跑、不被它粘住。如云过空,空不曾动。
96
+ 【《六祖大师法宝坛经·定慧品》】→ https://fojin.app/texts/58
97
+
98
+ 所以不要和念头打仗。你一对治,就又添一个念。但看念起念灭,知它无
99
+ 住,它自然歇。
100
+
101
+ 如需深入学习,可在 FoJin (fojin.app) 查阅原典。
102
+ ```
103
+
104
+ > ⚠️ 以上为 **AI 合成内容**,依据《坛经》文献生成,不代表慧能大师亲口开示。多位法师并列回答的 `/compare-masters` 效果,可直接在 [fojin.app/chat](https://fojin.app/chat) 体验。
105
+
106
+ ---
107
+
73
108
  > **v0.6 更新(2026-05-02)**:Slash 命令命名空间整理——14 位法师斜杠命令统一加 `master-` 前缀。`/master-zhiyi`、`/master-huineng`、…。
74
109
  > - **目的**:当 Claude Code 已装 50+ skill 时,单词 slash 命令容易混入其他 skill 列表;前缀化让 14 位法师在 `/m<tab>` 补全时聚类,识别度大幅提升
75
110
  > - **未受影响**:`compare-masters` / `create-master` 两个 meta-skill 命令保持原样(避免 `/master-compare-masters` 重复前缀);fojin.app/chat 网页端 dropdown 与 API 完全解耦,**`master_profiles.py` 不变**
76
111
  > - **NPX 安装**:`npx master-skill install zhiyi`(短)和 `install master-zhiyi`(全)皆可,安装目标统一为 `~/.claude/skills/master-<slug>/`
77
112
  > - 详情见 [CHANGELOG.md §0.6.0](CHANGELOG.md#060--2026-05-02)
78
113
  >
79
- > **v0.5 更新(2026-05-02)**:第二轮跨传统扩展——藏传 / 南传各从 1 位扩至 3 位,共 **15 位**祖师。
114
+ > **v0.5 更新(2026-05-02)**:第二轮跨传统扩展——藏传 / 南传各从 1 位扩至 3 位,共 **14 位**祖师。
80
115
  > - 藏传新增:阿底峡尊者(噶当派开祖 · Toh 4465《菩提道灯论》· 三士道)+ 宗喀巴大师(格鲁派创始人 · 三主要道 · 应成中观正见)
81
116
  > - 南传新增:觉音尊者(《清净道论》Visuddhimagga 论师顶峰)+ 马哈希尊者(缅甸内观 · 标记法 · ETHICS Tier B 特例)
82
117
  > - HARD-GATE 强化:马哈希尊者特别 `NO_ATTAINMENT_JUDGMENT`(AI 不得对个体作证果判定)
@@ -102,13 +137,13 @@
102
137
 
103
138
  ## 特性
104
139
 
105
- - **预置十五位三大传统祖师**:8 位汉传(唯识、中观、禅、天台、华严、净土、跨宗派)+ 3 位藏传(阿底峡 · 噶当;宗喀巴 · 格鲁;米拉日巴 · 噶举)+ 3 位南传(觉音 · 上座部论师;马哈希 · 缅甸内观;阿姜查 · 泰国森林)—— 开箱即用
140
+ - **预置十四位三大传统祖师**:8 位汉传(唯识、中观、禅、天台、华严、净土、跨宗派)+ 3 位藏传(阿底峡 · 噶当;宗喀巴 · 格鲁;米拉日巴 · 噶举)+ 3 位南传(觉音 · 上座部论师;马哈希 · 缅甸内观;阿姜查 · 泰国森林)—— 另含 `compare-masters` 多祖师对比 meta-skill,开箱即用
106
141
  - **经文溯源(Provenance)**:每位祖师附原典标识(CBETA / BDRC / SuttaCentral)+ FoJin text ID,所有教义断言强制附原典引证
107
142
  - **离线经文片段**:`sources/` 目录收录核心经典关键段落,FoJin 不可用时仍可离线引用
108
143
  - **渐进式披露**:SKILL.md 以决策树 + Quick Ref 为主,`references/`、`sources/` 按需加载,Context 随查随取
109
144
  - **HARD-GATE 铁律**:`/create-master` 与预置法师内置红线——无 CBETA 引证的教义断言不得写入、不得捏造经号、不得为虚构人物建角色
110
145
  - **二阶段独立审查**:生成管线在写入前强制经过"教义准确性 → 风格一致性"两轮独立审查,FAIL 自动修复最多 2 轮
111
- - **自动化保真度测试**:每位祖师 `tests/fidelity.jsonl` 5 条 Q&A,验证引用和关键词覆盖;CI 在每次推送时 dry-run 验证
146
+ - **自动化保真度测试**:每位祖师 `tests/fidelity.jsonl` 10+ 条 Q&A(`compare-masters` 元技能 18 条),验证引用和关键词覆盖;CI 在每次推送时 dry-run 验证
112
147
  - **多平台统一插件**:Claude Code、Cursor、Codex CLI、OpenCode、Gemini CLI 共用一份 `prebuilt/`,session-start hook 跨平台注入法师列表
113
148
  - **NPX 一键安装**:`npx master-skill install master-zhiyi` 直接部署到 Claude Code
114
149
  - **离线工具链**:`scripts/cite.py`(CBETA 引用查询)、`scripts/query.py`(离线语义检索)、`scripts/validate.py`(frontmatter linter)
@@ -124,23 +159,32 @@
124
159
 
125
160
  ### 安装
126
161
 
127
- **NPX 一键安装(推荐)**
162
+ **NPX 一键安装(推荐,无需常驻)**
128
163
 
129
164
  ```bash
130
165
  # 安装指定祖师
131
166
  npx master-skill install master-zhiyi master-fazang master-huineng
132
167
 
133
- # 安装全部 15 位(三大传统)
168
+ # 安装全部 14 位(三大传统)
134
169
  npx master-skill install --all
135
170
 
136
171
  # 查看可用祖师
137
172
  npx master-skill list
138
173
  ```
139
174
 
175
+ **全局安装(频繁使用 / 离线场景)**
176
+
177
+ ```bash
178
+ npm install -g master-skill # 一次性装到 $PATH
179
+ master-skill install master-zhiyi # 之后省掉 npx,直接调
180
+ master-skill list
181
+ npm update -g master-skill # 升到下一个 minor / patch
182
+ ```
183
+
140
184
  **Claude Code(插件方式)**
141
185
 
142
186
  ```bash
143
- # 即将上线插件市场,目前使用手动安装:
187
+ # npx(上方)与 git clone 手动安装为正式发布渠道:
144
188
  git clone https://github.com/xr843/Master-skill ~/Master-skill
145
189
  cd ~/Master-skill && pip install -r requirements.txt
146
190
  for d in prebuilt/*/; do ln -sf "$(pwd)/$d" ~/.claude/skills/"$(basename $d)"; done
@@ -198,9 +242,13 @@ git clone https://github.com/xr843/Master-skill ~/Master-skill
198
242
  /master-ajahn-chah — 阿姜查(泰国森林禅林派 · 巴蓬寺传承)
199
243
  ```
200
244
 
201
- ### 多法师对比
245
+ ### 教学模式(v0.7)
246
+
247
+ - **`/compare-masters`** — 多位法师对同一问题的并列对比(横向 / 单轮)
248
+ - **`/master-debate`** — 祖师就争议议题做多轮交叉辩论(v0.8 起:**每轮派 fresh subagent**,只携带对方上一轮 ≤80 字摘要 + 本方 cross_critique 弹药;轮数由 `debate_protocol.per_pair_overrides` 决定,默认 4 轮,`huineng-vs-tsongkhapa` / `ouyi-vs-tsongkhapa` 默认 5 轮)
249
+ - **`/master-curriculum`** — 按你的传统(禅 / 净 / 天台 / 华严 / 唯识 / 中观 / 格鲁 / 上座部)与当前位置(L0-L3)给出有时序的学修路径
202
250
 
203
- 同一问题由 2-3 位法师并列回答,展现宗派视角差异:
251
+ **`/compare-masters` 用法示例:**
204
252
 
205
253
  ```
206
254
  # 自动选择相关法师
package/README_EN.md CHANGED
@@ -9,6 +9,8 @@
9
9
  </p>
10
10
 
11
11
  <p align="center">
12
+ <a href="https://www.npmjs.com/package/master-skill"><img src="https://img.shields.io/npm/v/master-skill.svg?label=npm&color=cb3837" alt="npm version"></a>
13
+ <a href="https://www.npmjs.com/package/master-skill"><img src="https://img.shields.io/npm/dm/master-skill.svg?color=cb3837" alt="npm downloads"></a>
12
14
  <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
13
15
  <img src="https://img.shields.io/badge/Python-3.9+-green.svg" alt="Python 3.9+">
14
16
  <img src="https://img.shields.io/badge/Claude%20Code-Skill-purple.svg" alt="Claude Code Skill">
@@ -24,7 +26,7 @@
24
26
 
25
27
  <p align="center">
26
28
  <strong>AI learning companions modeled after historical Buddhist masters across three traditions</strong><br>
27
- 15 pre-built masters · 汉传 / 藏传 / 南传 cross-tradition · CBETA / BDRC / SuttaCentral / PTS Vism citations · AgentSkills Standard
29
+ 14 pre-built masters · 汉传 / 藏传 / 南传 cross-tradition · CBETA / BDRC / SuttaCentral / PTS Vism citations · AgentSkills Standard
28
30
  </p>
29
31
 
30
32
  <p align="center">
@@ -45,10 +47,10 @@
45
47
 
46
48
  ### 👉 [Open fojin.app/chat](https://fojin.app/chat)
47
49
 
48
- On the AI Q&A page, open the **"法师模式"** (Master Mode) dropdown in the bottom-left and pick one of the 15 pre-built masters across three traditions to start chatting.
50
+ On the AI Q&A page, open the **"法师模式"** (Master Mode) dropdown in the bottom-left and pick one of the 14 pre-built masters across three traditions to start chatting.
49
51
 
50
52
  - No install, no signup
51
- - `/compare-masters` multi-master comparison works across traditions too
53
+ - Three teaching modes available: `/compare-masters` (side-by-side comparison), `/master-debate` (4-round dialectic), `/master-curriculum` (time-sequenced study path) — all cross-tradition
52
54
  - Live citation retrieval backed by FoJin's 503 sources and 678K+ semantic embeddings
53
55
  - Every answer carries an authoritative source ID (CBETA for 汉传, BDRC for 藏传, SuttaCentral for 南传)
54
56
 
@@ -67,19 +69,50 @@ On the AI Q&A page, open the **"法师模式"** (Master Mode) dropdown in the bo
67
69
  | "I want a complete graduated path of practice" | `/master-atisha` `/master-tsongkhapa` (Kadam three scopes → Gelug Lamrim) |
68
70
  | "I want the systematic Theravāda commentarial framework" | `/master-buddhaghosa` (*Visuddhimagga* — sīla / samādhi / paññā + 7 purifications · 16 insight knowledges) |
69
71
  | "I want intensive vipassanā with the noting method" | `/master-mahasi-sayadaw` (Burmese · noting · rising-falling) |
70
- | "I want a cross-tradition perspective" | `/compare-masters` (auto-pairs 汉/藏/南 voices) |
72
+ | "I want a cross-tradition perspective" | `/compare-masters` (auto-pairs 汉/藏/南 voices) · `/master-debate` (adversarial dialectic) · `/master-curriculum` (study path by tradition) |
71
73
 
72
74
  > Developers and Claude Code / Cursor users should skip to [Developer Installation](#developer-installation) to use the masters as terminal AgentSkills.
73
75
 
74
76
  ---
75
77
 
78
+ ## What It Looks Like
79
+
80
+ A real `/master-huineng` (Master Huineng, the Sixth Patriarch of Chan) exchange. Note that **every doctrinal claim carries a CBETA citation**, and the voice matches the master himself — direct, plain-spoken, fond of metaphor:
81
+
82
+ ```text
83
+ You: I want to practice Chan, but I can't sit still and my mind is too busy.
84
+
85
+ Master Huineng:
86
+ You say you "can't sit still" — you have mistaken the posture for Chan.
87
+ You say your mind is "too busy" — you have made your thoughts the enemy.
88
+ Neither of these is Chan.
89
+
90
+ What is "sitting in meditation"? When, amid all conditions good and bad,
91
+ no thought arises in the mind — that is "sitting". When you inwardly see
92
+ the self-nature unmoved — that is "Chan". Sitting is not a matter of the
93
+ legs; it is the mind not grasping at objects.
94
+ 【Platform Sutra · Sitting Meditation】→ https://fojin.app/texts/58
95
+
96
+ Do not fear arising thoughts. "Amid all objects the mind is unstained —
97
+ this is called no-thought." It does not mean having no thoughts; it means
98
+ a thought arises yet you do not chase it, do not let it stick. Like a
99
+ cloud crossing the sky — the sky has never moved.
100
+ 【Platform Sutra · Concentration and Wisdom】→ https://fojin.app/texts/58
101
+
102
+ For further study, consult the original texts at FoJin (fojin.app).
103
+ ```
104
+
105
+ > ⚠️ The above is **AI-synthesized content**, generated from the *Platform Sutra*; it does not represent Master Huineng's actual spoken teachings. Masters currently answer in Classical/Modern Chinese — the English here is an illustrative translation. Try the multi-master `/compare-masters` mode directly at [fojin.app/chat](https://fojin.app/chat).
106
+
107
+ ---
108
+
76
109
  > **v0.6 Update (2026-05-02)**: Slash command namespace cleanup — all 14 master slash commands prefixed with `master-`. `/master-zhiyi`, `/master-huineng`, etc.
77
110
  > - **Why**: Claude Code users typically have 50+ skills installed; bare-word slash commands like `/atisha` get scattered. Prefixing clusters all 14 masters under `/m<tab>` for fast discovery.
78
111
  > - **Unaffected**: `compare-masters` and `create-master` meta-skills keep their existing names (avoiding `/master-compare-masters` doublespeak). `fojin.app/chat` web-side dropdown is decoupled — its master IDs stay bare (`atisha`, `huineng`, etc.); backend `master_profiles.py` unchanged.
79
112
  > - **NPX installer**: both `npx master-skill install zhiyi` (short) and `install master-zhiyi` (full) work; install destination is always `~/.claude/skills/master-<slug>/`.
80
113
  > - See [CHANGELOG.md §0.6.0](CHANGELOG.md#060--2026-05-02) for full details.
81
114
  >
82
- > **v0.5 Update (2026-05-02)**: Second cross-tradition expansion — Tibetan and Theravāda each grow from 1 master to 3. Total **15 masters**.
115
+ > **v0.5 Update (2026-05-02)**: Second cross-tradition expansion — Tibetan and Theravāda each grow from 1 master to 3. Total **14 masters**.
83
116
  > - 藏传 added: Atiśa (Kadam founder · Toh 4465 *Bodhipathapradīpa* · three scopes) + Tsongkhapa (Gelug founder · three principal aspects · Madhyamaka prasaṅgika)
84
117
  > - 南传 added: Buddhaghosa (commentarial summit · *Visuddhimagga*) + Mahasi Sayadaw (Burmese vipassanā · noting method · ETHICS Tier B special case)
85
118
  > - HARD-GATE strengthened: Mahasi Sayadaw specifically gets `NO_ATTAINMENT_JUDGMENT` (AI must not confirm any individual's stage of insight)
@@ -103,13 +136,13 @@ This project is built out of respect for Buddhist traditions. All content is gen
103
136
 
104
137
  ## Features
105
138
 
106
- - **15 pre-built masters across three traditions**: 8 汉传 (Yogācāra, Madhyamaka, Chan, Tiantai, Huayan, Pure Land, cross-tradition) + 3 藏传 (Kadam · Atiśa; Gelug · Tsongkhapa; Kagyu · Milarepa) + 3 南传 (Theravāda commentator · Buddhaghosa; Burmese vipassanā · Mahasi Sayadaw; Thai Forest · Ajahn Chah) — ready to use out of the box
139
+ - **14 pre-built masters across three traditions**: 8 汉传 (Yogācāra, Madhyamaka, Chan, Tiantai, Huayan, Pure Land, cross-tradition) + 3 藏传 (Kadam · Atiśa; Gelug · Tsongkhapa; Kagyu · Milarepa) + 3 南传 (Theravāda commentator · Buddhaghosa; Burmese vipassanā · Mahasi Sayadaw; Thai Forest · Ajahn Chah) — plus a `compare-masters` multi-master comparison meta-skill, ready to use out of the box
107
140
  - **Provenance enforcement**: Every master ships with authoritative source IDs (CBETA / BDRC / SuttaCentral) and FoJin text IDs in frontmatter; every doctrinal claim must carry a scriptural citation
108
141
  - **Offline source passages**: `sources/` captures key passages from each master's core canon, so citations still work when FoJin is unreachable
109
142
  - **Progressive disclosure**: SKILL.md is a decision tree + quick reference; `references/` and `sources/` are loaded on demand to keep context lean
110
143
  - **HARD-GATE discipline**: Both `/create-master` and every prebuilt master embed hard rules — no unverified CBETA ID, no uncited doctrinal claim, no fictional personas
111
144
  - **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
112
- - **Automated fidelity tests**: Each master's `tests/fidelity.jsonl` holds 5+ Q&A samples validating citations and keyword coverage; CI runs a dry-run on every push
145
+ - **Automated fidelity tests**: Each master's `tests/fidelity.jsonl` holds 10+ Q&A samples (the `compare-masters` meta-skill holds 18) validating citations and keyword coverage; CI runs a dry-run on every push
113
146
  - **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
114
147
  - **NPX one-shot install**: `npx master-skill install master-zhiyi` drops skills straight into Claude Code
115
148
  - **Offline toolchain**: `scripts/cite.py` (CBETA lookup), `scripts/query.py` (offline semantic search), `scripts/validate.py` (frontmatter linter)
@@ -125,13 +158,22 @@ This project is built out of respect for Buddhist traditions. All content is gen
125
158
 
126
159
  ### Installation
127
160
 
128
- **NPX (recommended)**
161
+ **NPX (recommended, no global state)**
129
162
 
130
163
  ```bash
131
- npx master-skill install --all # Install all 15 masters
164
+ npx master-skill install --all # Install all 14 masters
132
165
  npx master-skill list # List available masters
133
166
  ```
134
167
 
168
+ **Global install (frequent use / offline-friendly)**
169
+
170
+ ```bash
171
+ npm install -g master-skill # Adds the binary to $PATH
172
+ master-skill install master-zhiyi # No more npx prefix
173
+ master-skill list
174
+ npm update -g master-skill # Pull next minor / patch
175
+ ```
176
+
135
177
  **Claude Code**
136
178
 
137
179
  ```bash
@@ -179,9 +221,13 @@ In any AgentSkills-compatible environment (Claude Code / Cursor / Codex CLI / Op
179
221
  /master-ajahn-chah — Ajahn Chah (Thai Forest Tradition · Wat Pah Pong · 1918-1992)
180
222
  ```
181
223
 
182
- ### Compare Masters
224
+ ### Teaching Modes (v0.7)
225
+
226
+ - **`/compare-masters`** — multiple masters answer the same question side-by-side (horizontal, single-turn)
227
+ - **`/master-debate`** — masters from different traditions engage in a 4-round adversarial dialectic (claim → rebut → respond → synthesize + remaining disagreements)
228
+ - **`/master-curriculum`** — given your target tradition and current level (L0-L3), get a time-sequenced study path (foundation → intermediate → advanced + likely blind spots)
183
229
 
184
- Ask the same question to 2-3 masters in parallel and surface the differences between traditions:
230
+ **`/compare-masters` usage examples:**
185
231
 
186
232
  ```
187
233
  # Auto-pick relevant masters