Files
Master-skill/prebuilt/master-mahasi-sayadaw/sources/INDEX.md
T
xianren 3f81cbb955 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>
2026-05-02 20:43:36 +08:00

44 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 马哈希尊者 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