Master-skill/docs/PRD.md

Buddha Skill — 产品需求文档 (PRD)

版本：1.0.0
日期：2026-04-04
项目：buddha-skill
平台：AgentSkills + FoJin (fojin.app)

---

1. 项目背景与目标

1.1 灵感来源

Buddha Skill 源于 colleague-skill 的设计理念。colleague-skill 通过蒸馏真实同事的沟通风格、工作方式与思维框架，生成可交互的 AI 角色。Buddha Skill 将这一模式迁移至佛教领域：将历史上有据可查的高僧大德的教义体系与说法风格提炼为结构化的 AI 教学角色。

两者的核心机制相同——通过 teaching.md（知识体系）与 voice.md（表达风格）的双文件架构，将一个复杂的"人"转化为可靠且可复现的 AI 角色。差异在于数据来源：colleague-skill 依赖私有企业材料，Buddha Skill 依赖公开佛教文献，并通过 FoJin 平台进行结构化访问。

1.2 核心价值

用户与传统文字材料的交互是单向的。Buddha Skill 让用户能以特定法师的视角和方式学习佛法——不仅是阅读法师的文字，而是以该法师的教学逻辑与表达习惯进行对话式学习。

具体价值体现：

• 教学视角还原：每个法师角色忠实还原其惯用比喻、术语偏好、引经方式与教学路径
• 多传承覆盖：支持南传、汉传、藏传三大传承，照顾不同修学背景的用户
• 出处可追溯：所有教义内容附经文出处，并链接至 FoJin 原典，可直接查阅原文
• 不越界：明确划定 AI 角色的能力边界，不模拟在世领袖，不做修行诊断

1.3 目标用户

用户群体	典型需求
佛学研究者	快速进入特定法师的思想框架，辅助文献研究
修行者	以法师的教学方式理解特定教义，获得实修指导
佛教数字人文工作者	探索 AI 与经典文献结合的技术可能性
对佛教感兴趣的普通用户	通过具体人物降低进入门槛，建立初步理解

---

2. 核心概念

2.1 文件架构

每个法师角色由四个文件组成：

teachers/{slug}/
├── SKILL.md        # 触发入口与基础元数据
├── teaching.md     # 教义体系
├── voice.md        # 说法风格
└── meta.json       # 结构化元数据

teaching.md 记录该法师的知识体系，包含：

• 传承背景与生平（可追溯来源的事实层）
• 核心教导（每条教义附对应经典出处）
• 精通经典列表（附 FoJin 链接）
• 修行方法（按入门/进阶/深入分层）
• 常用典故与比喻（还原法师的具体表达）
• 关键术语表（含原语言术语与精确释义）

voice.md 记录该法师的表达方式，分四层（见第 2.2 节）。

2.2 voice.md 四层结构

层级	名称	作用
Layer 0	硬规则	最高优先级，无条件执行，与法师风格无关
Layer 1	身份	传承、时代、师承、根本立场、在传承中的角色
Layer 2	表达风格	语言特点、常用比喻、开场方式、称呼方式
Layer 3	教学方法	教学路径、如何引导深入、遇到困惑时的处理方式

Layer 0 是全局约束，覆盖在所有法师角色之上，不受传承或个人风格影响。Layer 1-3 是法师特有内容，随法师不同而差异显著。

2.3 生成流程

intake（信息录入）
  → collect（数据采集）
  → analyze（教义与风格分析）
  → build（结构化生成）
  → write（写入文件）

intake：通过三问模式收集必要信息——法师名称、关注方面（教义/修行/讲解/全部）、语言偏好。

collect：调用 fojin_bridge 从 FoJin 平台采集该法师的知识图谱实体、师承关系、相关经典与传承术语。

analyze：分别运行教义分析与风格分析，提炼结构化内容。

build：基于分析结果，生成符合格式规范的 teaching.md 与 voice.md 草稿。

write：用户确认后，通过 skill_writer 写入目标目录，并初始化 meta.json。

---

3. 数据来源

3.1 FoJin 平台

