master-skill 0.9.1 → 0.10.1

package/references/teaching-modes.md

@@ -0,0 +1,84 @@
+# 教学模式选择决策树
+
+> **何时读这个**：用户犹豫该用 `/compare-masters` / `/master-debate` / `/master-curriculum` 哪个时；用户问"哪些祖师对这个问题怎么看"但意图不明时。
+
+## 三模式速查
+
+| 模式 | 维度 | 轮次 | 输出 | 适合场景 |
+|------|------|------|------|---------|
+| `/compare-masters` | 横向 / 并列 | 单轮 | 多位祖师对同一问题的并列答案 | 想看不同传统 / 宗派的视角差异，**不需要互相反驳** |
+| `/master-debate` | 横向 / 对立 | 4 轮 | 立论 → 反驳 → 回应 → 综合 + 教内余争 | 想看争议议题的**深入分歧**，关心"谁的见地更究竟" |
+| `/master-curriculum` | 纵向 / 时序 | 单次规划 | 「根基 → 深入 → 精研 → 盲点」学修路径 | **不是比较，是请求学习计划** |
+
+## 决策树（用户表达 → 模式）
+
+```
+用户问"X 问题"时：
+│
+├─ 包含"学习计划 / 路径 / 入门 / 先学什么 / 下一步读什么 / curriculum"
+│     → /master-curriculum
+│
+├─ 包含"辩论 / 各执一词 / 谁更对 / 究竟 / 高下 / 争议 / debate"
+│     → /master-debate
+│
+├─ 包含"对比 / 比较 / 不同视角 / 各派怎么看 / X vs Y / compare"
+│     │
+│     ├─ 议题本身有传统对立性（禅净 / 空有 / 顿渐 / 应成 vs 顿悟）
+│     │     │
+│     │     ├─ 用户语气中性 / 想看多角度 → /compare-masters
+│     │     └─ 用户想看深入分歧 / 谁更对 → /master-debate
+│     │
+│     └─ 议题中性（如"慈悲 / 业 / 缘起"）
+│           → /compare-masters
+│
+└─ 没有比较 / 辩论 / 学习计划意图，只是问"X 怎么修"
+      → 单 master skill（按传承推荐：禅 → huineng / 净土 → yinguang / 中观 → kumarajiva / 道次第 → atisha 或 tsongkhapa / 内观 → mahasi-sayadaw 等）
+```
+
+## 关键关键词速查
+
+### `/compare-masters` 触发关键词
+
+- 对比 / 比较 / compare / 不同视角 / 各派怎么看 / 各位祖师怎么看 / 多个角度
+- 显式举出 2-N 位祖师并问"他们怎么说" → 平铺单轮答
+
+### `/master-debate` 触发关键词
+
+- 辩论 / 各执一词 / 谁更对 / 究竟 / 高下 / 争议 / debate / 顿渐之争 / 性相之辩 / 空有之争 / 禅净之争
+- 问"X 派和 Y 派的核心分歧" → 4 轮对辩
+- 关键：用户想看**对抗式反复推敲**，不是平铺
+
+### `/master-curriculum` 触发关键词
+
+- 学修次第 / 学习计划 / 入门 / 先学什么 / 从哪开始 / 路径推荐 / curriculum / roadmap / 怎么修
+- 问"禅宗从哪开始学" → 时序路径，不是比较
+
+## 示例输入分类
+
+| 用户原话 | 模式 | 理由 |
+|---------|------|------|
+| "禅宗和净土宗怎么比较" | `/compare-masters` | 平铺对比，无对立请求 |
+| "禅净之争究竟谁更对" | `/master-debate` | 显式对立 + 问"谁更对" |
+| "我想学禅宗从哪开始" | `/master-curriculum` | 个人学习路径 |
+| "天台和华严的圆教有什么不同" | `/compare-masters` | 对比但无对抗语气 |
+| "性相之辩玄奘和鸠摩罗什会怎么辩" | `/master-debate` | 议题对立 + 显式辩论框架 |
+| "刚开始学藏传，应该读什么" | `/master-curriculum` | 入门路径请求 |
+| "应成中观和顿悟禅的分判" | `/master-debate` | 涉及"分判" → 深入分歧 |
+| "印光大师和虚云老和尚的修法异同" | `/compare-masters` | "异同" → 平铺，非对辩 |
+| "中观、唯识、华严的判教高下" | `/master-debate` | "高下" → 对辩 |
+| "想综合学习汉传佛教，应该按什么顺序" | `/master-curriculum` | "按什么顺序" → 时序 |
+
+## 选错模式时的兜底
+
+用户在某模式中明显错位时（如 `/compare-masters` 输入"谁更对"），优雅建议切换：
+
+> 「您似乎想看深入的对辩交锋，建议改用 `/master-debate`，4 轮立论-反驳-回应-综合更适合您的问题。是否切换？」
+
+## 单 master skill vs 模式选择
+
+如果用户的问题**没有任何比较 / 辩论 / 计划意图**，只是想知道"X 议题怎么修"或"X 祖师怎么说"：
+
+- 单一传统议题 → 直接用对应 master skill（如 `/master-yinguang` 答念佛、`/master-huineng` 答见性）
+- 不知道哪位祖师 → 按 `references/traditions.md` §"选择传统的常见判断" 表推荐入门
+
+> 模式 skill（compare / debate / curriculum）成本更高（需聚合多 master 数据）。如非必要，先用单 master skill。

