mirror of
https://github.com/xr843/Master-skill.git
synced 2026-05-10 05:16:25 +00:00
xianren
5b46be9890
Adds the project's first non-Chinese masters, taking the scope from
"Chinese Buddhist" to "Buddhist" and matching the project name's
broader implication.
New masters
-----------
• prebuilt/milarepa — Tibetan Kagyu yogi (1052–1135). Sources:
The Hundred Thousand Songs of Milarepa (mGur 'bum, BDRC W1KG14334)
and The Life of Milarepa (rNam thar, BDRC W22272). Coverage:
Mahāmudrā view, Naro Chodruk (name-level only — no esoteric steps),
retreat & austerity, guru yoga, karma & purification.
• prebuilt/ajahn-chah — Thai Forest Tradition founder of Wat Pah Pong
(1918–1992). Sources: Pali Canon (SuttaCentral SC IDs) plus
authorized English collections Food for the Heart, A Still Forest
Pool, Living Dhamma. Coverage: sati & satipaṭṭhāna, ānāpānasati,
three characteristics, letting go, sīla-samādhi-paññā, middle way.
HARD-GATE additions
-------------------
• no_esoteric_instruction — Tibetan tantric practice steps (tummo,
generation/completion stages, empowerment-required visualizations
and mantras) are never disclosed; queries are redirected to
qualified teachers. Boundary registered in
scripts/validate-fidelity.py.
• No fabricated quotes for Theravāda discourses — Ajahn Chah quotes
must trace to authorized publications; no synthesized "Ajahn Chah
said" dialogue.
Citation system
---------------
BDRC:Wxxxxx (Tibetan canon) and SuttaCentral SC IDs are now
first-class alongside CBETA Txxnxxxx in frontmatter sources lists.
validate.py already accepts non-cbeta sources via the existing
title-or-cbeta_id check, no schema change required.
Cross-tradition compare-masters mappings
----------------------------------------
prebuilt/compare/SKILL.md gets new fallback rows for: 苦行/闭关
(xuyun + milarepa), 正念/觉知 (huineng + ajahn-chah + xuyun),
出离心/无常 (yinguang + milarepa + ajahn-chah), 三大传统对比
(huineng + milarepa + ajahn-chah), and adds milarepa to 般若/空性,
ajahn-chah to 戒律/行持.
Surface updates
---------------
• Description across package.json, .claude-plugin/{plugin,marketplace}.json,
.cursor-plugin/plugin.json: "Chinese Buddhist" → "Buddhist",
"8 prebuilt masters" → "10 prebuilt masters across 汉传/藏传/南传".
• README.md + README_EN.md: cross-tradition rows in the situational
guidance table; new master cards for Milarepa and Ajahn Chah with
appropriate provenance notes; v0.4 release banner replaces v0.3.
• SKILL.md preset list reorganized by tradition.
• CHANGELOG.md gets a [0.4.0] section.
• package.json keywords add tibetan-buddhism, theravada, bdrc,
suttacentral.
Validation
----------
• python scripts/validate.py --strict → ✅ 11 masters pass
• python scripts/validate-fidelity.py → ✅ 11 masters validated
(12 + 13 fidelity cases for the two new masters)
• python scripts/test-fidelity.py --all --dry-run → ✅
• pytest tests/ → ✅ 31 passed, 6 skipped
The progressive-disclosure shape of v0.3 is preserved exactly, so
the fidelity-smoke CI cost cap is unchanged.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
122 lines
9.2 KiB
Markdown
122 lines
9.2 KiB
Markdown
# Changelog
|
||
|
||
All notable changes to Master-skill are documented in this file.
|
||
|
||
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||
|
||
Sections marked **Ethics** track changes to `ETHICS.md`, content licensing, or boundary rules — these are governance-level changes and require the public-review process documented in `ETHICS.md §7`.
|
||
|
||
---
|
||
|
||
## [Unreleased]
|
||
|
||
### Added
|
||
- `ETHICS.md` — AI transparency, copyright tier (A/B/C/D), religious boundary, dual-track content license, takedown channel.
|
||
- `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `SECURITY.md` — community infrastructure.
|
||
- `.github/ISSUE_TEMPLATE/` — bug report, feature request, new-master proposal, boundary-violation.
|
||
- `.github/PULL_REQUEST_TEMPLATE.md`.
|
||
- `.github/workflows/npm-publish.yml` — tag-triggered npm release.
|
||
- CI `fidelity-smoke` job — runs a single master × single fixture on every PR with a hard $0.05 cost cap, enforces HARD-GATE beyond dry-run.
|
||
- `package.json`: `engines.node`, `scripts.test`, `scripts.validate`, `publishConfig`.
|
||
|
||
### Ethics
|
||
- Establish copyright tiers A–D; current 8 prebuilt masters confirmed Tier A (Public Domain in CN/TW as of 2026).
|
||
- Declare dual-track content licensing: code MIT, master content CC BY-NC-SA 4.0, prompts CC BY 4.0.
|
||
|
||
---
|
||
|
||
## [0.4.0] — 2026-05-02
|
||
|
||
**Cross-tradition expansion: from "Chinese Buddhist" to "Buddhist" — the project name now matches its scope.**
|
||
|
||
### Added
|
||
- **Milarepa** (`prebuilt/milarepa/`) — Tibetan Kagyu yogi (1052–1135). Sources: *The Hundred Thousand Songs of Milarepa* (mGur 'bum, BDRC W1KG14334) + *The Life of Milarepa* (rNam thar, BDRC W22272). Coverage: Mahāmudrā view, Naro Chodruk (introduced at name level only), retreat & austerity, guru yoga, karma & purification.
|
||
- **Ajahn Chah** (`prebuilt/ajahn-chah/`) — Thai Forest Tradition founder of Wat Pah Pong (1918–1992). Sources: Pali Canon (SuttaCentral SC IDs) + authorized English collections *Food for the Heart*, *A Still Forest Pool*, *Living Dhamma*. Coverage: sati & satipaṭṭhāna, ānāpānasati, three characteristics, letting go, Sīla-Samādhi-Paññā, middle way.
|
||
- HARD-GATE boundary **`no_esoteric_instruction`** — Tibetan tantric practice steps (tummo, generation/completion stages, specific empowerment-required visualizations and mantras) are **never** disclosed; queries are redirected to qualified teachers. Boundary added to `scripts/validate-fidelity.py`.
|
||
- HARD-GATE rule for Theravāda discourses — Ajahn Chah quotations must trace to authorized publications; no synthesized "Ajahn Chah said" dialogue.
|
||
- Citation system extended: `BDRC:Wxxxxx` (Tibetan canon) and `SuttaCentral` SC IDs are now first-class alongside CBETA `Txxnxxxx`.
|
||
|
||
### Changed
|
||
- Description across `package.json`, `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, `.cursor-plugin/plugin.json`: "Chinese Buddhist" → "Buddhist", "8 prebuilt masters" → "10 prebuilt masters across 汉传/藏传/南传".
|
||
- `README.md` + `README_EN.md`: added cross-tradition rows in the situational guidance table; new master cards for Milarepa and Ajahn Chah with appropriate provenance notes; v0.4 release note replaces the v0.3 banner.
|
||
- `SKILL.md` (project-level): preset list reorganized by tradition (汉传 / 藏传 / 南传).
|
||
- `package.json` `keywords`: added `tibetan-buddhism`, `theravada`, `bdrc`, `suttacentral`.
|
||
|
||
### Notes
|
||
- Both new masters keep the v0.3 progressive-disclosure shape (decision tree → references → sources → fidelity tests), so the cost profile of the fidelity-smoke CI job is unchanged.
|
||
- Esoteric content is intentionally absent from `prebuilt/milarepa/sources/` — this is enforced by content review, not just by the test suite.
|
||
|
||
---
|
||
|
||
## [0.3.0] — 2026-04-10
|
||
|
||
**Architectural rebuild around provenance, fidelity, and multi-platform delivery.**
|
||
|
||
### Added
|
||
- **Provenance frontmatter** — every `prebuilt/<master>/SKILL.md` now carries `sources:` (CBETA ID + FoJin text ID), `citation_format:`, `verified_by:`, `verified_at:`.
|
||
- **Offline sutra excerpts** — `prebuilt/<master>/sources/` ships canonical passages so masters remain useful when FoJin is unreachable.
|
||
- **Progressive disclosure architecture** — SKILL.md is decision-tree + quick-ref; heavyweight `references/teaching.md`, `references/voice.md`, and `sources/` load on demand.
|
||
- **Fidelity tests** — `prebuilt/<master>/tests/fidelity.jsonl`, 5 Q&A per master, verifying citations (`must_cite`), terminology (`must_mention`), and boundary rules (`must_not_contain_first_turn`).
|
||
- **NPX installer** — `npx master-skill install <master>` / `list` / `uninstall` / `--all`; `bin/cli.mjs`.
|
||
- **Multi-platform plugin support** — unified `prebuilt/` reused by Claude Code, Cursor, Codex CLI, OpenCode, Gemini CLI; per-platform hooks in `hooks/`, `.claude-plugin/`, `.cursor-plugin/`, `.codex/`, `.opencode/`, `gemini-extension.json`.
|
||
- **Session-start hook** — auto-injects the list of installed masters so the user does not re-issue `/list` each session.
|
||
- **HARD-GATE enforcement** — no CBETA citation → no dogmatic assertion; fabricated CBETA IDs rejected by `scripts/validate.py`; no persona for fictional / unattested figures.
|
||
- **Two-stage independent review** — `/create-master` pipeline runs doctrine-accuracy pass followed by voice-consistency pass, auto-fix up to 2 rounds.
|
||
- **Offline tooling** — `scripts/cite.py` (CBETA citation lookup), `scripts/query.py` (offline semantic search), `scripts/validate.py` (SKILL.md frontmatter linter), `scripts/validate-fidelity.py`, `scripts/test-fidelity.py`.
|
||
- **CI pipeline** (`.github/workflows/validate-and-test.yml`) — lint, fidelity structure validation, dry-run fidelity on every push/PR; full API-backed fidelity on `workflow_dispatch`.
|
||
- **Weekly link verification** (`.github/workflows/verify-links.yml`) — cron'd `tools/verify_sources.py` opens an issue when FoJin URLs or CBETA IDs drift.
|
||
- **`/compare-masters` meta-skill** — multi-master side-by-side answering with smart master selection, divergence radar, labeled differences, classic debate templates.
|
||
- **Cross-reference tool** (`tools/cross_reference.py`) for inter-master dialogue.
|
||
- **Browser-first onboarding** — README now directs non-CLI users to `fojin.app/chat` 法师模式 first; per-master `starter_questions` added.
|
||
- **Prebuilt masters** (8): 玄奘 (Xuanzang), 鸠摩罗什 (Kumārajīva), 慧能 (Huineng), 智顗 (Zhiyi), 法藏 (Fazang), 印光 (Yinguang), 蕅益 (Ouyi), 虚云 (Xuyun).
|
||
|
||
### Changed
|
||
- Project renamed `buddha-skill` → `Buddha-skill` → **`Master-skill`** to match AgentSkills naming conventions and emphasize teaching-persona framing.
|
||
- Focus narrowed to **汉传 (Chinese Mahāyāna)** — 南传 / 藏传 sections removed from PRD, prompts, and prebuilt set. Cross-tradition `compare` still possible via `/create-master` but not shipped.
|
||
- Per-master RAG queries in `/compare-masters` now enforce tradition-specific terminology to prevent cross-tradition drift.
|
||
- Smart master selection: keywords expanded 6 → 24 per master; first-turn identity-neutral (masters no longer assume user identity on first message).
|
||
- FoJin URL format corrected for juan paths; 186 FoJin URLs verified and updated from CBETA IDs to real internal `text_id`s.
|
||
|
||
### Fixed
|
||
- `fix(ci)`: `verify-links.yml` uses `context.repo.repo` instead of non-existent `context.repo.name`.
|
||
- `fix(lint)`: meta-skills (`compare-masters`) exempted from `lineage` / `sources` frontmatter checks.
|
||
- `fix`: `slugify` lowercases English names and handles spaces.
|
||
- `fix`: robust tool path resolution + precise selection feedback in `/compare-masters`.
|
||
- `fix`: escape `text_id` placeholder in `SKILL_MD_TEMPLATE` to survive Python `.format()`.
|
||
|
||
### Removed
|
||
- Early prebuilt masters **宗喀巴 (Tsongkhapa, Gelug)** and **Ajahn Chah (Thai Forest)** — retracted when scope refocused to 汉传 on 2026-04-04. Will return only via a future `Master-skill-beyond-chinese` branch with native-speaker reviewers.
|
||
|
||
### Documentation
|
||
- README: hero section with Diamond Sutra epigraph, badges, navigation; EN README synced to v0.3 parity.
|
||
- PRD (`docs/PRD.md`) refocused on 汉传.
|
||
- Plugin metadata synced across Cursor / Codex / OpenCode / Gemini extensions.
|
||
|
||
---
|
||
|
||
## [0.2.0] — 2026-04-05 (historical, no release tag)
|
||
|
||
Iteration layer between initial skeleton and full v0.3 rebuild. Highlights:
|
||
- `/compare-masters` skill first draft (P1).
|
||
- Graceful degradation when FoJin API is unavailable.
|
||
- Complete FoJin API reference for ad-hoc LLM queries.
|
||
- First-turn identity-neutral rule.
|
||
- Expanded flow control and error handling in SKILL.md.
|
||
- Community section added to README (linux.do link).
|
||
|
||
---
|
||
|
||
## [0.1.0] — 2026-04-04 (initial skeleton)
|
||
|
||
- Project skeleton, directory layout, prompt templates.
|
||
- FoJin data bridge (`tools/fojin_bridge.py`) with full API coverage.
|
||
- Version manager, skill writer, sutra collector, master builder orchestrator.
|
||
- Initial prebuilt masters (later expanded): 印光, Ajahn Chah, 宗喀巴, 玄奘, 鸠摩罗什, 慧能, 智顗, 法藏, 虚云, 蕅益.
|
||
- Source verification tool.
|
||
- Chinese + English README, PRD v1.0.0.
|
||
|
||
---
|
||
|
||
[Unreleased]: https://github.com/xr843/Master-skill/compare/v0.3.0...HEAD
|
||
[0.3.0]: https://github.com/xr843/Master-skill/releases/tag/v0.3.0
|