npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

master-skill

v0.8.0

Published

Buddhist Master AI Skills — RAG-grounded, source-cited, fidelity-tested. 14 pre-built masters across 三大传统 invokable via /master-<slug> slash commands: 8 汉传 (Xuanzang, Kumārajīva, Huineng, Zhiyi, Fazang, Yinguang, Ouyi, Xuyun) + 3 藏传 (Atiśa, Tsongkhapa, Mi

Readme


立即体验(浏览器直接使用)

大多数用户无需安装任何工具 —— 佛教学习者、研究者、只想了解某位祖师思想的普通读者,都可以直接在浏览器里用。

👉 打开 fojin.app/chat

在 AI 问答页面左下角点击「法师模式」,从 14 位三大传统祖师中选一位即可开始对话。

  • 无需安装、无需注册
  • 三种教学模式均可用:/compare-masters 多祖师对比、/master-debate 祖师辩论、/master-curriculum 学修路径(含跨传统)
  • 内置 FoJin 的 503 个数据源、678K+ 语义向量做实时经证检索
  • 每条回答附原典出处(CBETA 经号 / BDRC 藏文典籍号 / SuttaCentral 巴利经号)

如果你不确定该找谁问,可以这样开始:

| 你的状况 | 推荐法师 | |---|---| | "妄念纷飞坐不住" | /虚云 /智顗 /master-ajahn-chah(参话头 / 止观 / 正念观察) | | "读经文看不懂逻辑" | /玄奘(唯识严密分析) | | "学佛很久但无力感" | /印光(老实念佛) | | "想了解空性" | /鸠摩罗什 /慧能 /master-milarepa /master-tsongkhapa(中观译师 / 禅直指 / 大手印明空 / 应成中观) | | "想系统学华严 / 天台" | /法藏 /智顗(判教与哲学体系) | | "在禅与净土之间犹豫" | /蕅益(跨宗派融通) | | "对苦行 / 闭关好奇" | /master-milarepa(雪山闭关 · 噶举派典范) | | "想学最朴素的禅修" | /master-ajahn-chah(南传森林禅 · 出入息念) | | "想学完整的道次第" | /master-atisha /master-tsongkhapa(噶当三士道 → 格鲁《广论》) | | "想了解上座部论藏体系" | /master-buddhaghosa(《清净道论》戒定慧 + 七清净十六观智) | | "想做密集内观禅修" | /master-mahasi-sayadaw(缅甸内观 · 标记法 · 腹部起伏) | | "想跨传统比较看一个问题" | /compare-masters(自动配对汉藏南传视角)· /master-debate(争议议题辩论)· /master-curriculum(按传统给学修路径) |

开发者、Claude Code / Cursor 用户可跳到下方 开发者安装 小节,以 AgentSkill 形式在终端内使用。


效果示例

下面是一次真实的 /master-huineng(慧能大师)问答——注意每个教义断言都附 CBETA 经证,且回答风格贴合祖师本人(直指、平实、善用譬喻):

你:我想参禅但坐不住、念头太多,该怎么办?

慧能大师:
你说「坐不住」,是把坐姿当成了禅;你说「念头太多」,是把念头当成了
敌人。这两样都不是禅。

何名坐禅?外于一切善恶境界,心念不起,名为「坐」;内见自性不动,名
为「禅」。坐不是腿的事,是心于境上不起执的事。
  【《六祖大师法宝坛经·坐禅品》】→ https://fojin.app/texts/58

念头来了不必怕。「于诸境上心不染,曰无念」——不是要你没有念头,是念
起而不随它跑、不被它粘住。如云过空,空不曾动。
  【《六祖大师法宝坛经·定慧品》】→ https://fojin.app/texts/58

所以不要和念头打仗。你一对治,就又添一个念。但看念起念灭,知它无
住,它自然歇。

如需深入学习,可在 FoJin (fojin.app) 查阅原典。

⚠️ 以上为 AI 合成内容,依据《坛经》文献生成,不代表慧能大师亲口开示。多位法师并列回答的 /compare-masters 效果,可直接在 fojin.app/chat 体验。


v0.6 更新(2026-05-02):Slash 命令命名空间整理——14 位法师斜杠命令统一加 master- 前缀。/master-zhiyi/master-huineng、…。

  • 目的:当 Claude Code 已装 50+ skill 时,单词 slash 命令容易混入其他 skill 列表;前缀化让 14 位法师在 /m<tab> 补全时聚类,识别度大幅提升
  • 未受影响compare-masters / create-master 两个 meta-skill 命令保持原样(避免 /master-compare-masters 重复前缀);fojin.app/chat 网页端 dropdown 与 API 完全解耦,master_profiles.py 不变
  • NPX 安装npx master-skill install zhiyi(短)和 install master-zhiyi(全)皆可,安装目标统一为 ~/.claude/skills/master-<slug>/
  • 详情见 CHANGELOG.md §0.6.0

v0.5 更新(2026-05-02):第二轮跨传统扩展——藏传 / 南传各从 1 位扩至 3 位,共 14 位祖师。

  • 藏传新增:阿底峡尊者(噶当派开祖 · Toh 4465《菩提道灯论》· 三士道)+ 宗喀巴大师(格鲁派创始人 · 三主要道 · 应成中观正见)
  • 南传新增:觉音尊者(《清净道论》Visuddhimagga 论师顶峰)+ 马哈希尊者(缅甸内观 · 标记法 · ETHICS Tier B 特例)
  • HARD-GATE 强化:马哈希尊者特别 NO_ATTAINMENT_JUDGMENT(AI 不得对个体作证果判定)
  • ETHICS Tier A 表扩至 11 位,Tier B 特例新增马哈希(与阿姜查同款条款)

v0.4 更新(2026-05-02):首轮跨传统扩展——新增藏传米拉日巴尊者(噶举派 · 大手印)与南传阿姜查(泰国森林禅林派)。引用体系扩展支持 BDRC(藏文典籍)与 SuttaCentral(巴利三藏)。HARD-GATE 新增 no_esoteric_instructionno_fabricated_quotes

v0.3:全面架构重构——CBETA 经文溯源、离线经文片段、自动化保真度测试、NPX 一键安装、cite.py/query.py 离线工具链、二阶段独立审查、HARD-GATE 铁律、多平台插件(Claude Code / Cursor / Codex / OpenCode / Gemini CLI 五端统一)、session-start hook 自动注入法师列表。


基于佛教经典文献的法师教学角色生成器,遵循 AgentSkills 标准,由 FoJin 驱动。


声明

本项目本着对佛教传统的尊重而建立。所有内容均依据佛教经典文献生成,不做教义评判,不代表任何宗派权威。生成内容仅供学习参考,如需正式修行指导,请亲近善知识。

⚠️ 所有通过 Master-skill 生成的对话均为 AI 合成内容,不代表历史上祖师的亲口开示、亲笔著作。项目遵守严格的版权分级与教界边界——详见 ETHICS.md(AI 透明度、版权 Tier A–D、禁止行为、内容双轨授权、紧急下架通道)。


特性

  • 预置十四位三大传统祖师:8 位汉传(唯识、中观、禅、天台、华严、净土、跨宗派)+ 3 位藏传(阿底峡 · 噶当;宗喀巴 · 格鲁;米拉日巴 · 噶举)+ 3 位南传(觉音 · 上座部论师;马哈希 · 缅甸内观;阿姜查 · 泰国森林)—— 另含 compare-masters 多祖师对比 meta-skill,开箱即用
  • 经文溯源(Provenance):每位祖师附原典标识(CBETA / BDRC / SuttaCentral)+ FoJin text ID,所有教义断言强制附原典引证
  • 离线经文片段sources/ 目录收录核心经典关键段落,FoJin 不可用时仍可离线引用
  • 渐进式披露:SKILL.md 以决策树 + Quick Ref 为主,references/sources/ 按需加载,Context 随查随取
  • HARD-GATE 铁律/create-master 与预置法师内置红线——无 CBETA 引证的教义断言不得写入、不得捏造经号、不得为虚构人物建角色
  • 二阶段独立审查:生成管线在写入前强制经过"教义准确性 → 风格一致性"两轮独立审查,FAIL 自动修复最多 2 轮
  • 自动化保真度测试:每位祖师 tests/fidelity.jsonl 10+ 条 Q&A(compare-masters 元技能 18 条),验证引用和关键词覆盖;CI 在每次推送时 dry-run 验证
  • 多平台统一插件:Claude Code、Cursor、Codex CLI、OpenCode、Gemini CLI 共用一份 prebuilt/,session-start hook 跨平台注入法师列表
  • NPX 一键安装npx master-skill install master-zhiyi 直接部署到 Claude Code
  • 离线工具链scripts/cite.py(CBETA 引用查询)、scripts/query.py(离线语义检索)、scripts/validate.py(frontmatter linter)
  • FoJin 数据桥:接入 fojin.app 的 503 个数据源、10K+ 文本、678K+ 语义向量和 31K 实体知识图谱
  • AgentSkills 标准:遵循 Anthropic Agent Skills 规范,渐进式披露、决策树、黑盒脚本模式

开发者安装

👤 只是想体验? 直接用 fojin.app/chat,跳过下面的安装步骤。 🛠️ 本节面向:Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI 用户,希望在终端 AgentSkill 环境中直接调用 /master-xuanzang /master-huineng 等命令。

安装

NPX 一键安装(推荐,无需常驻)

# 安装指定祖师
npx master-skill install master-zhiyi master-fazang master-huineng

# 安装全部 14 位(三大传统)
npx master-skill install --all

# 查看可用祖师
npx master-skill list

全局安装(频繁使用 / 离线场景)

npm install -g master-skill            # 一次性装到 $PATH
master-skill install master-zhiyi      # 之后省掉 npx,直接调
master-skill list
npm update -g master-skill             # 升到下一个 minor / patch

Claude Code(插件方式)

# npx(上方)与 git clone 手动安装为正式发布渠道:
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

git clone https://github.com/xr843/Master-skill ~/Master-skill
# Cursor 自动检测 .cursor-plugin/plugin.json 并注册技能

OpenCode

opencode.json 中添加:

{
  "plugin": ["master-skill@git+https://github.com/xr843/Master-skill.git"]
}

Codex CLI

参见 .codex/INSTALL.md

Gemini CLI

本项目包含 gemini-extension.jsonGEMINI.md,Gemini CLI 自动发现并加载。

使用预置法师

在支持 AgentSkills 的环境(Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI)中直接调用:

# 汉传
/master-xuanzang       — 玄奘法师(法相唯识宗)
/master-kumarajiva     — 鸠摩罗什(三论宗/中观)
/master-huineng        — 慧能大师(禅宗六祖)
/master-zhiyi          — 智顗大师(天台宗)
/master-fazang         — 法藏大师(华严宗)
/master-yinguang       — 印光大师(净土宗)
/master-ouyi           — 蕅益大师(天台/净土·跨宗派)
/master-xuyun          — 虚云老和尚(禅宗·五宗兼嗣)

# 藏传
/master-atisha         — 阿底峡尊者(噶当派开祖 · 三士道 · 982-1054)
/master-tsongkhapa     — 宗喀巴大师(格鲁派创始人 · 三主要道 · 应成中观)
/master-milarepa       — 米拉日巴尊者(噶举派 · 大手印 · 那洛六法)

# 南传
/master-buddhaghosa    — 觉音尊者(上座部论师 · 《清净道论》· 5世纪)
/master-mahasi-sayadaw — 马哈希尊者(缅甸内观 · 标记法 · 1904-1982)
/master-ajahn-chah     — 阿姜查(泰国森林禅林派 · 巴蓬寺传承)

教学模式(v0.7)

  • /compare-masters — 多位法师对同一问题的并列对比(横向 / 单轮)
  • /master-debate — 祖师就争议议题做多轮交叉辩论(v0.8 起:每轮派 fresh subagent,只携带对方上一轮 ≤80 字摘要 + 本方 cross_critique 弹药;轮数由 debate_protocol.per_pair_overrides 决定,默认 4 轮,huineng-vs-tsongkhapa / ouyi-vs-tsongkhapa 默认 5 轮)
  • /master-curriculum — 按你的传统(禅 / 净 / 天台 / 华严 / 唯识 / 中观 / 格鲁 / 上座部)与当前位置(L0-L3)给出有时序的学修路径

/compare-masters 用法示例:

# 自动选择相关法师
/compare-masters 什么是空性

# 手动指定法师(推荐,结果更精准)
/compare-masters 什么是遍行因 --masters master-xuanzang,master-zhiyi,master-ouyi

# 自然语言触发
请慧能和印光对比回答"如何看待念佛"
比较禅宗和净土宗对修行的看法

选择逻辑:系统先尝试从用户提问中提取关键词,与每位法师的核心概念匹配;若无强匹配,则按主题映射兜底(念佛/禅修/唯识中观/判教等)。如果自动选的法师不符合预期,直接用 --masters 手动指定

自定义生成

/create-master 弘一大师

或自然语言触发:

帮我创建一个弘一大师的教学角色

系统将引导完成三步信息录入,然后自动从 FoJin 采集数据、生成教义分析与风格文件。


预置法师

玄奘法师(602-664)

唐代高僧,中国佛教史上最伟大的译经家。西行求法十七年,遍学印度诸部,归国后主持译经事业,译出经论七十五部一千三百三十五卷。创立法相唯识宗,以严谨精确的翻译风格著称,确立"五种不翻"原则。 主要来源:CBETA《大般若经》《瑜伽师地论》《成唯识论》《心经》等。 调用命令:/master-xuanzang

鸠摩罗什(Kumarajiva,344-413)

龟兹出身,后秦长安译经,中国四大译经家之一。其译文以文学性和流畅度著称,《妙法莲华经》《金刚经》《维摩诘经》《中论》等译本至今最为通行。奠定了三论宗(中观)在中国的基础。 主要来源:CBETA《妙法莲华经》《金刚经》《维摩诘经》《中论》《大智度论》等。 调用命令:/master-kumarajiva

慧能大师(638-713)

禅宗六祖,南宗禅创立者。不识文字的卖柴樵夫,闻《金刚经》而开悟,得五祖弘忍传法。著《六祖坛经》——中国人著作中唯一被尊为"经"者。主张"直指人心,见性成佛",开顿悟法门。 主要来源:CBETA《六祖大师法宝坛经》T48n2008。 调用命令:/master-huineng

智顗大师(538-597)

天台宗创始人,被尊为"东土小释迦"。建立中国佛教第一个完整的判教体系(五时八教),著天台三大部《摩诃止观》《法华玄义》《法华文句》。核心思想:一念三千、三谛圆融、止观双修。 主要来源:CBETA《摩诃止观》T46n1911、《法华玄义》T33n1718 等。 调用命令:/master-zhiyi

法藏大师(643-712)

华严宗三祖,华严哲学体系的实际创立者。武则天国师,以"金师子章"为武后说华严义。核心思想:法界缘起、四法界、十玄门、六相圆融——一切现象互含互摄,事事无碍。 主要来源:CBETA《华严经探玄记》T35n1733、《华严五教章》T45n1866 等。 调用命令:/master-fazang

印光大师(1861-1940)

汉传净土宗第十三代祖师,近代净土复兴的核心人物。 文字平实恳切,戒行严谨,以书信形式广度众生,著有《印光法师文钞》三编。 主要来源:CBETA 汉文大藏经,含文钞正编、续编、三编及净土三经。 调用命令:/master-yinguang

蕅益大师(1599-1655)

明末四大高僧之一,净土宗九祖。"教宗天台,行归净土"——融通禅、教、律、净四宗,是中国佛教史上最重要的跨宗派综合者。其《阿弥陀经要解》被印光大师赞为"即使古佛再来,也不能超过其上"。 主要来源:CBETA《阿弥陀经要解》T37n1762、《教观纲宗》等。 调用命令:/master-ouyi

虚云老和尚(1840-1959)

近代禅宗泰斗,世寿一百二十岁,一身兼嗣禅门五宗(临济、曹洞、沩仰、云门、法眼)法脉——佛教史上绝无仅有。复兴六大祖庭,历经清末、民国、新中国三个时代。主张参话头、老实修行、禅净双修。 主要来源:CBETA《楞严经》《金刚经》《六祖坛经》等。 调用命令:/master-xuyun

阿底峡尊者(Atiśa Dīpaṃkara, 982-1054) — 藏传 · 噶当派 · 印藏桥梁

印度孟加拉萨霍尔国王子出身,超戒寺住持。1042 年应藏王智光邀请入藏,著《菩提道灯论》(Bodhipathapradīpa)——藏地后弘期道次第之祖。首座弟子仲敦巴建热振寺,开噶当派(佛语教授派)。后被宗喀巴新噶当派(即格鲁派)继承。藏传四派(宁玛、萨迦、噶举、格鲁)皆视其为根本师之一。 主要来源:Toh 4465《菩提道灯论》(sDe dge bsTan 'gyur 标准编号)+ 噶当口耳传承《父法·子法》。 调用命令:/master-atisha

宗喀巴大师(Tsongkhapa, 1357-1419) — 藏传 · 格鲁派创始人

藏传佛教格鲁派("善规派",俗称"黄教")创始人,达赖喇嘛与班禅喇嘛传承根基。出生于青海宗喀(今西宁附近),师承萨迦派仁达瓦等。深感当时藏地戒律松弛、显密混淆,立"三主要道"(出离心 / 菩提心 / 清净见)为道次第凝练,著《菩提道次第广论》《密宗道次第广论》《辨了不了义善说藏论》。1409 年建甘丹寺(dGa' ldan),格鲁派开山祖庭。 主要来源:宗喀巴全集 gsung 'bum(BDRC.io 检索 'tsong kha pa')。汉译参考法尊法师本。 调用命令:/master-tsongkhapa

⚠️ 续部具体修法步骤、灌顶仪轨、生起圆满次第细节、本尊咒语、明点观想只介绍历史与原理,不传授具体修法步骤

米拉日巴尊者(Milarepa, 1052-1135) — 藏传 · 噶举派

藏传佛教噶举派精神祖师,"瑜伽士"传统(不入寺院、山中闭关、以歌教化)的典范。早年咒杀仇家造重业,依止玛尔巴译师净罪求法,于雪山闭关数十年以荨麻为食。以**道歌(mGur)**说法,影响后世整个藏传佛教。 主要来源:BDRC《米拉日巴道歌集》(W1KG14334,《十万歌集》mGur 'bum)、《密勒日巴尊者传》(W22272)。 调用命令:/master-milarepa

⚠️ 那洛六法、拙火、生起/圆满次第等密法只介绍历史与原理,不传授具体修法步骤。具体修持必须依止具格上师亲传与灌顶。

觉音尊者(Buddhaghosa, 5世纪) — 南传 · 上座部论师

上座部佛教史上最具影响力的注释家与论师。原为印度南部婆罗门学者,赴斯里兰卡大寺(Mahāvihāra),将古僧伽罗注释翻译为巴利语。著《清净道论》(Visuddhimagga)——以戒(sīla)、定(samādhi)、慧(paññā)三学为骨架,系统组织上座部禅修与教理之百科全书(23 章)。其著作奠定南传上座部正统教理体系——东南亚一切论师皆依其判摄。 主要来源:PTS edition《清净道论》(Visuddhimagga) + 四部尼柯耶注释(aṭṭhakathā)+ Samantapāsādikā 律藏注释 + Atthasālinī 阿毗达摩注释。 调用命令:/master-buddhaghosa

马哈希尊者(Mahāsi Sayādaw U Sobhana, 1904-1982) — 南传 · 缅甸内观传统

缅甸现代最具国际影响力的内观禅修大师之一。1947 年起主持仰光 Mahasi Sasana Yeiktha,形成**'马哈希内观法'(标记法 / Noting Method)——以观察腹部起伏为主所缘,系统培育七清净十六观智。1954-1956 年第六次结集(Chaṭṭha Saṅgāyana)任'最终编辑长老'**,审定整个巴利三藏。其法系深刻影响美国 Insight Meditation Society 三位创办人(Goldstein、Kornfield、Salzberg)。 主要来源:《Manual of Insight》(Wisdom Publications, 2016)、《The Progress of Insight》(BPS Sri Lanka)、《Practical Vipassanā Meditation Exercises》(Mahasi Sasana Yeiktha)。 调用命令:/master-mahasi-sayadaw

⚠️ 本平台 AI 不得对个体作证果判定或观智阶位确认——印证须由具格禅师面对面访谈鉴定。这是马哈希教学体系最严肃的 guardrail。

阿姜查 Ajahn Chah Subhaddo(1918-1992) — 南传 · 泰国森林禅林派

泰国森林禅林派最具国际影响力的禅师之一。以巴利戒律严格持守、四念处禅修、朴素生活化教学著称。其英语弟子(阿姜苏美多、阿姜帕沙诺等)建立了无畏山林、阿马罗筏底、奇泰罗等海外分院,将森林禅林派传至欧美。代表名言:"如果你少放下一点,你就少一点苦。" 主要来源:巴利三藏(SuttaCentral)+ 公开开示集《Food for the Heart》《A Still Forest Pool》《Living Dhamma》。 调用命令:/master-ajahn-chah


架构图

用户请求
    |
    v
session-start hook ──> 自动注入法师列表(5 端统一)
    |
    v
SKILL.md (AgentSkills 入口:决策树 + Quick Ref)
    |
    +-- 预置法师 --> prebuilt/{slug}/
    |                   +-- SKILL.md          (决策树 + <HARD-GATE> 铁律)
    |                   +-- meta.json         (version / lineage / provenance)
    |                   +-- references/       (按需加载)
    |                   |   +-- teaching.md
    |                   |   +-- voice.md
    |                   +-- sources/          (离线经文片段)
    |                   |   +-- *.md (CBETA 段落)
    |                   +-- tests/
    |                       +-- fidelity.jsonl  (保真度样例, CI dry-run)
    |
    +-- 工具链
    |   +-- scripts/validate.py         (frontmatter linter)
    |   +-- scripts/cite.py             (CBETA 引用查询)
    |   +-- scripts/query.py            (离线语义检索)
    |   +-- scripts/test-fidelity.py    (保真度测试)
    |   +-- scripts/validate-fidelity.py
    |   +-- bin/cli.mjs                 (NPX installer)
    |
    +-- 自定义生成 (/create-master, 带 HARD-GATE)
          +-- Step 1-2  prompts/intake.md → tools/sutra_collector.py
          |             └─> FoJin API (KG + 语义检索 + 文本)
          +-- Step 3    prompts/{sutra,voice}_analyzer.md → 两阶段分析
          +-- Step 3.5  二阶段独立审查 ──┬─ prompts/doctrine_reviewer.md
          |                             └─ prompts/voice_reviewer.md
          +-- Step 4-5  tools/master_builder.py → tools/skill_writer.py
                        └─> tools/verify_sources.py (写入前最终验证)

多平台插件统一入口:
  .claude-plugin/    → Claude Code      (hooks/run-hook.cmd → session-start)
  .cursor-plugin/    → Cursor           (hooks/hooks-cursor.json)
  .codex/            → Codex CLI        (.codex/INSTALL.md)
  .opencode/         → OpenCode         (opencode.json 引用)
  gemini-extension.json → Gemini CLI    (GEMINI.md 自动加载)

与 FoJin 的关系

FoJin 是一个佛教文本聚合平台,整合了 503 个数据源、10K+ 篇文本、678K+ 条语义向量嵌入,以及涵盖 31K 实体的知识图谱,覆盖 CBETA 汉文大藏经、SuttaCentral 巴利藏及英译、84000 藏经英译等主要语料库。

Master-skill 通过 tools/fojin_bridge.py 接入 FoJin API,实现:

  • 知识图谱实体检索(法师生平、师承、宗派)
  • 语义向量相似度搜索(教义相关经文)
  • 原文段落提取与出处追踪

所有引用均附带可追溯的 FoJin 链接,确保内容来源透明。


敏感性边界

不做:

  • 不对宗派优劣进行评判
  • 不宣称神通感应
  • 不涉及政治化宗教议题

要做:

  • 忠实依据经文原文,所有回答附 FoJin 出处链接
  • 通过运行时 RAG 检索真实经文,而非仅依赖 AI 自身知识
  • 遇到超出范围的问题坦诚说明

常见问题

Q:FoJin API 不可达时还能用吗?

能。每位预置法师的 prebuilt/<name>/sources/ 收录了该法师核心经典的关键段落(离线经文片段)。FoJin 不可用时,法师会降级到离线模式并在回答中声明"当前使用离线片段"。/create-master 管线遇到 API 故障会提示用户切换手动输入模式,由用户粘贴经文原文继续生成。

Q:CBETA 引用格式是什么样的?怎么验证?

所有 CBETA 引证必须带 Txxn#### 形式的经号(例如《妙法蓮華經》→ T9n262)。scripts/validate.py 会检查 frontmatter 的 sources 字段格式;tools/verify_sources.py 在写入前会逐条核对 FoJin text_id 的有效性,失效链接自动降级为 FoJin 搜索链接,不会留下死链。

Q:npx master-skill install 执行失败、报 ENOTEMPTY 或权限错误怎么办?

先清理 ~/.claude/skills/master-<name>/ 残留目录再重试。如果是 npm 缓存问题,npm cache clean --force 后重跑 NPX。Windows 用户请在 Git Bash 或 WSL 中执行,避免 cmd.exe 的路径转义问题。

Q:生成的法师内容和历史记载不符,怎么纠正?

直接在对话中告诉法师"他不会这样说话"或"他应该更严厉一些"。/create-master 的纠正模式会识别纠正类型(教义纠正 → 追加到 teaching.md;风格纠正 → 追加到 voice.md),以 ## Correction 块形式记录并自动递增 patch 版本号。纠正记录的优先级高于分析生成的内容。

Q:如何贡献一位新的预置法师?

见下方「贡献指南」。基本流程:遵循 v0.3 目录结构生成 prebuilt/<name>/、跑通 scripts/validate.py --strict、补齐 tests/fidelity.jsonl 的 5 条以上样例,然后提 PR。


贡献指南

完整流程见 CONTRIBUTING.md 以下是速查:

新增一位法师的必读:

  1. ETHICS.md §2 — 确认版权 Tier(A 可直接 PR,B 需授权证明,C 一律拒绝)
  2. ETHICS.md §3 — 教界禁止行为须写入该法师 voice.md Layer 0
  3. CONTRIBUTING.md §3 — 目录结构、frontmatter、fidelity 测试用例编写规范
  4. 提交前:python scripts/validate.py --strict 绿色 + tests/fidelity.jsonl 至少 5 条 + CI fidelity-smoke 通过

其它一般贡献(文档、工具链、CI)走普通 PR 流程。


许可证

MIT License


致谢

感谢以下开源佛教文献项目:


Community

  • LINUX DO — 感谢 LINUX DO 社区的支持与反馈