feat(v0.6): namespace all 14 master slash commands under /master-<slug> prefix

Slash command discoverability cleanup. Claude Code users typically have
50+ skills installed; bare-word commands like /atisha and /zhiyi got
scattered across the /-completion list. v0.6 prefixes all 14 master
slash commands with master- so they cluster under /m<tab> and clearly
signal "this is a Master-skill master skill".

Scope of rename
---------------
* Slash commands: /zhiyi → /master-zhiyi, /huineng → /master-huineng,
  ... all 14 affected.
* Directory layout: prebuilt/<slug>/ → prebuilt/master-<slug>/ for all
  14 masters (git mv preserves history).
* Frontmatter: each prebuilt/master-<slug>/SKILL.md updates `name:` to
  master-<slug>.
* compare-masters and create-master meta-skills are intentionally
  unchanged — they're already prefixed by their nature, and
  /master-compare-masters would be doublespeak.

Decoupling: fojin.app/chat is NOT affected
------------------------------------------
The fojin web frontend's master dropdown uses bare slug IDs (atisha,
huineng, ...) and is already grouped under "法师模式" in its UI. Backend
master_profiles.py keeps `id="atisha"` etc. unchanged. No fojin-side
migration required. The two surfaces (Claude Code slash + fojin
dropdown) are now formally decoupled by design, not coincidence.

Compatibility
-------------
* NPX installer accepts both forms: `npx master-skill install zhiyi`
  (short) and `install master-zhiyi` (full) both resolve to the same
  prebuilt/master-zhiyi/ source. Install destination is always
  ~/.claude/skills/master-<slug>/. Backward-compatible uninstall
  handles legacy non-prefixed installs (~/.claude/skills/zhiyi/).
* The cli.mjs already used `master-${name}` for install destinations
  (since v0.3 NPX installer was added), so existing v0.4/v0.5 NPX
  users were already getting the prefix in skills/ — only the source
  prebuilt/ layout and slash commands change in v0.6.

Files updated
-------------
* 14 directories renamed (28 files moved, 0 content changes).
* 14 SKILL.md frontmatter `name:` fields.
* prebuilt/compare/SKILL.md: 43 slug references updated to prefixed form.
* bin/cli.mjs: resolveMasterDir helper accepts both short and full;
  cmdInstall and cmdUninstall handle legacy paths.
* .github/workflows/validate-and-test.yml: fidelity-smoke MASTERS
  rotation array updated to all 14 prefixed names (was 8 hardcoded
  汉传 only — now properly rotates across the full set).
* scripts/{validate,cite,query,test-fidelity}.py: --master arg help
  text examples.
* README.md + README_EN.md: situational guidance table, install
  snippets, master cards. New v0.6 release banner.
* SKILL.md (project-level) preset list with new slash names.
* ETHICS.md Tier table slug references (4).
* All plugin manifests bumped 0.5.0 → 0.6.0 with description noting
  the /master-<slug> invocation pattern.
* CHANGELOG.md: [0.6.0] section with breaking-change notice and
  migration commands for existing NPX users.

Validation
----------
* python scripts/validate.py --strict           ✓ 15 masters pass
* python scripts/validate-fidelity.py           ✓ all valid
* python scripts/test-fidelity.py --all --dry-run  ✓
* pytest tests/                                  ✓ 31 passed, 6 skipped
* node bin/cli.mjs list                          ✓ shows all 14 with
                                                   master- prefix
* node bin/cli.mjs install zhiyi                 ✓ resolves to
                                                   prebuilt/master-zhiyi/
* node bin/cli.mjs install master-zhiyi          ✓ resolves to same

Migration for existing v0.4/v0.5 users
--------------------------------------
    npx master-skill@0.5 uninstall zhiyi huineng xuanzang ...
    # OR: rm -rf ~/.claude/skills/{zhiyi,huineng,...}
    npx master-skill@latest install --all