buddha-skill 的数据层由 FoJin (fojin.app) 提供支撑。FoJin 是一个专注于佛教典籍的学术数字人文平台，现有数据规模：

数据类型	数量
数据源	503 个
文本	10,500+ 篇
语义嵌入	678,000+ 条
知识图谱实体	31,000 个（含 23,000 条师承关系）
词典条目	748,000 条（来自 32 部词典）

这一数据基础使得法师角色的生成可以基于可查证的文献材料，而非模型的幻觉。

3.2 fojin_bridge 双模式

tools/fojin_bridge.py 支持两种访问模式：

API 模式：连接 fojin.app 远程 API，实时查询最新数据。适合已上线内容的访问，无需本地安装。

本地模式：连接本地部署的 FoJin 实例（通过环境变量 FOJIN_LOCAL_URL 配置）。适合离线使用或开发调试，可访问完整数据集包括未公开内容。

模式切换通过参数 --mode api|local 控制，默认使用 API 模式。

---

4. 传承标签体系

传承标签是 buddha-skill 区分各法师角色行为差异的核心机制，类似 colleague-skill 中的企业文化标签。每个标签对应一组具体的行为规则，影响 voice.md 的 Layer 1-3 内容。

4.1 南传传承

子标签	代表人物	行为特征映射
泰国森林传承	阿姜查、阿姜曼	口语化比喻、强调实修体验、行禅与坐禅并重、头陀行精神
缅甸马哈希传承	马哈希长老	系统化止观方法、精密的禅修指导、对身体感受的细致觉察
斯里兰卡传承	那那波尼卡尊者	学术性较强、注重巴利文文献、正念的系统阐述
缅甸帕奥传统	帕奥禅师	严格依据阿毗达磨、精密的定力培养、次第清晰

南传传承共有特征：以巴利语经典为权威、强调四念处修行、引用格式使用巴利文术语（加注中文释义）、不涉及大乘经典。

4.2 汉传传承

子标签	代表人物	行为特征映射
净土宗	印光大师、善导大师	强调信愿行三资粮、以念佛为主轴、引用净土五经、文字恳切庄重
禅宗	六祖慧能、临济义玄	机锋对答、以指月方式打破概念执著、不立文字又处处是文字
天台宗	智者大师	教观并重、判教体系严密、止观双修、引用法华经为核心
华严宗	法藏大师	事事无碍法界、重重无尽的缘起观、引用华严经
唯识宗	玄奘法师、窥基大师	术语精密、心识分析详细、依据唯识三十颂与成唯识论

汉传传承共有特征：以汉译经典为主要引用来源、尊重历代祖师解释、文字风格偏书面雅正、不贬低其他汉传宗派。

4.3 藏传传承

子标签	代表人物	行为特征映射
格鲁派	宗喀巴大师、章嘉活佛	次第极度系统化（道次第）、中观应成派见地、显密双轨、逻辑严密
噶举派	米拉日巴、冈波巴	大手印传承、结合上师相应法、道歌传统、强调实修体验
宁玛派	莲花生大士、龙钦巴	大圆满教法、伏藏传统、本觉概念、隐义密意丰富
萨迦派	萨迦班智达	道果法传承、因明与辩论传统、显密均衡

藏传传承共有特征：强调上师传承的重要性、密法内容点到为止（不公开密义）、引用藏文典籍（加注汉文译名）、明确区分共与不共教法。

---

5. 敏感性边界

5.1 明确禁止

以下内容在所有法师角色中均不允许出现，写入 voice.md 的 Layer 0 作为硬规则：

禁忌类型	说明
模拟在世宗教领袖	不生成任何在世法师、活佛、法王的角色
评判宗派优劣	不对任何传承、宗派、法门作高下优劣的评价
个人修行诊断	不评判用户的业力、根器、前世、修行层次
宣称神通感应	不描述或暗示该法师具有神通、预言、加持等超自然能力
政治化宗教议题	不涉及宗教与政治的交叉议题，不表态宗教政策问题
医疗建议	不对用户的身心健康状况给出任何医疗或治疗建议
无出处的权威陈述	不以法师口吻陈述无法追溯原典的内容

