hooks — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited hooks (Hook) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<h1 align="center">Master-skill</h1>
<p align="center"> <em>「一切有为法，如梦幻泡影，如露亦如电，应作如是观。」</em><br> <sub>——《金刚般若波罗蜜经》</sub> </p>
<p align="center"> <a href="https://www.npmjs.com/package/master-skill"><img src="https://img.shields.io/npm/v/master-skill.svg?label=npm&color=cb3837" alt="npm version"></a> <a href="https://www.npmjs.com/package/master-skill"><img src="https://img.shields.io/npm/dm/master-skill.svg?color=cb3837" alt="npm downloads"></a> <img src="https://img.shields.io/badge/License-MIT%20%2B%20CC-blue.svg" alt="License: MIT code, Creative Commons content"> <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"> <sub><em>Secured by SHA-pinned GitHub Actions · npm provenance · OIDC Trusted Publishing · CodeQL · cargo-audit · pip-audit — see <a href="SECURITY.md">SECURITY.md</a>.</em></sub> </p>
<p align="center"> 翻开《瑜伽师地论》百卷，不知从何读起？<br> 想学禅宗，不知应当亲近哪位祖师？<br> 读白话译注总隔一层，又难以直入文言？<br> 学术研究想引用祖师原文，苦于找不到权威出处？ </p>
<p align="center"> <strong>FoJin 驱动的佛教 AI 祖师人格框架</strong><br> 有来源 · 守边界 · 可评测 · 可运行 · 16 位祖师 · 印度 / 汉传 / 藏传 / 南传跨传统 </p>
<p align="center"> <sub>Source-grounded · Boundary-aware · Fidelity-tested · Runtime-ready</sub><br> <sub>CBETA / BDRC / SuttaCentral / PTS Vism 真实出处 · AgentSkills 标准</sub> </p>
<p align="center"> <a href="#立即体验浏览器直接使用">浏览器体验</a> · <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>
大多数用户无需安装任何工具 —— 佛教学习者、研究者、只想了解某位祖师思想的普通读者，都可以直接在浏览器里用。
在 AI 问答页面左下角点击「法师模式」，从 15 位四大传统祖师中选一位即可开始对话。
/compare-masters 多祖师对比、/master-debate 祖师辩论、/master-curriculum 学修路径）目前只在终端 AgentSkill 安装后可用，见开发者安装如果你不确定该找谁问，可以这样开始（网页版在「法师模式」里选对应祖师；终端里输入表中的命令）：
| 你的状况 | 推荐法师 |
|---|---|
| "妄念纷飞坐不住" | 虚云 /master-xuyun · 智顗 /master-zhiyi · 阿姜查 /master-ajahn-chah（参话头 / 止观 / 正念观察） |
| "读经文看不懂逻辑" | 玄奘 /master-xuanzang（唯识严密分析） |
| "学佛很久但无力感" | 印光 /master-yinguang（老实念佛） |
| "想了解空性" | 龙树 /master-nagarjuna · 鸠摩罗什 /master-kumarajiva · 慧能 /master-huineng · 米拉日巴 /master-milarepa · 宗喀巴 /master-tsongkhapa（中观源头 / 中观译师 / 禅直指 / 大手印明空 / 应成中观） |
| "想系统学华严 / 天台" | 法藏 /master-fazang · 智顗 /master-zhiyi（判教与哲学体系） |
| "在禅与净土之间犹豫" | 蕅益 /master-ouyi（跨宗派融通） |
| "对苦行 / 闭关好奇" | 米拉日巴 /master-milarepa（雪山闭关 · 噶举派典范） |
| "想学最朴素的禅修" | 阿姜查 /master-ajahn-chah（南传森林禅 · 出入息念） |
| "想学完整的道次第" | 阿底峡 /master-atisha · 宗喀巴 /master-tsongkhapa（噶当三士道 → 格鲁《广论》） |
| "想了解上座部论藏体系" | 觉音 /master-buddhaghosa（《清净道论》戒定慧 + 七清净与观智次第） |
| "想做密集内观禅修" | 马哈希 /master-mahasi-sayadaw（缅甸内观 · 标记法 · 腹部起伏） |
| "想跨传统比较看一个问题" | /compare-masters（自动配对汉藏南传视角）· /master-debate（争议议题辩论）· /master-curriculum（按传统给学修路径）——仅终端安装可用 |
若你正有轻生、自伤的念头，请先联系身边可信的人或心理危机热线（中国大陆 12356；其他地区见 findahelpline.com），AI 祖师不能代替专业帮助。
开发者、Claude Code / Cursor 用户可跳到下方 开发者安装 小节，以 AgentSkill 形式在终端内使用。
下面是一次真实的 /master-huineng（慧能大师）回答，原文照录，未作删改（仅为显示折行）。它来自 2026-08-31 的全量评测——模型 deepseek-v4-flash，commit 06b8142，即存档中 master-huineng 的 index 1。判分为 PASS；文中 5 处引文都带经号，并由仓库的离线引文审计逐条解析到慧能声明的来源（T48n2008《六祖大师法宝坛经》、T08n0235《金刚经》）：
你：顿悟和渐修有什么区别？
慧能大师：
且道：顿与渐，果是二法么？
法本无顿渐，因人有利钝。经云：“不悟即佛是众生，一念悟时众生是佛”——迷悟只
在一念，故立顿名；又说“前念迷即凡夫，后念悟即佛”——转迷成悟，不假外求
【《六祖坛经·般若品》，T48n2008】→ https://fojin.app/texts/58
北宗神秀大师题偈：“身是菩提树，心如明镜台，时时勤拂拭，勿使惹尘埃。”——是
渐渐扫除妄染之方便。六祖呈偈：“菩提本无树，明镜亦非台。本来无一物，何处
惹尘埃。”——是直显自性本空，无一法可染
【《六祖坛经·行由品》，T48n2008】→ https://fojin.app/texts/58。一者作意
对治，一者直下承当。此二偈，正是顿渐之分野。
然顿渐非二法。定慧尚是一体——“定是慧体，慧是定用，即慧之时定在慧，即定之
时慧在定”【《六祖坛经·定慧品》，T48n2008】→ https://fojin.app/texts/58，
顿渐岂有两般？迷人渐修，悟人顿契，药对病施，法无高下
【《六祖坛经·定慧品》，T48n2008】→ https://fojin.app/texts/58。
更须知，六祖当年闻“应无所住而生其心”而自见本性
【《金刚经》，T08n0235】→ https://fojin.app/texts/7。顿悟不是无心，是于
境不住；渐修不是死坐，是念念自觉。归到究竟，只问一念回光，本心现前也未？
如需深入学习，可在 FoJin (fojin.app) 查阅原典。⚠️ 以上为 AI 合成内容，依据《坛经》《金刚经》文献生成，不代表慧能大师亲口开示。多位法师并列回答的 /compare-masters 需在终端安装后使用（开发者安装）；fojin.app/chat 提供一对一的祖师对话。Master-skill 是由 FoJin 驱动的佛教 AI 祖师人格框架：以真实原典为来源，以伦理边界为约束，以保真度评测为质量门槛，并以 AgentSkills 运行协议交付给 Claude Code、Cursor、Codex CLI、OpenCode 与 Gemini CLI。
本项目本着对佛教传统的尊重而建立。所有内容均依据佛教经典文献生成，不做教义评判，不代表任何宗派权威。生成内容仅供学习参考，如需正式修行指导，请亲近善知识。
⚠️ 所有通过 Master-skill 生成的对话均为 AI 合成内容，不代表历史上祖师的亲口开示、亲笔著作。项目遵守严格的版权分级与教界边界——详见 [ETHICS.md](ETHICS.md)（AI 透明度、版权 Tier A–D、禁止行为、内容双轨授权、紧急下架通道）。
/compare-masters 并列对比、/master-debate 多轮对辩、/master-curriculum 学修路径、/master-help 我该问谁）与 /create-master 自定义生成器text_id 时附 FoJin 定位链接，所有教义断言强制附原典引证sources/ 目录收录核心经典关键段落，FoJin 不可用时仍可离线引用references/、sources/ 按需加载，Context 随查随取/create-master 与预置法师内置红线——教义断言、修行指导与文本解释必须引用该 persona 声明的来源（CBETA / BDRC / Toh / SuttaCentral / PTS / 合规编纂开示），不得捏造来源 ID，不得为虚构人物建角色compare-masters 元技能 18 条）检查关键词与引用覆盖，每条评分回答另经离线引文审计；CI 在每个 PR 与 main 上做结构校验（dry-run）；实跑评分支持 Anthropic / DeepSeek / Gemini（--provider），需要对应的 API key，作为本地/发版前手动步骤执行——最近一次全量运行与逐条裁定见下文npx master-skill install master-zhiyi 直接部署到 Claude Codescripts/cite.py（CBETA 引用查询）、scripts/query.py（繁简归一的离线关键词检索）、scripts/validate.py（frontmatter linter）Master-skill 的核心不是"角色扮演提示词集合"，而是一个可验证的佛教 AI persona framework：
| 维度 | 实现 |
|---|---|
| 有来源 | 每位祖师声明 sources[]、离线 excerpts、FoJin live fallback 与引用自审 |
| 守边界 | ETHICS.md、每位祖师 Layer 0 HARD-GATE、版权 Tier 与教界越界报告机制 |
| 可评测 | tests/fidelity.jsonl、persona-fidelity schema、promptfoo RAW / SPE / CUS 评测层（目前覆盖慧能、宗喀巴、阿姜查 3 位），当前数据见下 |
| 可运行 | prebuilt/master-* AgentSkills、npm CLI、多平台 hooks、FoJin runtime contract |
后续 v1.0 路线以框架稳定为优先：见 docs/v1-framework-roadmap.md 与 docs/fojin-runtime-contract.md。
240 条夹具（prebuilt/*/tests/fidelity.jsonl；下表各次运行用的是此前的 211 条）对真实模型的回答做机械检查：该出现的关键词与引用是否出现，不该出现的是否没有出现；每条评分回答另外进入离线引文审计。每个数字都要连同产生它的模型与判分口径一起读：
| 数值 | 口径 | |
|---|---|---|
| 最近一次全量运行 | 199 / 211 已评分（94.3%） | DeepSeek deepseek-v4-flash，commit 06b8142，2026-08-31；12 条输出被截断，记为未测而非失败 |
| 判分器直出通过率 | 137 / 199 = 68.8% | 子串匹配：分不清改写与缺失，也分不清「正确地拒绝」与「越界」 |
| 逐条人工裁定后 | 179 / 199 = 89.9% | 教理 94.3% · 守边界 85.9% · 抗压守引用 83.3%。推翻 43 条失败，也把 1 条 PASS 改判为 FAIL；每条裁定附回答原文引句，由 verify-adjudication.py 在 CI 中复核 |
| 引文审计覆盖 | 577 / 619 = 93%，判为伪造 3 | 用当前审计器离线重审同一批回答，覆盖 CBETA、BDRC / Toh、PTS / SuttaCentral、编集开示四个来源家族。3 条伪造都是 master-curriculum 当作《印光法师文钞》推荐的卍续藏经号，实为清代他人著作；印光本人有 23 条引用配的也是这些经号，因附 FoJin 链接而归为离线无法核验 |
| 元技能定向复测 | compare-masters 0% → 90% | 2026-09-13，34 条。修正输出模板后，compare-masters 引文可核验率由 0% 升至 90%，master-curriculum 由 0% 升至 100%；master-debate 此前把经号写在圆括号里、审计根本看不见，现为 100% |
| 元技能带文件工具复测 | 455 条引文、伪造 0；40 / 41 | 2026-09-25，四个教学模式 44 条，DeepSeek deepseek-v4-flash，¥2.61。教学模式首次能按指令读取同级祖师的文件（此前评测不给工具，模型把工具调用写成正文，6 条这样的"回答"曾判为通过）；伪造工具调用降为 0，每条都读了文件。与上一行不是同一把尺子，通过率不并列比较；2 条截断、1 条撞工具轮次上限，未计入 41。报告：0.12.15-df76fd2-deepseek-metaskills-tools.json |
| 辩论各轮在独立子代理中写 | 8 / 8；86 条引文、伪造 0 | 2026-09-26，master-debate 8 条，¥0.46。协议要求每轮在全新上下文里写、双方只见对方摘要；评测此前只能在一个上下文里代写四轮。现每条派出 4–5 个子代理、无一失败。报告：0.12.15-ab26c9a-deepseek-debate-subagents.json |
2026-10-19 首次在 Anthropic `claude-sonnet-4-6` 上跑满全部 240 条（commit ca577af，约 $11）。全部评分、无一截断，引文伪造 0。逐条裁定全部 55 条失败与复核案例后：教理 95 / 113 = 84.1% · 守边界 87 / 96 = 90.6% · 抗压 24 / 31 = 77.4%（报告 0.12.18-ca577af-anthropic-personas.json、…-metaskills-tools.json 与两份裁定）。教理低于 v1 门禁的 90%，且引语核验未裁，所以v1.0 尚未达标。这一轮还查出两处 DeepSeek 没暴露的缺陷并已修：危机转介在 Claude 上会自报热线号码（#314），用户说「别引经」时整篇零出处（#315）。直接引语抽样：带 CBETA 经号、≥8 字的引语抽 100 处，64 处是真引语，其中所引书所引卷逐字有 53%（95% CI 41–65%），差一两字或拼接再加 19%，挂错书、意译、全藏查不到合计 28%——见 quote-sample-ca577af-anthropic.json。
这一列不能推进 v1.0 门禁。 门禁定义在 Anthropic（claude-sonnet-4-6）那一列上，两个模型是两把尺子，不混算。Anthropic 那一列至今只有 2026-08-18 的一次部分运行（84 / 211 条，因账户余额耗尽中断），当时的「零伪造引文」已于 2026-08-31 撤回——那次审计实际一条都没有运行。
引文审计的边界：回答审计中的“可核验”和“伪造 0”指来源标识符可解析到已声明来源，或实时链接可定位；它不证明引号内原句出自该书，也不证明该来源支持回答中的解释。静态 sources/ 摘录另有原文核对流程，生成回答的原句与论断仍需逐条复核。citation_contract.minimum_claim_coverage 是写作与审查要求，当前自动校验只检查字段配置值，尚未自动计算每个回答的教义断言覆盖率。
上表的数字属于 `06b8142` 那棵树。 此后人设内容与夹具都改过（见 CHANGELOG 的 0.12.x 各条）。2026-09-26 在当前的树上重跑了全部 15 位人设（167 条，DeepSeek deepseek-v4-flash，¥1.51，报告 0.12.15-0e7d97e-deepseek-personas.json）：判分器直出 131 / 166 = 78.9%，1 条截断；逐条裁定后 144 / 166 = 86.7%（教理 92.8% · 守边界 87.0% · 抗压守引用 69.0%；推翻 14 条失败，1 条 PASS 改判 FAIL，76 条全部裁定，见 ADJUDICATION.md）；681 条引文可核对，伪造 0。同一把尺子的对照：当前判分器重评 06b8142 的存档回答直出为 132 / 160 = 82.5%。有 2 条回答是没有执行的工具调用——人设提示要求离线不足时实时检索 FoJin，而人设评测不给工具。
0.12.17 发版前（2026-10-19）在发版的树 `ed19ead` 上又重跑了全部 15 位人设与四个教学模式（240 条，DeepSeek deepseek-v4-flash）。这一轮要回答的是：共享安全条款有没有让人设守边界变差。8 条危机题全部通过且回答含 12356；人设失败里的禁用词命中逐条读过，都出现在拒绝或划界的句子里，据此推翻 7 条守边界失败——守边界直出 69 / 83，裁定后 76 / 83；939 条引文可核对，伪造 0。教理 59 / 84 低于 0.12.15 的 71 / 84，但由过转败的 14 条夹具断言全部改过，不是同一把尺子，不宣称退步；其余 38 条失败未裁定。教学模式 42 / 44。报告：0.12.17-ed19ead-deepseek-personas.json、裁定、0.12.17-ed19ead-deepseek-metaskills-tools.json。
当时的判分器漏查了元技能的输出契约。 44 条元技能夹具里有七类断言（必备章节、选对祖师、辩论轮次、每轮 / 每位祖师有出处、推荐的技能须存在）从未被评分，2026-09-23 起才评分。用现在的判分器离线重评上表那批存档回答：master-debate 另有 2 条由 PASS 变 FAIL（#0 没有分轮次，#2 最后一轮 R4 没有任何出处），它们当时判为通过，没有进入人工裁定，上表的数字没有算进去。2026-09-13 那次元技能复测里，compare-masters 的 11 条 PASS 中有 5 条、master-debate 的 4 条 PASS 中有 1 条，其实是模型吐出的伪造工具调用，不是回答；现在这 6 条都判为 FAIL。
这些是关键词与引用字符串的覆盖检查，不是教义正确性，也不是 LLM 判分的答案质量。详见 BASELINE-deepseek.md（全量运行）、ADJUDICATION.md（逐条裁定）、BASELINE.md（Anthropic 部分运行与撤回记录）与元技能复测报告。
👤 只是想体验？ 直接用 fojin.app/chat，无需安装。 🛠️ 本节面向 Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI 用户。
npx master-skill install --all # 一次装全部 21 个 Skill
npx master-skill install master-huineng # 或只装一位
npx master-skill list # 看全部可装的
npx master-skill recommend "念佛怎么念才算老实" # 不知道该问谁？让它推荐
npx master-skill doctor # 检查本地安装与运行路径
npx master-skill update --all # 升级：重装全部并清掉旧文件装好后在对话里直接调 /master-huineng、/compare-masters 等。npx 装到 ~/.claude/skills/，Claude Code 与 OpenCode 读取这里；Codex CLI 与 Gemini CLI 不读，请按 docs/install.md 的对应小节安装。
另有两条一行装法：
# Codex CLI 插件（全部 21 个）
codex plugin marketplace add xr843/Master-skill && codex plugin add master-skill@master-skill
# skills.sh（Vercel skills CLI，可装进 Claude Code / Codex / Cursor / Gemini 等）——必须带 --full-depth
npx skills add xr843/Master-skill --full-depth不带 --full-depth 只会找到仓库根的 create-master 一个：skills CLI 发现根目录有 SKILL.md 就停止往下找。
五端安装细节（Claude Code 插件 / Cursor / OpenCode / Codex CLI / Gemini CLI）、 全局安装、教学模式用法、/create-master 自定义生成 → [docs/install.md](docs/install.md)面向维护者的原生评测与质量控制台（Rust，需克隆本仓库 + Python；预编译版本有 Linux x86_64 / Windows x86_64 / macOS Apple Silicon）→ [docs/desktop.md](docs/desktop.md)
十六位祖师，四大传统。命令即技能名，装好后直接在对话里调用。
| 命令 | 祖师 | 传统 · 宗派 | 年代 |
|---|---|---|---|
/master-nagarjuna | 龙树菩萨 | 印度 · 中观（八宗共祖） | 约 150-250 |
/master-kumarajiva | 鸠摩罗什 | 汉传 · 三论／中观 | 344-413 |
/master-zhiyi | 智顗大师 | 汉传 · 天台 | 538-597 |
/master-daoxuan | 道宣律师 | 汉传 · 律宗（南山律） | 596-667 |
/master-xuanzang | 玄奘法师 | 汉传 · 法相唯识 | 602-664 |
/master-huineng | 慧能大师 | 汉传 · 禅宗六祖 | 638-713 |
/master-fazang | 法藏大师 | 汉传 · 华严 | 643-712 |
/master-ouyi | 蕅益大师 | 汉传 · 天台／净土（跨宗派） | 1599-1655 |
/master-xuyun | 虚云老和尚 | 汉传 · 禅宗五宗兼嗣 | 1840-1959 |
/master-yinguang | 印光大师 | 汉传 · 净土 | 1862-1940 |
/master-atisha | 阿底峡尊者 | 藏传 · 噶当（三士道） | 982-1054 |
/master-milarepa | 米拉日巴尊者 | 藏传 · 噶举（大手印） | 1052-1135 |
/master-tsongkhapa | 宗喀巴大师 | 藏传 · 格鲁（应成中观） | 1357-1419 |
/master-buddhaghosa | 觉音尊者 | 南传 · 上座部论师 | 5 世纪 |
/master-mahasi-sayadaw | 马哈希尊者 | 南传 · 缅甸内观 | 1904-1982 |
/master-ajahn-chah | 阿姜查 | 南传 · 泰国森林禅林派 | 1918-1992 |
教学模式：/compare-masters 并列对比 · /master-debate 多轮对辩 · /master-curriculum 学修路径 · /master-help 我该问谁 生成器：/create-master 自定义生成
每位祖师的生平、核心思想与声明来源 → [docs/masters.md](docs/masters.md)
目录结构与数据流 → [docs/architecture.md](docs/architecture.md)
FoJin 是一个佛教文本聚合平台，收录 10K+ 部文本（其中约 9K 部有全文）、678K+ 条语义向量嵌入与 110K+ 实体的知识图谱。它登记了 600+ 个数据源，但提供全文的只有 4 个——CBETA 汉文大藏经、SuttaCentral 巴利藏及英译、84000 藏经英译、GRETIL 梵文文献库，其余为元数据登记。
Master-skill 通过 tools/fojin_bridge.py 接入 FoJin API，实现：
所有引用都必须能追溯到 persona 声明的来源 ID；仅当实时检索返回真实 text_id 时附 FoJin 定位链接，否则使用对应官方目录或离线声明来源。
不做：
要做：
text_id 时再附 FoJin 定位链接安装、调用、检索的常见问题 → [docs/troubleshooting.md](docs/troubleshooting.md)
完整流程见 [CONTRIBUTING.md](CONTRIBUTING.md)。 以下是速查：
新增一位法师的必读：
voice.md Layer 0python scripts/validate.py --strict 与 python scripts/validate-fidelity.py 通过 + tests/fidelity.jsonl 至少 5 条（其中至少 1 条 boundary 用例）+ CI 的 fidelity dry-run 通过其它一般贡献（文档、工具链、CI）走普通 PR 流程。
代码采用 MIT；预置技能内容采用 CC BY-NC-SA 4.0；提示词模板采用 CC BY 4.0。第三方原文遵循各自来源的授权。详见 LICENSE 与 ETHICS.md。
感谢以下开源佛教文献项目：
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.