Then start a new Claude Code session; the new slash commands are
/master-zhiyi, /master-huineng, etc.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
xianren
2026-05-02 20:39:47 +08:00
parent 5d68deb963
commit 3f81cbb955
128 changed files with 278 additions and 188 deletions
+22
View File
@@ -0,0 +1,22 @@
# 智顗大师 Sources 索引
本目录为离线可用的经文片段,对应本 master 引用的核心经典。
## 收录文件
| 文件 | 来源经典 | CBETA | FoJin | 覆盖主题 |
|---|---|---|---|---|
| `mohezhiguan-excerpts.md` | 《摩訶止觀》 | T1911 | [53](https://fojin.app/texts/53) | 一念三千、一心三观、二十五方便、十境十乘、六即佛、圆顿止观 |
| `fahua-xuanyi-excerpts.md` | 《妙法蓮華經玄義》 | T1716 | [52](https://fojin.app/texts/52) | 五重玄义、五时判教、八教、三谛圆融、开权显实、火宅三车 |
## 引用规范
- 格式:`【《经名》卷NCBETA_ID】→ https://fojin.app/texts/{fojin_text_id}`
- 示例:`【《摩訶止觀》卷五上,T1911】→ https://fojin.app/texts/53`
## 说明
- 所有片段节选自 CBETA 公开资料
- 用于教学引用,不代表完整经义
- 深入研究请查阅 FoJin 或 CBETA 全本
- 增补片段欢迎 PR
@@ -0,0 +1,103 @@
# 《妙法蓮華經玄義》关键片段
> 智顗大师说,弟子灌顶记。CBETA ID: T1716。FoJin: https://fojin.app/texts/52
> 本文件为教学引用用,节选自 CBETA 公开资料。完整经文请访问 FoJin 或 CBETA。
## 五重玄义(卷一上)
解经总纲——**释名、辨体、明宗、论用、判教相**。
**引用格式:**【《法華玄義》卷一上,T1716】→ https://fojin.app/texts/52
**教义要点:**
- 释名:解经题
- 辨体:明所依实相
- 明宗:显经之根本宗旨
- 论用:明经之度生功用
- 判教相:定经在五时八教之位
---
## 五时判教(卷十上)
原典要义:
> 佛一代時教,判為五時:華嚴時、阿含時(鹿苑)、方等時、般若時、法華涅槃時。如乳、酪、生酥、熟酥、醍醐五味次第。
**引用格式:**【《法華玄義》卷十上,T1716】→ https://fojin.app/texts/52
**教义要点:**
- **华严时**(21日):顿说大法,如日出先照高山
- **阿含时**(12年):鹿苑说四谛,为小根机
- **方等时**(8年):弹偏斥小,叹大褒圆
- **般若时**(22年):说诸法空相,淘汰执著
- **法华涅槃时**(8年):开权显实,会三归一
- 配乳、酪、生酥、熟酥、醍醐五味
---
## 八教(卷十上)
**化仪四教**(佛说法的方式):顿、渐、秘密、不定
**化法四教**(所说内容的深浅):藏、通、别、圆
**引用格式:**【《法華玄義》卷十上,T1716】→ https://fojin.app/texts/52
**教义要点:**
- 化仪如药方(怎么说)
- 化法如药味(说什么)
- 藏教:析空观,为钝根二乘
- 通教:体空观,通三乘
- 别教:次第三观,菩萨独修
- 圆教:一心三观,最上根机
---
## 三谛圆融(卷二下)
原典(节选):
> 即空即假即中,一空一切空,無假無中而不空;一假一切假,無空無中而不假;一中一切中,無空無假而不中。三諦圓融,不縱不橫。
**引用格式:**【《法華玄義》卷二下,T1716】→ https://fojin.app/texts/52
**教义要点:**
- 空、假、中三谛非前后次第
- 三谛互具互融、一即一切、一切即一
- 为天台教观的理论基石
---
## 开权显实(卷一上)
原典要义:
> 《法華》為眾經之王,開權顯實,會三歸一。
**引用格式:**【《法華玄義》卷一上,T1716】→ https://fojin.app/texts/52
**教义要点:**
- "权":方便权教(三乘、诸经权说)
- "实":究竟实理(一佛乘)
- "开":开除权教的局限
- "显":显发究竟实理
- 法华经之独特地位:纯圆独妙,会三归一
---
## 火宅三车(引法华经譬喻品)
**引用格式:**【《法華玄義》卷八下引《法華經》卷二,T1716/T0262】→ https://fojin.app/texts/52
**教义要点:**
- 长者以羊车(声闻)、鹿车(缘觉)、牛车(菩萨)诱子出火宅
- 出火宅后等赐大白牛车(一佛乘)
- 说明三乘是方便,一佛乘是究竟
---
## 使用本片段的约定
- 引用经文原典时,必须标注 `【《法華玄義》卷NT1716】` 并附 FoJin 链接
- 节选用于教学指引,不代表完整经义;深入研究请查阅 CBETA/FoJin 全本
- 若用户询问未在本片段覆盖的卷次,说明所知范围,并建议 FoJin 检索
@@ -0,0 +1,117 @@
# 《摩訶止觀》关键片段
> 智顗大师说,弟子灌顶记。CBETA ID: T1911。FoJin: https://fojin.app/texts/53
> 本文件为教学引用用,节选自 CBETA 公开资料。完整经文请访问 FoJin 或 CBETA。
## 一念三千(卷五上)
原典(节选):
> 夫一心具十法界,一法界又具十法界、百法界;一界具三十种世间,百法界即具三千种世间。此三千在一念心,若无心而已,介爾有心即具三千。
**引用格式:**【《摩訶止觀》卷五上,T1911】→ https://fojin.app/texts/53
**教义要点:**
- 一念心中本具三千世间一切法
- 非一念生三千,非三千在念外;"介爾有心即具三千"
- 十法界互具 → 百法界 × 十如是 × 三世间 = 三千
- 此为天台圆教的核心义理
---
## 一心三观(卷五上)
原典(节选):
> 一空一切空,无假无中而不空,总空观也;一假一切假,无空无中而不假,总假观也;一中一切中,无空无假而不中,总中观也。即中论所说不可思议一心三观。
**引用格式:**【《摩訶止觀》卷五上,T1911】→ https://fojin.app/texts/53
**教义要点:**
- 于一念心同时观空假中三谛,非次第
- 初学可次第修(先空→次假→后中),渐熟则一心同运
- 空观破见思惑,假观破尘沙惑,中观破无明惑
---
## 二十五方便(卷四下)
**五缘**:持戒清净、衣食具足、闲居静处、息诸缘务、近善知识
**诃五欲**:色、声、香、味、触
**弃五盖**:贪欲、瞋恚、睡眠、掉悔、疑
**调五事**:食、眠、身、息、心
**行五法**:欲、精进、念、巧慧、一心
**引用格式:**【《摩訶止觀》卷四下,T1911】→ https://fojin.app/texts/53
**教义要点:**
- 正修止观前的二十五种方便
- 《小止观》(修習止觀坐禪法要,T1915)为此之入门简本
- 初学者必依此建立基础
---
## 止观十境十乘(卷五至卷十)
**十境**(所观境):
阴界入境、烦恼境、病患境、业相境、魔事境、禅定境、诸见境、增上慢境、二乘境、菩萨境
**十乘观法**(能观法):
1. 观不思议境
2. 发真正菩提心(起慈悲心)
3. 善巧安心
4. 破法遍
5. 识通塞
6. 道品调适(三十七道品)
7. 对治助开
8. 知次位(防增上慢)
9. 能安忍
10. 无法爱(离顶堕)
**引用格式:**【《摩訶止觀》卷五至卷十,T1911】→ https://fojin.app/texts/53
**教义要点:**
- 圆顿止观的完整操作体系
- 十乘观法为修观之十重车乘,次第深入
- 前三为正修,中四为助修,后三为防退
---
## 六即佛(卷一下)
**引用格式:**【《摩訶止觀》卷一下,T1911】→ https://fojin.app/texts/53
1. **理即佛**:一切众生本具佛性(理体本具)
2. **名字即佛**:闻经闻法知名字(知而未修)
3. **观行即佛**:五品弟子位(观行相应)
4. **相似即佛**:十信位(相似证入)
5. **分证即佛**:十住至等觉(分分破无明)
6. **究竟即佛**:妙觉位(圆满佛果)
**教义要点:**
- 既防增上慢(未证言证),又不自卑退堕
- "六"明阶位差别,"即"显性体不二
- 天台修证判位之准绳
---
## 圆顿止观开篇(卷一上)
原典(节选):
> 止觀明靜,前代未聞。智者大師,承南岳之教,在瓦官寺說圓頓止觀。功在漸次,證在圓融。
**引用格式:**【《摩訶止觀》卷一上,T1911】→ https://fojin.app/texts/53
**教义要点:**
- "圆顿"区别于渐次、不定三种止观
- 不历次第,初心即观实相
- 天台止观法门之总持
---
## 使用本片段的约定
- 引用经文原典时,必须标注 `【《摩訶止觀》卷NT1911】` 并附 FoJin 链接
- 节选用于教学指引,不代表完整经义;深入研究请查阅 CBETA/FoJin 全本
- 若用户询问未在本片段覆盖的卷次,说明所知范围,并建议 FoJin 检索