package/references/traditions.md

@@ -0,0 +1,72 @@
+# 三大传统总论
+
+> **何时读这个**：用户问汉传/藏传/南传的差异、宗派定位、某祖师属于哪派、想知道选择哪个传统入门时。
+> 本文档供 create-master 主流程在 Step 1 信息录入识别传承时参考，也供回答用户的传统对比问题时调用。
+
+## 三大传统 — 一句话定位
+
+| 传统 | 时空 | 核心特征 |
+|------|------|---------|
+| **汉传** | 公元 1 世纪起经丝路传入中国，再传朝鲜 / 日本 / 越南 | 大乘为主；汉译三藏 + 本土宗派创立（天台/华严/禅/净/律/唯识/三论/密）；判教传统发达 |
+| **藏传** | 7-8 世纪经印度大师入藏（莲花生 / 阿底峡），后弘期定型 | 大乘 + 金刚乘并行；显密双修；活佛转世制度；格鲁/宁玛/萨迦/噶举四大派 |
+| **南传** | 公元前 3 世纪阿育王派传至斯里兰卡，后传缅甸/泰国/柬埔寨/老挝 | 上座部独传；以巴利三藏为根本；觉音《清净道论》为论藏统宗；强调出家僧团与内观禅修 |
+
+## 汉传八宗（预置法师对应）
+
+| 宗派 | 核心教义 | 代表法师 | 主依经典 |
+|------|---------|---------|---------|
+| 三论宗 / 中观 | 缘起性空、中道八不 | 鸠摩罗什 (`/master-kumarajiva`) | 《中论》《百论》《十二门论》《大智度论》 |
+| 唯识 / 法相 | 三性三无性、八识、转识成智 | 玄奘 (`/master-xuanzang`) | 《成唯识论》《瑜伽师地论》《摄大乘论》 |
+| 天台 | 一念三千、三谛圆融、五时八教、止观双运 | 智顗 (`/master-zhiyi`) | 《法华经》《摩诃止观》《法华玄义》 |
+| 华严 | 法界缘起、四法界、十玄六相、一即一切 | 法藏 (`/master-fazang`) | 《华严经》《金师子章》《华严五教章》 |
+| 禅宗 | 直指人心、见性成佛、教外别传 | 慧能 (`/master-huineng`)、虚云 (`/master-xuyun`) | 《六祖坛经》《金刚经》《楞伽经》 |
+| 净土 | 信愿持名、带业往生 | 印光 (`/master-yinguang`) | 《无量寿经》《观经》《阿弥陀经》 |
+| 跨宗派（教宗天台·行归净土） | 性相融会、禅教律净一体 | 蕅益 (`/master-ouyi`) | 《弥陀要解》《教观纲宗》《灵峰宗论》 |
+
+> **律宗 / 真言宗 / 三阶教等暂无预置法师**。如用户问相关宗派祖师（弘一 / 道宣 / 空海 / 信行等），按 create-master 主流程检查 ETHICS Tier 后生成。
+
+## 藏传四派（预置法师对应）
+
+| 派别 | 形成期 | 核心传承 | 代表法师 |
+|------|--------|---------|---------|
+| 噶当派 | 11 世纪 | 阿底峡《菩提道灯论》、三士道、依止善知识 | 阿底峡 (`/master-atisha`) |
+| 噶举派 | 11-12 世纪 | 大手印、那洛六法、口耳传承 | 米拉日巴 (`/master-milarepa`) |
+| 萨迦派 | 11 世纪 | 道果教授、显密融贯 | （暂无预置） |
+| 格鲁派 | 14-15 世纪 | 宗喀巴《菩提道次第广论》、三主要道、应成中观 | 宗喀巴 (`/master-tsongkhapa`) |
+| 宁玛派 | 7-8 世纪奠基，后弘期成形 | 大圆满、伏藏 | （暂无预置） |
+
+> 格鲁派被视为噶当派的复兴形态，故"噶当→格鲁"为道次第传承主线。
+
+## 南传上座部主要禅法传承（预置法师对应）
+
+| 流派 | 起源 | 核心特征 | 代表法师 |
+|------|------|---------|---------|
+| 大寺派论师传统 (Mahāvihāra) | 5 世纪斯里兰卡 | 《清净道论》七清净十六观智体系 | 觉音 (`/master-buddhaghosa`) |
+| 缅甸内观（Mahasi 系） | 20 世纪缅甸 | 标记法、腹部起伏、密集禅修 | 马哈希尊者 (`/master-mahasi-sayadaw`) |
+| 泰国森林禅林派 | 20 世纪泰国 | 头陀苦行、自然观察、巴蓬寺传承 | 阿姜查 (`/master-ajahn-chah`) |
+
+> 缅甸系还有列迪 (Ledi Sayadaw) → 乌巴庆 (U Ba Khin) → 葛印卡 (S.N. Goenka) 一脉；泰国森林系还有阿姜曼 (Ajahn Mun) → 阿姜放 (Ajahn Fuang) 等。目前预置覆盖大寺派论藏 + 缅泰两大现代禅修支脉。
+
+## 选择传统的常见判断（用户咨询入门时）
+
+| 用户倾向 | 推荐传统 / 入门法师 |
+|---------|-----------------|
+| 想读经典原文做学理研究 | 汉传（鸠摩罗什译笈 / 玄奘译笈）+ 南传（觉音《清净道论》） |
+| 想要明确禅修指引 | 南传（马哈希标记法 / 阿姜查自然觉知） |
+| 想要密法 / 仪轨传承 | 藏传（先三士道入门：阿底峡 / 宗喀巴） |
+| 想要顿悟见性的禅风 | 汉传禅宗（慧能 / 虚云） |
+| 想要简明易行的解脱道 | 汉传净土（印光） |
+| 教理与实修结合 | 汉传天台（智顗）/ 藏传格鲁（宗喀巴） |
+
+> **不评宗派优劣**。以上为基于用户表达需求的引导建议，不构成对传统本身的判断。涉及具体选择，应建议用户亲近善知识。
+
+## 跨传统对比的常见议题（路由到 `/master-debate`）
+
+- 空有 / 中观 vs 唯识 → 鸠摩罗什 vs 玄奘
+- 顿渐 / 顿悟 vs 次第 → 慧能 vs 智顗 / 宗喀巴
+- 禅净 / 念佛 vs 参禅 → 慧能 vs 印光
+- 戒律行持 vs 直观内观 → 阿姜查 vs 马哈希
+- 三士道 vs 自性见 → 阿底峡 vs 慧能
+- 应成 vs 顿悟 → 宗喀巴 vs 慧能
+
+更多对立配对 → `prebuilt/master-debate/SKILL.md`。

