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
@@ -0,0 +1,43 @@
# 马哈希尊者 Sources 索引
本目录为离线可用的开示集片段(**主旨摘要**,非整段译文复制),对应本 master 引用的核心传承文献。
## 收录文件
| 文件 | 来源 | 标识 | 覆盖主题 |
|---|---|---|---|
| `teachings-excerpts.md` | 马哈希尊者公开开示集 + 巴利经典所引 | 《Manual of Insight》/《Progress of Insight》/《Practical Vipassanā》 + SC IDs | 标记法、腹部起伏、十六观智、刹那定、对治散乱、正念力 |
## 引用规范
- 巴利经典:`【SC: MN 10 / Satipaṭṭhāna Sutta】(SuttaCentral`
- 《清净道论》:`【《Visuddhimagga》§XX 观智章】(PTS Vism`
- 马哈希著作:`【《Manual of Insight》§II 标记法】(开示要旨;具体出版版本与页数详见 Wisdom Publications 2016`
## ⚠️ ETHICS Tier B 特例 — 引用警示
马哈希尊者 1904–1982 在大多数司法辖区版权未到期(约 2042–2052)。本目录所收录皆为**开示集主旨摘要**(非逐字英译重排),且:
1. **不引用整段译文**——仅做`主旨摘要`,且明确标注为摘要性内容
2. **不代笔虚构对话**——任何"马哈希尊者曾说 X"必须能在以下 4 部公开授权译本中追溯:
- *Manual of Insight* (Wisdom Publications, 2016)
- *The Progress of Insight* (BPS Sri Lanka, Wheel No. 280)
- *Practical Vipassanā Meditation Exercises* (Mahasi Sasana Yeiktha)
- *Discourses on Mālukyaputta / Dhammacakka / etc.* (BPS Sri Lanka)
3. **核心教学概念依巴利经典**——四念处、出入息念、戒定慧、三法印、十六观智等以 SuttaCentral 巴利原典 + 《清净道论》(PTS Vism) 为主源(公有领域)
4. **若 Mahasi Sasana Yeiktha 任何官方机构提出异议,立即转入 takedown 流程**(详见 ETHICS.md §6
5. **作为社区学习与跨传统对比工具,不作为商业产品的训练数据源**
## 说明
- 主要参考:
- SuttaCentral.net 巴利原典与多语对照
- PTS edition《清净道论》(Visuddhimagga)
- BPS Sri Lanka Wheel publications 系列
- Wisdom Publications 2016 英译《Manual of Insight》
- Mahasi Sasana Yeiktha 官方多语译本
- 中文译本可参:温宗堃《禅修者与内观知见》、嘉义新雨杂志社《内观基础》系列
- 用于教学引用,不代表完整经义;深入研究请查阅上述出版物原本
- **不可代笔虚构"马哈希尊者问答"**——可叙述其论师风格与禅修教练风格,不可生成假对话
- **不可将其他南传禅师的话归于马哈希尊者**(U Nārada / Pa-Auk Sayadaw / Goenka / Sayadaw U Pandita / Bhikkhu Bodhi 等)
- 增补片段欢迎 PR