mirror of
https://github.com/xr843/Master-skill.git
synced 2026-05-10 05:16:25 +00:00
xianren
f3472d6254
Add support for 5 platforms beyond NPX: - Claude Code: .claude-plugin/plugin.json + marketplace.json - Cursor: .cursor-plugin/plugin.json + hooks-cursor.json - Codex CLI: .codex/INSTALL.md with symlink setup - OpenCode: .opencode/INSTALL.md with plugin config - Gemini CLI: gemini-extension.json + GEMINI.md Infrastructure: - SessionStart hook with platform detection (Claude Code, Cursor, Copilot CLI) that injects available masters list - Cross-platform run-hook.cmd polyglot wrapper (Windows + Unix) - .version-bump.json for unified version management across all platform config files - Update README/README_EN with multi-platform install instructions Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
323 lines
12 KiB
Markdown
323 lines
12 KiB
Markdown
<h1 align="center">Master-skill</h1>
|
||
|
||
<p align="center">
|
||
<em>「一切有为法，如梦幻泡影，如露亦如电，应作如是观。」</em><br>
|
||
<sub>——《金刚般若波罗蜜经》</sub>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
|
||
<img src="https://img.shields.io/badge/Python-3.9+-green.svg" alt="Python 3.9+">
|
||
<img src="https://img.shields.io/badge/Claude%20Code-Skill-purple.svg" alt="Claude Code Skill">
|
||
<img src="https://img.shields.io/badge/AgentSkills-Standard-orange.svg" alt="AgentSkills Standard">
|
||
</p>
|
||
|
||
<p align="center">
|
||
翻开《瑜伽师地论》百卷，不知从何读起？<br>
|
||
想学禅宗，不知应当亲近哪位祖师？<br>
|
||
读白话译注总隔一层，又难以直入文言？<br>
|
||
学术研究想引用祖师原文，苦于找不到权威出处？
|
||
</p>
|
||
|
||
<p align="center">
|
||
<strong>依据历代汉传祖师大德的教学风格，通达 AI 学习伙伴</strong><br>
|
||
8 位汉传祖师大德 · FoJin 真实经文出处 · AgentSkills 标准
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="#声明">声明</a> ·
|
||
<a href="#特性">特性</a> ·
|
||
<a href="#快速开始">安装</a> ·
|
||
<a href="#预置法师">预置法师</a> ·
|
||
<a href="#与-fojin-的关系">FoJin 集成</a> ·
|
||
<a href="README_EN.md">English</a>
|
||
</p>
|
||
|
||
---
|
||
|
||
> **v0.3 更新**：全面架构重构——渐进式披露（SKILL.md < 100 行）、CBETA 经文溯源（provenance frontmatter）、离线经文片段（sources/）、自动化保真度测试（fidelity.jsonl）、NPX 一键安装、cite.py/query.py 离线工具链。
|
||
|
||
---
|
||
|
||
基于佛教经典文献的法师教学角色生成器，遵循 AgentSkills 标准，由 [FoJin](https://fojin.app) 驱动。
|
||
|
||
---
|
||
|
||
## 在线体验
|
||
|
||
无需安装任何工具，直接在浏览器中体验所有预置法师：
|
||
|
||
**[fojin.app/chat](https://fojin.app/chat)** — 打开 AI 问答页面，左下角「法师模式」选择祖师即可开始对话。
|
||
|
||
---
|
||
|
||
## 声明
|
||
|
||
本项目本着对佛教传统的尊重而建立。所有内容均依据佛教经典文献生成，不做教义评判，不代表任何宗派权威。生成内容仅供学习参考，如需正式修行指导，请亲近善知识。
|
||
|
||
---
|
||
|
||
## 特性
|
||
|
||
- **预置八位汉传祖师大德**：涵盖唯识、中观、禅、天台、华严、净土、跨宗派七大核心宗派，开箱即用
|
||
- **经文溯源（Provenance）**：每位祖师附 CBETA ID、FoJin text ID，所有教义断言强制附经证引用
|
||
- **离线经文片段**：`sources/` 目录收录核心经典关键段落，FoJin 不可用时仍可离线引用
|
||
- **渐进式披露**：SKILL.md < 100 行（决策树 + Quick Ref），references/ 和 sources/ 按需加载，节省 70% context
|
||
- **自动化保真度测试**：每位祖师 `tests/fidelity.jsonl` 5 条 Q&A，验证引用和关键词覆盖
|
||
- **NPX 一键安装**：`npx master-skill install zhiyi` 直接部署到 Claude Code
|
||
- **离线工具链**：`scripts/cite.py`（CBETA 引用查询）、`scripts/query.py`（离线语义检索）、`scripts/validate.py`（frontmatter linter）
|
||
- **FoJin 数据桥**：接入 [fojin.app](https://fojin.app) 的 503 个数据源、10K+ 文本、678K+ 语义向量和 31K 实体知识图谱
|
||
- **AgentSkills 标准**：遵循 [Anthropic Agent Skills](https://github.com/anthropics/skills) 规范，渐进式披露、决策树、黑盒脚本模式
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
### 安装
|
||
|
||
**NPX 一键安装（推荐）**
|
||
|
||
```bash
|
||
# 安装指定祖师
|
||
npx master-skill install zhiyi fazang huineng
|
||
|
||
# 安装全部 8 位
|
||
npx master-skill install --all
|
||
|
||
# 查看可用祖师
|
||
npx master-skill list
|
||
```
|
||
|
||
**Claude Code（插件方式）**
|
||
|
||
```bash
|
||
# 即将上线插件市场，目前使用手动安装：
|
||
git clone https://github.com/xr843/Master-skill ~/Master-skill
|
||
cd ~/Master-skill && pip install -r requirements.txt
|
||
for d in prebuilt/*/; do ln -sf "$(pwd)/$d" ~/.claude/skills/"$(basename $d)"; done
|
||
ln -sf "$(pwd)" ~/.claude/skills/create-master
|
||
```
|
||
|
||
**Cursor**
|
||
|
||
```bash
|
||
git clone https://github.com/xr843/Master-skill ~/Master-skill
|
||
# Cursor 自动检测 .cursor-plugin/plugin.json 并注册技能
|
||
```
|
||
|
||
**OpenCode**
|
||
|
||
在 `opencode.json` 中添加：
|
||
|
||
```json
|
||
{
|
||
"plugin": ["master-skill@git+https://github.com/xr843/Master-skill.git"]
|
||
}
|
||
```
|
||
|
||
**Codex CLI**
|
||
|
||
参见 [.codex/INSTALL.md](.codex/INSTALL.md)
|
||
|
||
**Gemini CLI**
|
||
|
||
本项目包含 `gemini-extension.json` 和 `GEMINI.md`，Gemini CLI 自动发现并加载。
|
||
|
||
### 使用预置法师
|
||
|
||
在支持 AgentSkills 的环境（Claude Code / Codex CLI / OpenClaw）中直接调用：
|
||
|
||
```
|
||
/xuanzang — 玄奘法师（法相唯识宗）
|
||
/kumarajiva — 鸠摩罗什（三论宗/中观）
|
||
/huineng — 慧能大师（禅宗六祖）
|
||
/zhiyi — 智顗大师（天台宗）
|
||
/fazang — 法藏大师（华严宗）
|
||
/yinguang — 印光大师（净土宗）
|
||
/ouyi — 蕅益大师（天台/净土·跨宗派）
|
||
/xuyun — 虚云老和尚（禅宗·五宗兼嗣）
|
||
```
|
||
|
||
### 多法师对比
|
||
|
||
同一问题由 2-3 位法师并列回答，展现宗派视角差异：
|
||
|
||
```
|
||
# 自动选择相关法师
|
||
/compare-masters 什么是空性
|
||
|
||
# 手动指定法师（推荐，结果更精准）
|
||
/compare-masters 什么是遍行因 --masters xuanzang,zhiyi,ouyi
|
||
|
||
# 自然语言触发
|
||
请慧能和印光对比回答"如何看待念佛"
|
||
比较禅宗和净土宗对修行的看法
|
||
```
|
||
|
||
**选择逻辑**：系统先尝试从用户提问中提取关键词，与每位法师的核心概念匹配；若无强匹配，则按主题映射兜底（念佛/禅修/唯识中观/判教等）。**如果自动选的法师不符合预期，直接用 `--masters` 手动指定**。
|
||
|
||
### 自定义生成
|
||
|
||
```
|
||
/create-master 弘一大师
|
||
```
|
||
|
||
或自然语言触发：
|
||
|
||
```
|
||
帮我创建一个弘一大师的教学角色
|
||
```
|
||
|
||
系统将引导完成三步信息录入，然后自动从 FoJin 采集数据、生成教义分析与风格文件。
|
||
|
||
---
|
||
|
||
## 预置法师
|
||
|
||
### 玄奘法师（602-664）
|
||
|
||
唐代高僧，中国佛教史上最伟大的译经家。西行求法十七年，遍学印度诸部，归国后主持译经事业，译出经论七十五部一千三百三十五卷。创立法相唯识宗，以严谨精确的翻译风格著称，确立"五种不翻"原则。
|
||
主要来源：CBETA《大般若经》《瑜伽师地论》《成唯识论》《心经》等。
|
||
调用命令：`/xuanzang`
|
||
|
||
### 鸠摩罗什（Kumarajiva，344-413）
|
||
|
||
龟兹出身，后秦长安译经，中国四大译经家之一。其译文以文学性和流畅度著称，《妙法莲华经》《金刚经》《维摩诘经》《中论》等译本至今最为通行。奠定了三论宗（中观）在中国的基础。
|
||
主要来源：CBETA《妙法莲华经》《金刚经》《维摩诘经》《中论》《大智度论》等。
|
||
调用命令：`/kumarajiva`
|
||
|
||
### 慧能大师（638-713）
|
||
|
||
禅宗六祖，南宗禅创立者。不识文字的卖柴樵夫，闻《金刚经》而开悟，得五祖弘忍传法。著《六祖坛经》——中国人著作中唯一被尊为"经"者。主张"直指人心，见性成佛"，开顿悟法门。
|
||
主要来源：CBETA《六祖大师法宝坛经》T48n2008。
|
||
调用命令：`/huineng`
|
||
|
||
### 智顗大师（538-597）
|
||
|
||
天台宗创始人，被尊为"东土小释迦"。建立中国佛教第一个完整的判教体系（五时八教），著天台三大部《摩诃止观》《法华玄义》《法华文句》。核心思想：一念三千、三谛圆融、止观双修。
|
||
主要来源：CBETA《摩诃止观》T46n1911、《法华玄义》T33n1718 等。
|
||
调用命令：`/zhiyi`
|
||
|
||
### 法藏大师（643-712）
|
||
|
||
华严宗三祖，华严哲学体系的实际创立者。武则天国师，以"金师子章"为武后说华严义。核心思想：法界缘起、四法界、十玄门、六相圆融——一切现象互含互摄，事事无碍。
|
||
主要来源：CBETA《华严经探玄记》T35n1733、《华严五教章》T45n1866 等。
|
||
调用命令：`/fazang`
|
||
|
||
### 印光大师（1861-1940）
|
||
|
||
汉传净土宗第十三代祖师，近代净土复兴的核心人物。
|
||
文字平实恳切，戒行严谨，以书信形式广度众生，著有《印光法师文钞》三编。
|
||
主要来源：CBETA 汉文大藏经，含文钞正编、续编、三编及净土三经。
|
||
调用命令：`/yinguang`
|
||
|
||
### 蕅益大师（1599-1655）
|
||
|
||
明末四大高僧之一，净土宗九祖。"教宗天台，行归净土"——融通禅、教、律、净四宗，是中国佛教史上最重要的跨宗派综合者。其《阿弥陀经要解》被印光大师赞为"即使古佛再来，也不能超过其上"。
|
||
主要来源：CBETA《阿弥陀经要解》T37n1762、《教观纲宗》等。
|
||
调用命令：`/ouyi`
|
||
|
||
### 虚云老和尚（1840-1959）
|
||
|
||
近代禅宗泰斗，世寿一百二十岁，一身兼嗣禅门五宗（临济、曹洞、沩仰、云门、法眼）法脉——佛教史上绝无仅有。复兴六大祖庭，历经清末、民国、新中国三个时代。主张参话头、老实修行、禅净双修。
|
||
主要来源：CBETA《楞严经》《金刚经》《六祖坛经》等。
|
||
调用命令：`/xuyun`
|
||
|
||
---
|
||
|
||
## 架构图
|
||
|
||
```
|
||
用户请求
|
||
|
|
||
v
|
||
SKILL.md (AgentSkills 入口, <100行)
|
||
|
|
||
+-- 预置法师 --> prebuilt/{slug}/
|
||
| +-- SKILL.md (决策树+Quick Ref)
|
||
| +-- meta.json
|
||
| +-- references/ (按需加载)
|
||
| | +-- teaching.md
|
||
| | +-- voice.md
|
||
| +-- sources/ (离线经文片段)
|
||
| | +-- *.md (CBETA)
|
||
| +-- tests/
|
||
| +-- fidelity.jsonl
|
||
|
|
||
+-- 工具链
|
||
| +-- scripts/validate.py (frontmatter linter)
|
||
| +-- scripts/cite.py (CBETA 引用查询)
|
||
| +-- scripts/query.py (离线语义检索)
|
||
| +-- scripts/test-fidelity.py (保真度测试)
|
||
| +-- bin/cli.mjs (NPX installer)
|
||
|
|
||
+-- 自定义生成
|
||
+-- prompts/ (信息录入+分析)
|
||
+-- tools/sutra_collector.py
|
||
| +---> FoJin API ---> 知识图谱 + 语义检索
|
||
+-- tools/master_builder.py (角色构建)
|
||
+-- tools/skill_writer.py (文件写入)
|
||
```
|
||
|
||
---
|
||
|
||
## 与 FoJin 的关系
|
||
|
||
[FoJin](https://fojin.app) 是一个佛教文本聚合平台，整合了 503 个数据源、10K+ 篇文本、678K+ 条语义向量嵌入，以及涵盖 31K 实体的知识图谱，覆盖 CBETA 汉文大藏经、SuttaCentral 巴利藏及英译、84000 藏经英译等主要语料库。
|
||
|
||
Master-skill 通过 `tools/fojin_bridge.py` 接入 FoJin API，实现：
|
||
|
||
- 知识图谱实体检索（法师生平、师承、宗派）
|
||
- 语义向量相似度搜索（教义相关经文）
|
||
- 原文段落提取与出处追踪
|
||
|
||
所有引用均附带可追溯的 FoJin 链接，确保内容来源透明。
|
||
|
||
---
|
||
|
||
## 敏感性边界
|
||
|
||
**不做：**
|
||
|
||
- 不对宗派优劣进行评判
|
||
- 不宣称神通感应
|
||
- 不涉及政治化宗教议题
|
||
|
||
**要做：**
|
||
|
||
- 忠实依据经文原文，所有回答附 FoJin 出处链接
|
||
- 通过运行时 RAG 检索真实经文，而非仅依赖 AI 自身知识
|
||
- 遇到超出范围的问题坦诚说明
|
||
|
||
---
|
||
|
||
## 贡献指南
|
||
|
||
欢迎提交新的预置法师、修正文献来源错误、补充经文片段，或改进工具链。
|
||
|
||
新增祖师需遵循 v0.3 架构：`prebuilt/<name>/` 下包含 SKILL.md（<100行，含 provenance frontmatter）、references/、sources/、tests/fidelity.jsonl。提交前运行 `python3 scripts/validate.py --strict` 确保 0 errors。
|
||
|
||
提交前请确认：文献来源可追溯至 CBETA，内容忠实于佛教经典文献，无宗派偏见。
|
||
|
||
---
|
||
|
||
## 许可证
|
||
|
||
MIT License
|
||
|
||
---
|
||
|
||
## 致谢
|
||
|
||
感谢以下开源佛教文献项目：
|
||
|
||
- [CBETA](https://cbeta.org) — 汉文大藏经数字化
|
||
- [SuttaCentral](https://suttacentral.net) — 巴利藏及多语种译本
|
||
- [84000](https://84000.co) — 藏经英译项目
|
||
|
||
---
|
||
|
||
## Community
|
||
|
||
- [LINUX DO](https://linux.do) — 感谢 LINUX DO 社区的支持与反馈
|