package/references/workflow-details.md

@@ -0,0 +1,361 @@
+# create-master 主流程细节
+
+> **何时读这个**：进入主流程 Step 1-5 任一步遇到细节问题（错误兜底、用户交互文案、版本号策略）时；处理"追加材料 / 纠正 / 管理命令"涉及版本与冲突时；运行时执行优先级冲突解释场景。
+> 主流程骨架在根 SKILL.md，本文档是按需展开的"细则手册"。
+
+## Step 1：信息录入细则
+
+### 快捷入口（用户直接给名）
+
+用户直接输入 `/create-master 弘一大师` → 跳过交互问答，自动填充默认值：
+- 关注方面 = 全部
+- 语言 = 根据传承自动推荐（汉传/中文，藏传/中文+藏文术语注音，南传/中文+巴利术语注音）
+
+展示确认摘要：
+
+```
+即将创建：弘一大师
+传承：汉传（律宗）
+关注方面：全部
+语言：中文
+确认创建？(Y/n)
+```
+
+用户确认后直接进入 Step 2。
+
+### 语言自动检测
+
+根据用户**第一条消息**的语言决定后续全部交互语言：
+- 中文消息 → 中文回复
+- English message → English replies
+- 其他语言同理
+
+中途切换语言 → 跟随切换，但保持术语原文 + 注音。
+
+### FoJin KG 匹配
+
+- **匹配成功** → 自动填充传承、时代、宗派等元数据，展示给用户确认
+- **匹配失败** → 提示：
+
+  > "未在 FoJin 知识图谱中找到「{name}」。请确认名称是否正确，或提供以下信息以手动创建：宗派（如禅宗/净土/天台/华严/唯识等）、时代、师承。"
+
+- 用户提供补充信息后，以**手动模式**继续（仍走 Step 2，但跳过 KG 实体采集，仅做经文检索）
+
+### 名称校验规则
+
+- 名称必须为**历史真实人物**，不接受虚构角色（小说人物 / 游戏角色 / 神话人物 / 在世法师）
+- 检测到非历史 / 虚构人物 → 回复：
+
+  > "本工具仅支持历史上真实存在的高僧大德，无法为虚构人物创建教学角色。"
+
+- 名称不可为空、不可为纯数字 / 特殊字符
+- 多写法名（如"鸠摩罗什"/"鸠摩罗什婆"）→ 优先 FoJin KG 中的**标准名称**
+- 已存在（预置或已生成） → 提示：
+
+  > "「{name}」已存在，可直接使用 /master-{slug} 调用。如需重新生成，请先执行 /delete-master {slug}。"
+
+- 在世法师 / 圆寂未足版权期 → 走 `references/ethics-runtime.md` §版权分级 Tier B/C 流程
+
+## Step 2：数据采集细则
+
+### 采集内容
+
+```bash
+python3 ${CLAUDE_SKILL_DIR}/tools/sutra_collector.py --name "<法师名>" --tradition "<传承>" --output collected_data.json
+```
+
+包括：
+- 知识图谱实体与师承关系
+- 相关经典列表与内容摘录
+- 传承相关术语（汉传 → CBETA 经名 / 藏传 → 藏文典名 + Toh 编号 / 南传 → SC 经名 + PTS 编号）
+
+### API 故障处理
+
+FoJin API 返回错误或不可达 → 向用户说明：
+
+> "FoJin API 暂时不可用（错误信息：{error}）。您可以：①稍后重试；②进入手动输入模式，提供经文文本。"
+
+手动输入模式下，用户可粘贴经文原文或提供 CBETA 经号，系统基于用户提供的材料继续生成。**但所有用户提供的经号仍须经 verify_sources.py 验证。**
+
+### 超时与重试
+
+- 每次 API 调用超时 = 30 秒
+- 超时自动重试 1 次
+- 仍失败 → 触发上述故障处理
+
+### 最低数据阈值
+
+采集到经文 < 3 条 → 警告：
+
+> "仅找到 {n} 条相关经文，生成的角色内容可能不够丰富。建议：①追加关键词重新搜索；②手动补充经文材料；③继续生成（内容可能有限）。"
+
+### 引用验证
+
+采集完成后：
+
+```bash
+python3 ${CLAUDE_SKILL_DIR}/tools/verify_sources.py --check-links collected_data.json
+```
+
+该命令离线检查来源家族、ID 格式、声明归属与自动派生的 citation contract；它不请求外部站点。
+格式或归属无效的来源须在 Step 3 前排除。外部可达性如有需要，应另作人工或可选在线核验。
+详细引用规则 → `references/source-conventions.md`。
+
+### 采集结果确认
+
+```
+数据采集完成：
+  知识图谱实体：{n} 个
+  相关经典：{m} 部
+  内容摘录：{k} 段
+  无效链接：{j} 个（已排除）
+继续分析？(Y/n)
+```
+
+## Step 3：分析与生成细则
+
+### 运行时检索规则
+
+加载 `${CLAUDE_SKILL_DIR}/prompts/rag_instructions.md`，将检索指引嵌入生成的每个法师 SKILL.md 运行规则中——确保法师回答时调用 FoJin 实时检索而非仅依赖 LLM 自身知识。
+
+### 两阶段分析
+
+1. **教义分析** — 加载 `prompts/sutra_analyzer.md` + 采集数据，分析教义结构：核心教义维度、关键经典、修行次第
+2. **风格分析** — 加载 `prompts/voice_analyzer.md` + 采集数据，分析说法风格：语言特征、说法模式、常用譬喻
+
+### 宗派标签自动检测（风格规则路由）
+
+按 FoJin KG 宗派信息自动选用 voice_analyzer 中对应宗派的风格规则：
+
+| 宗派 | 风格特征 |
+|------|---------|
+| 禅宗 | 机锋、公案风格 |
+| 净土宗 | 劝信、念佛开示风格 |
+| 天台宗 | 判教、止观论述风格 |
+| 华严宗 | 圆融、法界观论述风格 |
+| 唯识 / 法相 | 因明论证、术语精确风格 |
+| 三论 / 中观 | 八不破立、二谛说法 |
+| 律宗 | 戒法持犯、止持作持论述 |
+| 藏传格鲁 | 道次第论证、应成中观三士道 |
+| 藏传噶举 | 大手印诗偈 / 道歌风格（米拉日巴 mGur） |
+| 南传上座部 | 七清净十六观智论述、巴利原文穿插 |
+
+### 质量门控
+
+分析器输出中任一维度标记 `"insufficient_data": true` → 向用户提示：
+
+> "以下维度的数据不足，生成质量可能受影响：{dimensions}。"
+> "建议追加相关经文材料后重新分析，或选择继续生成（不足部分将标注警告）。"
+
+用户继续 → 生成文件中对不足维度添加 `<!-- DATA_LIMITED -->` 注释。
+
+### 生成阶段
+
+- **教义生成**：`prompts/teaching_builder.md` → `teaching.md`
+- **风格生成**：`prompts/voice_builder.md` → `voice.md`（4 层结构）
+
+### voice.md 4 层结构
+
+| Layer | 含义 | 示例 |
+|-------|------|------|
+| **0** | 硬规则，不可违反的底线 | "不自称已证悟"、"不预言未来"、"不冒充佛"、"不收弟子" |
+| **1** | 核心风格，该法师最显著的说法特征 | 慧能：直指见性 / 印光：劝信念佛 / 玄奘：因明严谨 |
+| **2** | 辅助风格，次要但常见的表达模式 | 引用习惯、常用譬喻、句式偏好 |
+| **3** | 情境风格，特定场景下的应对方式 | 面对学者 / 面对初学 / 面对疑惑 / 面对争执 |
+
+## Step 3.5：二阶段审查细则
+
+### 顺序不可颠倒
+
+教义准确性审查 → 风格一致性审查。**不可颠倒**，因为教义错误修复可能影响风格层级。
+
+### 教义准确性审查
+
+生成器先从 `sources[].type` 派生 citation contract，并在内存中保留同一个 sources/contract 对象。
+`prompts/doctrine_reviewer.md` 接收这个**生成器内存上下文**及 teaching.md：
+- 经证覆盖率（目标 ≥ 90%）
+- 各来源家族 ID 的声明归属准确性
+- 宗派边界越界（如让慧能讲三士道）
+- 输出：PASS / PASS WITH WARNINGS / FAIL
+
+最终 spec 与 `meta.json` 必须复用同一个 contract；写入器会重新按 `sources[].type` 派生并拒绝漂移。
+
+FAIL → 自动修复严重问题后重审，**最多 2 轮**。仍 FAIL → 报告问题请求人工介入。
+
+### 风格一致性审查
+
+`prompts/voice_reviewer.md` 对 voice.md：
+- Layer 0 硬规则完整性
+- 风格与宗派特征匹配度
+- 层次结构清晰度
+- 输出：PASS / PASS WITH WARNINGS / FAIL
+
+FAIL → 自动修复后重审。
+
+### 结果展示
+
+```
+══ 审查结果 ══
+教义准确性：PASS (经证覆盖率 95%, 0 严重问题)
+风格一致性：PASS WITH WARNINGS (Layer 0 完整, 1 警告)
+  警告：Layer 2 缺少"面对学者"的情境风格
+══════════════
+```
+
+两项均 PASS 或 PASS WITH WARNINGS 后，进入 Step 4。
+
+## Step 4：预览与确认细则
+
+### 结构化预览格式
+
+```
+══ 教义预览（teaching.md）══
+核心教义：{1-3 条核心教义概要}
+关键经典：{主要引用经典列表}
+修行次第：{修行路径概要}
+
+══ 风格预览（voice.md）══
+风格特征：{2-3 条风格特点}
+语言模式：{典型表达方式}
+示例句：
+  1. "{模拟该法师风格的示例句1}"
+  2. "{模拟该法师风格的示例句2}"
+══════════════════════════
+```
+
+### 用户修改请求识别
+
+| 用户说 | 处理 |
+|--------|------|
+| "修改教义部分" | 重新展示 teaching.md 详情，接受用户逐条调整 |
+| "调整风格更严厉一些" / "语气更温和" | 调整 voice.md 风格参数后重新预览 |
+| "添加更多关于{主题}的内容" | 针对性补充特定教义维度 |
+| "重新生成" | 以调整后的参数重新执行 Step 3，重新展示预览 |
+
+## Step 5：写入文件细则
+
+```bash
+python3 ${CLAUDE_SKILL_DIR}/tools/master_builder.py --spec generated-master.json --output masters/
+```
+
+`generated-master.json` 是审查通过后的生成规格，必含 `name`、`tradition`、`school`、`era`、
+`languages`、`teaching_content`、`voice_content`、`sources`，并可携带审查所用的同一
+`citation_contract`。若携带的 contract 与来源家族自动派生结果不同，构建立即失败。
+
+### 生成后终验
+
+```bash
+python3 ${CLAUDE_SKILL_DIR}/tools/verify_sources.py --final-check masters/master-{slug}/
+```
+
+`--final-check` 离线验证 persona 目录包含 `SKILL.md`、`teaching.md`、`voice.md`、`meta.json`，
+并验证 `meta.json` 的来源家族、ID 格式、声明归属与 citation contract。它不会解析
+`teaching.md` 的自由文本引文，也不检查外部链接 HTTP 状态；外部可达性是独立的人工或可选在线步骤。
+
+### 生成目录结构
+
+```
+masters/master-{slug}/
+├── SKILL.md          # /master-{slug} 触发（完整角色定义）
+├── teaching.md       # 教义体系（可单独使用）
+├── voice.md          # 说法风格（可单独使用）
+└── meta.json         # 元数据（版本、生成时间、数据来源）
+```
+
+### 角色注册（按运行环境）
+
+**Claude Code 用户**
+1. 生成的 SKILL.md 已放置在 `masters/master-{slug}/`
+2. 确保 `masters/` 在 Claude Code skill 搜索路径中（检查 `.claude/settings.json` 的 `skillDirs` 配置）
+3. 完成后自动可通过 `/master-{slug}` 触发
+
+**OpenClaw 用户**
+1. 将 `masters/master-{slug}/` 复制到 OpenClaw 的 skills 目录
+2. 在 OpenClaw 配置中注册新 skill
+3. 参考 OpenClaw 文档完成注册流程
+
+### 完成提示
+
+```
+已生成「{master_name}」教学角色
+  目录：masters/master-{slug}/
+  调用命令：/master-{slug}
+  包含文件：SKILL.md, teaching.md, voice.md, meta.json
+  数据来源：{n} 条经文，{m} 个知识图谱实体
+```
+
+## 追加材料、纠正、管理命令细则
+
+### 追加材料（进化模式）
+
+**触发短语**：
+- "给印光大师追加《文钞三编》的材料"
+- "追加《经名》的材料"
+- "补充关于{主题}的内容"
+- "用这段语录更新慧能大师的说法风格"
+
+加载 `prompts/merger.md` 增量合并。
+
+**合并冲突处理**：
+- merger.md 策略：「新数据优先、保留原有结构」
+- 教义矛盾（如不同经典对同一概念阐述差异）→ 保留双方并加注释说明差异
+- 风格冲突 → 新材料风格特征与现有特征**合并**，不覆盖
+
+**版本自动递增**：
+- 每次追加 → meta.json `version` 自动 minor 递增（1.0.0 → 1.1.0）
+- 旧版本自动归档到 `masters/master-{slug}/versions/`
+- `/master-rollback` 可回退到任意历史版本
+
+### 纠正模式
+
+用户对 AI 表现提出纠正：
+- "他不会这样说话"
+- "他应该更严厉一些"
+- "他遇到这种问题会先引用《法华经》"
+
+加载 `prompts/correction_handler.md`。
+
+**纠正处理流程**：
+1. 识别纠正类型：教义纠正 → `teaching.md`；风格纠正 → `voice.md`
+2. 以 `## Correction` 块格式追加到对应文件**末尾**，含时间戳 + 原始反馈
+3. 纠正记录的优先级**高于**分析生成的内容（详见下文执行优先级）
+4. 每次纠正 → meta.json 版本号 patch 递增（1.1.0 → 1.1.1）
+
+### 管理命令
+
+| 命令 | 行为 |
+|------|------|
+| `/list-masters` | 列出所有已生成的法师，显示传承、时代、版本号；预置标 `[预置]`，自定义标 `[自定义]` |
+| `/master-rollback <slug> <version>` | 回滚到指定版本；当前版本自动归档到 `.versions/`；指定版本不存在 → 列出可用版本供选择 |
+| `/delete-master <slug>` | 删除法师目录；执行前二次确认："确定要删除「{master_name}」吗？此操作不可恢复。输入 'yes' 确认。"；**预置不可删除** |
+
+## 执行优先级冲突细则
+
+法师角色运行时优先级（高→低）：
+
+1. voice.md Layer 0 硬规则
+2. Correction 记录
+3. voice.md Layer 1-3
+4. teaching.md 教义内容
+5. FoJin RAG 实时检索结果
+6. LLM 自身知识
+
+### 典型冲突场景示例
+
+| 场景 | 处理 |
+|------|------|
+| voice.md Layer 0 规定"不自称已证悟"，teaching.md 有该法师证悟记载 | 回答时**不以第一人称宣称证悟**（Layer 0 覆盖 teaching） |
+| 用户纠正"他从不直接回答是非题"，voice.md Layer 1 可能有直接回答模式 | 纠正记录覆盖 Layer 1（Correction 高于 Layer 1-3） |
+| FoJin RAG 检索经文与 teaching.md 记载有细节差异 | 以 teaching.md 为准（RAG 作为补充参考） |
+| LLM 自有知识与 teaching.md 冲突 | 以 teaching.md 为准（LLM 知识最低优先级） |
+
+## FoJin API 深度使用
+
+`rag_query.py` 不够用的场景（KG 深度遍历、跨词典分组对比等）→ 参考 `references/fojin-api.md`（REST API 完整参考）。
+
+## 衔接其他 references
+
+- 引用规则（CBETA / BDRC / SC / Toh / PTS）→ `references/source-conventions.md`
+- HARD-GATE 完整规则、AI 透明度、版权分级、边界场景 → `references/ethics-runtime.md`
+- 三大传统总论、宗派定位、跨传统对比议题 → `references/traditions.md`
+- compare / debate / curriculum 选择 → `references/teaching-modes.md`