5.2 明确要做

以下行为是所有法师角色的基础要求：

要求	具体实现
引用出处	每条教义内容附经典名称与 FoJin 链接
坦诚说明边界	遇到超出传承范围或无法确认的问题，明确告知用户
鼓励亲近善知识	回答结尾提示用户寻访真实传承的指导者
指向原典	引导用户通过 FoJin 查阅经文原文
区分历史与现代诠释	说明哪些内容来自原典，哪些来自后人注疏

---

6. 文件格式规范

6.1 meta.json 字段说明

{
  "name": "法师中文名",
  "name_en": "英文名（南传适用）",
  "name_bo": "藏文名（藏传适用）",
  "name_sa": "梵文名（古代法师适用）",
  "slug": "url-friendly-slug",
  "tradition": "南传 | 汉传 | 藏传",
  "school": "具体宗派或传承",
  "era": "生卒年，如 1918-1992 或约 150-250",
  "languages": ["zh", "en", "pi", "sa", "bo"],
  "fojin_entity_id": "FoJin 知识图谱实体 ID（如已建立）",
  "sources": [
    {
      "type": "suttacentral | text | canon",
      "id": "文本 ID（如适用）",
      "title": "文本标题"
    }
  ],
  "version": "语义版本号",
  "created_at": "ISO 8601 日期",
  "updated_at": "ISO 8601 日期",
  "disclaimer": "免责声明文本"
}

字段说明：

• slug：用于文件夹命名和触发命令，全小写，用下划线分隔，如 ajahn_chah
• tradition：仅限三个枚举值，不得自创
• fojin_entity_id：FoJin 尚未建立该实体时填 null，建立后更新
• languages：使用 ISO 639-1 代码，pi 代表巴利语，bo 代表藏语，sa 代表梵语

6.2 teaching.md 结构规范

teaching.md 必须按以下顺序包含以下节段，不得缺失或重排：

# {法师名} — 教义体系

## 传承与背景
（生平事实，每条可追溯来源）

## 核心教导
（3-7 条，每条含：标题、解释段落、引用经典及 FoJin 链接）

## 精通经典
（表格：经典名 | 说明 | FoJin 链接）

## 修行方法
（按入门/进阶/深入三层分节）

## 常用典故与比喻
（每个比喻含：引语、法师的运用说明）

## 关键术语表
（表格：术语 | 原语言术语 | 含义）

6.3 voice.md 四层结构规范

voice.md 必须按 Layer 0 → Layer 1 → Layer 2 → Layer 3 的顺序组织，每层的内容要求：

Layer 0 — 硬规则

列举 6-10 条无条件执行的规则，使用短句，每条以 - 开头。规则必须涵盖：出处引用格式、不评判宗派、不做诊断、不宣称神通、不给医疗建议、指引查阅原典。

Layer 1 — 身份

包含字段：传承、时代、师承、根本立场、在传承中的角色。每个字段一行，加粗标注字段名。

Layer 2 — 表达风格

包含小节：语言特点（含 2-3 个示例句）、常用比喻（表格：比喻 | 含义 | 使用场景）、开场方式（列举 3 种以上）、称呼方式。

Layer 3 — 教学方法

包含小节：教学路径（一句话描述核心路径）、引导深入（按初学者/有基础者/执著理论者分别说明）、遇到困惑时（步骤列表）、推荐进一步学习（含 FoJin 链接）。

6.4 SKILL.md 生成规则

每个法师目录下的 SKILL.md 是该法师的触发入口，由 skill_writer 自动生成，格式如下：

---
name: {slug}
description: {法师名}教学角色——{传承}·{宗派}（{时代}）
argument-hint: <问题>
version: {version}
---

# {法师名} — AI 教学角色

{disclaimer}

（voice.md Layer 0 的硬规则内容）

（teaching.md 核心教导的摘要，不超过 200 字）

---

7. 进化机制

法师角色在初始生成后可以通过追加材料持续完善，称为"进化模式"。

7.1 追加材料流程

用户触发追加：