package/requirements.txt

@@ -0,0 +1,6 @@
+# requests 2.33+ requires Python 3.10. Keep the documented Python 3.9 floor
+# on the latest compatible 2.32 patch while newer runtimes use the current line.
+requests>=2.32.5,<2.33; python_version < "3.10"
+requests>=2.34.2; python_version >= "3.10"
+pypinyin>=0.55.0
+pyyaml>=6.0.3

package/scripts/select-fidelity-smoke.py

@@ -0,0 +1,78 @@
+#!/usr/bin/env python3
+"""Select one fidelity smoke target from persona metadata."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+
+class SelectionError(ValueError):
+    """Raised when a smoke target cannot be selected safely."""
+
+
+def discover_roster(prebuilt: Path) -> list[str]:
+    """Return sorted persona directories with a non-empty sources list."""
+    roster: list[str] = []
+    for meta_path in sorted(prebuilt.glob("master-*/meta.json")):
+        try:
+            metadata = json.loads(meta_path.read_text(encoding="utf-8"))
+        except (OSError, json.JSONDecodeError) as exc:
+            raise SelectionError(f"Invalid metadata {meta_path}: {exc}") from exc
+        sources = metadata.get("sources")
+        if isinstance(sources, list) and sources:
+            roster.append(meta_path.parent.name)
+    return roster
+
+
+def parse_day_of_year(raw_day: str) -> int:
+    """Parse a zero-padded day of year explicitly as base 10."""
+    try:
+        day = int(raw_day, 10)
+    except ValueError as exc:
+        raise SelectionError(f"Invalid day-of-year: {raw_day!r}") from exc
+    if not 1 <= day <= 366:
+        raise SelectionError(f"Invalid day-of-year: {raw_day!r}")
+    return day
+
+
+def select_target(
+    roster: list[str], day_of_year: int, changed: list[str]
+) -> str:
+    """Prefer the first discovered changed persona; otherwise rotate by day."""
+    if not roster:
+        raise SelectionError("No persona smoke targets discovered from metadata sources")
+    for candidate in changed:
+        if candidate in roster:
+            return candidate
+    return roster[day_of_year % len(roster)]
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--prebuilt", type=Path, default=Path("prebuilt"))
+    parser.add_argument("--day-of-year", required=True)
+    parser.add_argument(
+        "--changed",
+        action="append",
+        default=[],
+        help="changed prebuilt directory; repeat to preserve diff order",
+    )
+    args = parser.parse_args()
+
+    try:
+        roster = discover_roster(args.prebuilt)
+        day_of_year = parse_day_of_year(args.day_of_year)
+        target = select_target(roster, day_of_year, args.changed)
+    except SelectionError as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        return 1
+
+    print(target)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())