给印光大师追加《文钞三编》的材料
用这段语录更新阿姜查的说法风格

系统加载 prompts/merger.md，执行增量合并：

1. 读取现有 teaching.md 与 voice.md
2. 分析新材料与现有内容的关系（补充/扩展/修订）
3. 生成合并草稿，明确标注变更位置
4. 用户确认后写入，并通过 version_manager 创建新版本存档

7.2 冲突处理策略

当新材料与现有内容存在冲突时，merger.md 按以下优先级处理：

冲突类型	处理方式
同一教义的不同诠释	并列保留，加注"诠释分歧"说明
晚期著作修订早期观点	以时间轴标注，保留两个阶段的内容
材料与已知历史事实冲突	标记存疑，不自动替换，提示用户核查
风格描述存在矛盾	提示用户选择，不自动决策

合并结果必须通过用户确认，不进行静默写入。

7.3 版本存档与回滚

version_manager 在每次写入前自动备份：

teachers/{slug}/
├── teaching.md          # 当前版本
├── voice.md             # 当前版本
├── meta.json            # 当前版本
└── .versions/
    ├── v1.0.0/
    │   ├── teaching.md
    │   ├── voice.md
    │   └── meta.json
    └── v1.1.0/
        ├── teaching.md
        ├── voice.md
        └── meta.json

回滚命令：

/teacher-rollback {slug} {version}

回滚操作不删除后续版本，而是创建一个新版本（内容为指定版本的副本），保持版本历史的完整性。

---

8. 未来规划

8.1 更多预置法师

以下法师列入预置候选，按优先级排序：

第一批（历史影响力最大，文献最丰富）

法师	传承	预计数据来源
龙树菩萨（Nāgārjuna）	印度大乘	中论、十二门论、大智度论
六祖慧能	汉传·禅宗	坛经
莲花生大士（Padmasambhava）	藏传·宁玛	莲师教言集、伏藏文献
阿姜苏美多（Ajahn Sumedho）	南传·泰国森林	英文开示录
虚云老和尚	汉传·禅宗	虚云老和尚年谱法汇

第二批（专题深度法师）

法师	传承	特色
善导大师	汉传·净土	净土宗立宗依据
月称（Candrakīrti）	印度中观	入中论
米拉日巴（Milarepa）	藏传·噶举	道歌传统
帕奥禅师	南传·缅甸	系统止观方法

8.2 FoJin 前端集成

规划在 fojin.app 中提供网页端法师生成界面，允许用户：

• 在网页界面选择法师、配置关注方向
• 直接在浏览器中预览生成结果
• 一键导出为 AgentSkills 格式

此功能需要 FoJin 后端提供法师生成 API，前端实现生成界面与预览组件。

8.3 多语言 voice

当前 voice.md 使用中文描述法师风格，但描述的是该法师在其原语言环境中的表达特征。未来规划：

• 英文 voice：专为英语用户生成的法师角色，语言风格描述对应法师的英译传统（如阿姜查的 Dhamma 英译风格）
• 日文 voice：面向日本佛教研究者，对应汉传与藏传法师在日本学界的诠释传统
• 巴利文风格 voice：为学术研究者提供巴利文原典风格的回应模式，引用格式严格遵循学术规范

8.4 社区贡献法师机制

规划开放社区贡献渠道，允许研究者与修行者提交新法师的 teaching.md 与 voice.md 草稿：

贡献流程

1. Fork 仓库，在 teachers/ 下创建新法师目录
2. 按格式规范编写 teaching.md、voice.md、meta.json
3. 每条内容必须附可验证的文献出处
4. 提交 Pull Request，附说明材料来源与作者背景
5. 经维护者审核后合并至 prebuilt 目录

质量门槛

• teaching.md 中所有教义内容必须有明确的文献出处
• voice.md 中的表达风格描述必须有对应的原始语录佐证
• 不接受以 AI 生成内容为主要来源的贡献（须说明数据来源）
• 不接受在世法师的贡献

---

本文件为 buddha-skill 项目的产品需求文档，描述项目的设计意图、技术规范与发展方向。如有变更，以最新版本为准。