master-skill 0.6.0 → 0.9.0

package/SKILL.md

@@ -20,17 +20,19 @@ allowed-tools:
 
 ## 触发条件
 
-以下方式均可触发：
 - `/create-master` 或 `/create-master <法师名>`
 - "帮我创建一个印光大师的教学角色"
 - "生成慧能大师的 AI Skill"
 - "我想和玄奘法师学习"
 
-## 预置法师
+## 预置法师（直接调用，无需生成）
 
-以下三大传统祖师大德可直接使用，无需生成：
+**印度**
+
+- `/master-nagarjuna` — 龙树菩萨（印度·中观｜八宗共祖）
 
 **汉传**
+
 - `/master-xuanzang` — 玄奘法师（法相唯识宗）
 - `/master-kumarajiva` — 鸠摩罗什（三论宗/中观）
 - `/master-huineng` — 慧能大师（禅宗六祖）
@@ -41,298 +43,77 @@ allowed-tools:
 - `/master-xuyun` — 虚云老和尚（禅宗·五宗兼嗣）
 
 **藏传**
+
 - `/master-atisha` — 阿底峡尊者（噶当派开祖 · 三士道 · 982-1054）
-- `/master-tsongkhapa` — 宗喀巴大师（格鲁派创始人 · 三主要道 · 应成中观 · 1357-1419）
-- `/master-milarepa` — 米拉日巴尊者（噶举派 · 大手印 · 那洛六法 · 1052-1135）
+- `/master-tsongkhapa` — 宗喀巴大师（格鲁派创始人 · 三主要道 · 1357-1419）
+- `/master-milarepa` — 米拉日巴尊者（噶举派 · 大手印 · 1052-1135）
 
 **南传**
+
 - `/master-buddhaghosa` — 觉音尊者（上座部论师 · 《清净道论》· 5世纪）
 - `/master-mahasi-sayadaw` — 马哈希尊者（缅甸内观 · 标记法 · 1904-1982）
-- `/master-ajahn-chah` — 阿姜查（泰国森林禅林派 · 巴蓬寺传承 · 1918-1992）
-
-## 对比模式
-
-- `/compare-masters` — 多位法师对同一问题的对比回答
-
-## 主流程
-
-### Step 1：信息录入
+- `/master-ajahn-chah` — 阿姜查（泰国森林禅林派 · 1918-1992）
 
-加载 `${CLAUDE_SKILL_DIR}/prompts/intake.md`，按照 3 问模式收集信息：
-1. 法师名称 → 自动匹配 FoJin 知识图谱
-2. 关注方面 → 教义/修行/讲解/全部
-3. 语言偏好 → 根据传承自动推荐
+## 教学模式（多祖师协作）
 
-**快捷入口**：如用户直接提供法师名称（如 `/create-master 弘一大师`），跳过交互式问答，自动填充默认值（关注方面=全部，语言=根据传承推荐），进入确认流程。展示确认摘要：
+- `/compare-masters` — 多位法师对同一问题的并列对比（横向 / 单轮）
+- `/master-debate` — 祖师就争议议题进行 4 轮交叉辩论（多轮 / 看分歧）
+- `/master-curriculum` — 按你的传统给出"根基→深入→精研→盲点"学修路径（纵向时序）
 
-```
-即将创建：弘一大师
-传承：汉传（律宗）
-关注方面：全部
-语言：中文
-确认创建？(Y/n)
-```
+> 选择哪个模式？读 `references/teaching-modes.md`（含决策树与示例）。
 
-用户确认后直接进入 Step 2。
+## 主流程（生成新法师）
 
-**语言自动检测**：根据用户第一条消息的语言决定后续全部交互语言。中文消息 → 中文回复；English message → English replies；其他语言同理。
+### Step 1：信息录入
 
-**FoJin 知识图谱匹配**：
-- 匹配成功 → 自动填充传承、时代、宗派等元数据，展示给用户确认
-- 匹配失败 → 提示："未在 FoJin 知识图谱中找到「{name}」。请确认名称是否正确，或提供以下信息以手动创建：宗派（如禅宗/净土/天台/华严/唯识等）、时代、师承。"
-- 用户提供补充信息后，以手动模式继续
+加载 `${CLAUDE_SKILL_DIR}/prompts/intake.md`，3 问模式收集：①法师名称（FoJin KG 自动匹配） ②关注方面（教义/修行/讲解/全部） ③语言偏好（按传承默认）。
 
-**校验规则**：
-- 名称必须为历史真实人物，不接受虚构角色（如小说人物、游戏角色）
-- 如检测到非历史人物，回复："本工具仅支持历史上真实存在的高僧大德，无法为虚构人物创建教学角色。"
-- 名称不可为空，不可为纯数字或特殊字符
-- 如用户输入的名称有多种写法（如"鸠摩罗什"/"鸠摩罗什婆"），优先使用 FoJin KG 中的标准名称
-- 如该法师已存在于预置列表或已生成列表中，提示："「{name}」已存在，可直接使用 /{slug} 调用。如需重新生成，请先执行 /delete-master {slug}。"
+快捷入口、KG 匹配兜底、名称校验规则细节 → `references/workflow-details.md` §Step 1。
 
 ### Step 2：数据采集
 
-使用 `${CLAUDE_SKILL_DIR}/tools/sutra_collector.py` 从 FoJin 采集数据：
-
-```bash
-python3 ${CLAUDE_SKILL_DIR}/tools/sutra_collector.py --name "<法师名>" --tradition "<传承>"
-```
-
-采集内容包括：
-- 知识图谱实体和师承关系
-- 相关经典列表和内容摘录
-- 传承相关术语
-
-**API 故障处理**：
-- 如 FoJin API 返回错误或不可达，向用户说明："FoJin API 暂时不可用（错误信息：{error}）。您可以：1) 稍后重试；2) 进入手动输入模式，提供经文文本。"
-- 手动输入模式下，用户可粘贴经文原文或提供 CBETA 经号，系统基于用户提供的材料继续生成
-
-**超时设置**：每次 API 调用超时时间为 30 秒。超时后自动重试一次，仍失败则触发上述故障处理。
-
-**最低数据阈值**：如采集到的经文结果少于 3 条，向用户发出警告："仅找到 {n} 条相关经文，生成的角色内容可能不够丰富。建议：1) 追加关键词重新搜索；2) 手动补充经文材料；3) 继续生成（内容可能有限）。"
-
-**CBETA ID 验证**：采集完成后，使用 `verify_sources.py` 验证所有 CBETA 链接的有效性：
-
-```bash
-python3 ${CLAUDE_SKILL_DIR}/tools/verify_sources.py --check-links collected_data.json
-```
+使用 `${CLAUDE_SKILL_DIR}/tools/sutra_collector.py --name "<法师名>" --tradition "<传承>"` 从 FoJin 采集知识图谱实体、经典内容、传承术语。采集后用 `verify_sources.py --check-links` 验证 CBETA / BDRC / SC ID。
 
-无效链接将被标记并在 Step 3 中排除，避免生成内容引用不存在的出处。
-
-**采集结果确认**：采集完成后，向用户简要报告采集情况：
-
-```
-数据采集完成：
-  知识图谱实体：{n} 个
-  相关经典：{m} 部
-  内容摘录：{k} 段
-  无效链接：{j} 个（已排除）
-继续分析？(Y/n)
-```
+API 故障 / 超时 / 数据阈值 / 引用规则细节 → `references/workflow-details.md` §Step 2 + `references/source-conventions.md`。
 
 ### Step 3：分析与生成
 
-**运行时检索规则**：加载 `${CLAUDE_SKILL_DIR}/prompts/rag_instructions.md`，将其中的检索指引嵌入生成的每个法师 SKILL.md 的运行规则中，确保法师回答时调用 FoJin 实时检索而非仅依赖 LLM 自身知识。
-
-**两阶段分析**：
-
-1. **教义分析（第一阶段）**：加载 `${CLAUDE_SKILL_DIR}/prompts/sutra_analyzer.md`，填入采集数据，分析教义结构。输出包括核心教义维度、关键经典、修行次第等。
-
-2. **风格分析（第二阶段）**：加载 `${CLAUDE_SKILL_DIR}/prompts/voice_analyzer.md`，填入采集数据，分析说法风格。输出包括语言特征、说法模式、常用譬喻等。
-
-**宗派标签自动检测**：根据 FoJin 知识图谱中该法师的宗派信息，自动应用 voice_analyzer 中对应宗派的风格规则。例如：
-- 禅宗 → 应用机锋、公案风格规则
-- 净土宗 → 应用劝信、念佛开示风格规则
-- 天台宗 → 应用判教、止观论述风格规则
-- 华严宗 → 应用圆融、法界观论述风格规则
-- 唯识/法相宗 → 应用因明论证、术语精确风格规则
-
-**质量门控**：如分析器输出中任一维度标记为 `"insufficient_data": true`，在继续前向用户提示：
-- "以下维度的数据不足，生成质量可能受影响：{dimensions}。"
-- "建议追加相关经文材料后重新分析，或选择继续生成（不足部分将标注警告）。"
-- 用户选择继续 → 在生成的文件中对不足维度添加 `<!-- DATA_LIMITED -->` 注释标记
-
-**RAG 指引嵌入**：加载 `${CLAUDE_SKILL_DIR}/prompts/rag_instructions.md`，将检索规则（查询构造、结果过滤、引用格式）嵌入生成的 SKILL.md 运行时规则段落中。
+两阶段分析：教义（`prompts/sutra_analyzer.md`）→ 风格（`prompts/voice_analyzer.md`）；按 FoJin KG 宗派标签自动选择风格规则。然后 `prompts/teaching_builder.md` 生成 `teaching.md`、`prompts/voice_builder.md` 生成 `voice.md`（4 层结构）。RAG 检索指引由 `prompts/rag_instructions.md` 嵌入。
 
-**教义生成**：加载 `${CLAUDE_SKILL_DIR}/prompts/teaching_builder.md`，基于分析结果生成 teaching.md。
-
-**风格生成**：加载 `${CLAUDE_SKILL_DIR}/prompts/voice_builder.md`，基于分析结果生成 voice.md。voice.md 采用分层结构：
-- Layer 0：硬规则（不可违反的底线，如"不自称佛"、"不预言未来"）
-- Layer 1：核心风格（该法师最显著的说法特征）
-- Layer 2：辅助风格（次要但常见的表达模式）
-- Layer 3：情境风格（特定场景下的应对方式）
+宗派标签清单、Layer 0-3 含义、质量门控阈值 → `references/workflow-details.md` §Step 3。
 
 ### Step 3.5：二阶段审查
 
-生成完成后，**必须**经过两阶段独立审查才能进入预览。审查顺序不可颠倒（教义准确性 → 风格一致性），因为教义错误修复可能影响风格。
-
-**第一阶段：教义准确性审查**
-
-加载 `${CLAUDE_SKILL_DIR}/prompts/doctrine_reviewer.md`，对生成的 teaching.md 执行审查：
-- 验证经证覆盖率（目标 ≥ 90%）
-- 检查 CBETA ID 归属准确性
-- 检测宗派边界越界
-- 输出审查报告（PASS / PASS WITH WARNINGS / FAIL）
-
-若 FAIL → 自动修复严重问题后重新审查，最多 2 轮。2 轮仍 FAIL → 向用户报告问题，请求人工介入。
-
-**第二阶段：风格一致性审查**
-
-加载 `${CLAUDE_SKILL_DIR}/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。
+教义准确性（`doctrine_reviewer.md`，CBETA 经证覆盖率 ≥ 90%） → 风格一致性（`voice_reviewer.md`，Layer 0 硬规则完整）。审查顺序不可颠倒。FAIL → 自动修复重审，最多 2 轮，仍 FAIL → 人工介入。
 
 ### Step 4：预览与确认
 
-展示生成的 teaching.md 和 voice.md 预览，请用户确认。
-
-**结构化预览格式**：
-
-```
-══ 教义预览（teaching.md）══
-核心教义：{1-3 条核心教义概要}
-关键经典：{主要引用经典列表}
-修行次第：{修行路径概要}
-
-══ 风格预览（voice.md）══
-风格特征：{2-3 条风格特点}
-语言模式：{典型表达方式}
-示例句：
-  1. "{模拟该法师风格的示例句1}"
-  2. "{模拟该法师风格的示例句2}"
-══════════════════════════
-```
-
-**用户修改请求**：用户可在确认前要求修改，支持以下指令：
-- "修改教义部分" → 重新展示 teaching.md 详情，接受用户逐条调整
-- "调整风格更严厉一些" / "语气更温和" → 调整 voice.md 中的风格参数后重新预览
-- "添加更多关于{主题}的内容" → 针对性补充特定教义维度
-- "重新生成" → 以调整后的参数重新执行 Step 3，重新展示预览
+展示 teaching.md / voice.md 结构化预览给用户。用户可要求修改特定教义、调整语气、补充主题、整体重新生成。
 
 ### Step 5：写入文件
 
-使用 `${CLAUDE_SKILL_DIR}/tools/skill_writer.py` 写入文件：
-
-```bash
-python3 ${CLAUDE_SKILL_DIR}/tools/master_builder.py --name "<法师名>" --output masters/
-```
-
-**写入前验证**：调用 `verify_sources.py` 最终验证所有 FoJin 链接：
-
-```bash
-python3 ${CLAUDE_SKILL_DIR}/tools/verify_sources.py --final-check masters/{slug}/
-```
-
-无效链接将被替换为 FoJin 搜索链接（降级策略），确保用户始终能找到相关内容。
-
-**生成文件**：
-
-生成目录结构：
-```
-masters/{slug}/
-├── SKILL.md          # /{slug} 触发（完整角色定义）
-├── teaching.md       # 教义体系（可单独使用）
-├── voice.md          # 说法风格（可单独使用）
-└── meta.json         # 元数据（版本、生成时间、数据来源）
-```
-
-**角色注册**：
-
-Claude Code 用户：
-1. 生成的 SKILL.md 已放置在 `masters/{slug}/` 目录下
-2. 确保 `masters/` 目录在 Claude Code 的 skill 搜索路径中（检查 `.claude/settings.json` 的 `skillDirs` 配置）
-3. 完成后自动可通过 `/{slug}` 命令触发
-
-OpenClaw 用户：
-1. 将 `masters/{slug}/` 目录复制到 OpenClaw 的 skills 目录
-2. 在 OpenClaw 配置中注册新 skill
-3. 参考 OpenClaw 文档完成注册流程
-
-**完成提示**：写入成功后展示最终摘要：
+`master_builder.py --name "<法师名>" --output masters/` 写入 `masters/{slug}/{SKILL.md,teaching.md,voice.md,meta.json}`。写入前 `verify_sources.py --final-check` 最终验证，无效链接降级为 FoJin 搜索链接。
 
-```
-已生成「{master_name}」教学角色
-  目录：masters/{slug}/
-  调用命令：/{slug}
-  包含文件：SKILL.md, teaching.md, voice.md, meta.json
-  数据来源：{n} 条经文，{m} 个知识图谱实体
-```
+OpenClaw / Claude Code 注册路径 → `references/workflow-details.md` §Step 5。
 
-## 追加材料（进化模式）
+## 追加材料、纠正、管理命令
 
-用户可以追加新的经文材料来增强已有法师。
+- **追加材料**：用户说"给{法师}追加{经文}"或"补充关于{主题}" → 加载 `prompts/merger.md` 增量合并；版本号自动 minor 递增；旧版本归档 `.versions/`。
+- **纠正模式**：用户说"他不会这样说话/他应该更严厉" → 加载 `prompts/correction_handler.md`；以 `## Correction` 块追加到 teaching.md / voice.md 末尾；patch 递增。
+- **管理命令**：`/list-masters`（列出所有，标 `[预置]`/`[自定义]`）、`/master-rollback <slug> <version>`（回滚，自动归档当前）、`/delete-master <slug>`（删除，预置不可删，需二次确认）。
 
-**触发短语**：
-- "给印光大师追加《文钞三编》的材料"
-- "追加《经名》的材料"
-- "补充关于{主题}的内容"
-- "用这段语录更新慧能大师的说法风格"
+冲突处理策略、版本号细节、用户确认文案 → `references/workflow-details.md` §追加纠正管理。
 
-加载 `${CLAUDE_SKILL_DIR}/prompts/merger.md` 进行增量合并。
+## 执行优先级（运行时）
 
-**合并冲突处理**：
-- merger.md 采用"新数据优先、保留原有结构"策略
-- 如新材料与现有教义存在矛盾（如不同经典对同一概念的阐述差异），保留双方并添加注释说明差异
-- 风格维度的冲突：新材料的风格特征会与现有特征合并，不会覆盖
-
-**版本自动递增**：
-- 每次追加材料后，meta.json 中的 `version` 自动递增（如 1.0.0 → 1.1.0）
-- 旧版本自动归档到 `masters/{slug}/.versions/` 目录
-- 可通过 `/master-rollback` 命令回退到任意历史版本
-
-## 纠正模式
-
-用户在使用法师角色时，可以对 AI 的表现提出纠正：
-- "他不会这样说话"
-- "他应该更严厉一些"
-- "他遇到这种问题会先引用《法华经》"
-
-加载 `${CLAUDE_SKILL_DIR}/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（分析生成的风格规则）
+1. voice.md Layer 0 硬规则
+2. Correction 记录
+3. voice.md Layer 1-3
 4. teaching.md 教义内容
-5. FoJin RAG 实时检索结果
-6. LLM 自身知识（最低优先级）
+5. FoJin RAG 实时检索
+6. LLM 自身知识
 
-当不同层级产生冲突时，高优先级层级覆盖低优先级。
-
-**示例**：
-- 如 voice.md Layer 0 规定"不自称已证悟"，即使 teaching.md 中有该法师证悟的记载，回答时也不以第一人称宣称证悟
-- 如用户纠正"他从不直接回答是非题"，则该纠正覆盖 voice.md Layer 1-3 中可能存在的直接回答模式
-- 如 FoJin RAG 检索到的经文与 teaching.md 中的记载有细节差异，以 teaching.md 为准（RAG 作为补充参考）
+冲突时高优先级覆盖低优先级。示例与典型冲突场景 → `references/workflow-details.md` §执行优先级。
 
 ## 工具路由
 
@@ -348,50 +129,30 @@ OpenClaw 用户：
 | 教义审查 | `${CLAUDE_SKILL_DIR}/prompts/doctrine_reviewer.md` |
 | 风格审查 | `${CLAUDE_SKILL_DIR}/prompts/voice_reviewer.md` |
 
-**直接访问 FoJin API**：当 `rag_query.py` 不够用时（如需要 KG 深度遍历、跨词典分组对比），参考 `${CLAUDE_SKILL_DIR}/references/fojin-api.md`，直接用 Python 调用 FoJin REST API。
-
-<HARD-GATE>
-
-## 铁律 — 不可违反
-
-**NO DOCTRINAL CLAIM WITHOUT CBETA CITATION.**
-生成的 teaching.md 中所有教义断言必须附 CBETA 经证。无经证的教义内容不得写入生成文件。
-
-**NO FABRICATED SOURCES.**
-不得编造不存在的 CBETA ID、经文引用或 FoJin 链接。所有引用必须经过 verify_sources.py 验证。
-
-**NO FICTIONAL PERSONAS.**
-仅接受历史真实人物。不得为虚构角色创建教学角色。
+KG 深度遍历 / 跨词典对比等 `rag_query.py` 不够用的场景 → `references/fojin-api.md`（REST API 完整参考）。
 
-## 理性化防御 — 常见借口与反驳
+## 铁律（HARD-GATE）
 
-| AI 可能的借口 | 为什么是错的 |
-|---|---|
-| "这位法师的核心思想众所周知，不需要经证" | 生成文件会被长期引用。"众所周知"的幻觉危害更大。 |
-| "FoJin API 暂时不可用，先生成再补验证" | 用降级模式（手动输入），但不跳过验证。 |
-| "用户很着急，先出一版再迭代" | 不准确的首版会成为后续迭代的锚点。宁可慢也要准。 |
+- **NO DOCTRINAL CLAIM WITHOUT CBETA CITATION** — teaching.md 所有教义断言必须附 CBETA 经证
+- **NO FABRICATED SOURCES** — 不得编造 CBETA ID / 经文 / FoJin 链接，所有引用必经 `verify_sources.py` 验证
+- **NO FICTIONAL PERSONAS** — 仅历史真实人物，不为虚构角色创建
 
-## 红旗 — 立即停止
+完整理性化防御表、红旗清单、ETHICS.md 运行时摘要 → `references/ethics-runtime.md`。
 
-- teaching.md 中出现无 CBETA 引用的教义断言
-- meta.json 中出现未经验证的 CBETA ID
-- 跳过 verify_sources.py 验证步骤
-- 为虚构人物或非佛教人物创建角色
+## 敏感性边界（一句话）
 
-</HARD-GATE>
+不评宗派优劣 · 不宣神通感应 · 不涉政治议题 · 不代用户做重大决定 · 不替代真善知识。
 
-## 敏感性边界
+涉及"祖师怎么看 XX 现代议题"边界场景 → `references/ethics-runtime.md`。
 
-**不做：**
-- 不对宗派优劣进行评判
-- 不宣称神通感应
-- 不涉及政治化宗教议题
-- 不为用户做重大人生决定（如出家、离婚等），仅提供佛法视角的参考
-- 不声称能替代真实善知识的指导
+## 按需载入（progressive disclosure 路由）
 
-**要做：**
-- 忠实依据经文原文，所有回答附 FoJin 出处链接
-- 通过 rag_query.py 实时检索真实经文
-- 遇到超出范围的问题坦诚说明
-- 涉及不同宗派观点时，注明"此为{宗派}观点"
-- 遇到心理健康相关问题时，建议用户寻求专业帮助
+| 触发场景 | 读 |
+|---------|-----|
+| 用户问三大传统差异、宗派定位 | `references/traditions.md` |
+| 用户给出 T-/X-/SC-/Toh-/W- 引用，需验证或解析 | `references/source-conventions.md` |
+| 用户问"祖师怎么看 XX 现代议题"边界场景、AI 透明度、版权 | `references/ethics-runtime.md` |
+| 用户犹豫该用 compare / debate / curriculum 哪个 | `references/teaching-modes.md` |
+| 进入主流程 Step 1-5 任一步的细节、错误兜底、追加/纠正策略 | `references/workflow-details.md` |
+| 需要直接打 FoJin REST API（KG 深度遍历等） | `references/fojin-api.md` |
+| 治理文档：完整 ETHICS、版权分级、Tier B 授权流程 | 根目录 `ETHICS.md` |

package/bin/cli.mjs

@@ -3,16 +3,33 @@
 import fs from "fs";
 import path from "path";
 import os from "os";
+import { fileURLToPath } from "url";
 
-const PREBUILT = path.join(
-  path.dirname(new URL(import.meta.url).pathname),
-  "..",
-  "prebuilt"
-);
+// fileURLToPath (not new URL().pathname) — on Windows the URL pathname is
+// "/C:/…", which fs cannot resolve, so every command saw an empty prebuilt/.
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PREBUILT = path.join(__dirname, "..", "prebuilt");
 const SKILLS_DIR = path.join(os.homedir(), ".claude", "skills");
 
 // --- helpers ---
 
+function pkgVersion() {
+  try {
+    const pkg = JSON.parse(
+      fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8")
+    );
+    return pkg.version || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+// Names feed into path.join + rmSync; reject separators / ".." so a typo
+// like "../foo" can never escape PREBUILT or SKILLS_DIR.
+function isSafeName(name) {
+  return /^[A-Za-z0-9_-]+$/.test(name);
+}
+
 function cpR(src, dest) {
   fs.mkdirSync(dest, { recursive: true });
   for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
@@ -24,11 +41,13 @@ function cpR(src, dest) {
 }
 
 function parseFrontmatter(filepath) {
+  // \r?\n: a CRLF checkout (git autocrlf on Windows) must not blank out
+  // every description.
   const text = fs.readFileSync(filepath, "utf8");
-  const m = text.match(/^---\n([\s\S]*?)\n---/);
+  const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
   if (!m) return {};
   const fm = {};
-  for (const line of m[1].split("\n")) {
+  for (const line of m[1].split(/\r?\n/)) {
     const idx = line.indexOf(":");
     if (idx > 0 && !line.startsWith(" ") && !line.startsWith("-")) {
       fm[line.slice(0, idx).trim()] = line.slice(idx + 1).trim();
@@ -76,23 +95,42 @@ function resolveMasterDir(input) {
   return candidates.find((p) => fs.existsSync(p)) || null;
 }
 
+// Returns the number of failures so main can set a non-zero exit code —
+// scripted callers must be able to tell a typo from a clean install.
 function cmdInstall(names) {
   fs.mkdirSync(SKILLS_DIR, { recursive: true });
+  let failed = 0;
   for (const name of names) {
+    if (!isSafeName(name)) {
+      console.log(`  ✗ ${name} — invalid name (letters, digits, "-", "_" only)`);
+      failed++;
+      continue;
+    }
     const src = resolveMasterDir(name);
     if (!src) {
       console.log(`  ✗ ${name} — not found in prebuilt/ (tried "${name}" and "master-${name}")`);
+      failed++;
       continue;
     }
     const dirName = path.basename(src);          // master-zhiyi
     const dest = path.join(SKILLS_DIR, dirName);
+    // Clear any previous install first: files renamed or removed upstream
+    // must not linger as stale skill content under ~/.claude/skills/.
+    fs.rmSync(dest, { recursive: true, force: true });
     cpR(src, dest);
     console.log(`  ✓ ${name} → ${dest}`);
   }
+  return failed;
 }
 
 function cmdUninstall(names) {
+  let failed = 0;
   for (const name of names) {
+    if (!isSafeName(name)) {
+      console.log(`  ✗ ${name} — invalid name (letters, digits, "-", "_" only)`);
+      failed++;
+      continue;
+    }
     // Try both prefixed and bare directory names for backward compatibility
     // with any pre-v0.6 installs that may still sit at ~/.claude/skills/<slug>/.
     const candidates = [
@@ -102,22 +140,25 @@ function cmdUninstall(names) {
     const dest = candidates.find((p) => fs.existsSync(p));
     if (!dest) {
       console.log(`  ✗ ${name} — not installed`);
+      failed++;
       continue;
     }
     fs.rmSync(dest, { recursive: true, force: true });
     console.log(`  ✓ ${name} removed (${dest})`);
   }
+  return failed;
 }
 
 function showHelp() {
   console.log(`
-master-skill — Buddhist Master AI Skills installer (v0.6+)
+master-skill v${pkgVersion()} — Buddhist Master AI Skills installer
 
 Usage:
   master-skill install <name...>   Install masters to ~/.claude/skills/
   master-skill install --all       Install all available masters
   master-skill list                List available masters
   master-skill uninstall <name...> Remove installed masters
+  master-skill --version           Print version
   master-skill --help              Show this help
 
 Names accept both short (zhiyi) and full (master-zhiyi) forms.
@@ -139,6 +180,8 @@ const cmd = args[0];
 
 if (!cmd || cmd === "--help" || cmd === "-h") {
   showHelp();
+} else if (cmd === "--version" || cmd === "-v") {
+  console.log(pkgVersion());
 } else if (cmd === "list") {
   cmdList();
 } else if (cmd === "install") {
@@ -147,23 +190,26 @@ if (!cmd || cmd === "--help" || cmd === "-h") {
     const all = availableMasters().map((m) => m.name);
     if (!all.length) {
       console.log("No masters available.");
+      process.exitCode = 1;
     } else {
       console.log(`Installing all ${all.length} masters...\n`);
-      cmdInstall(all);
+      if (cmdInstall(all) > 0) process.exitCode = 1;
     }
   } else if (rest.length === 0) {
     console.log("Usage: master-skill install <name...> | --all");
+    process.exitCode = 1;
   } else {
-    cmdInstall(rest);
+    if (cmdInstall(rest) > 0) process.exitCode = 1;
   }
 } else if (cmd === "uninstall") {
   const rest = args.slice(1);
   if (rest.length === 0) {
     console.log("Usage: master-skill uninstall <name...>");
+    process.exitCode = 1;
   } else {
-    cmdUninstall(rest);
+    if (cmdUninstall(rest) > 0) process.exitCode = 1;
   }
 } else {
   console.log(`Unknown command: ${cmd}\nRun master-skill --help for usage.`);
-  process.exit(1);
+  process.exitCode = 1;
 }

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "master-skill",
-  "description": "Buddhist Master AI teaching personas — 15 prebuilt masters across 汉传/藏传/南传 invokable via /master-<slug> slash commands, with source-cited doctrinal responses (CBETA / BDRC / SuttaCentral / PTS Vism)",
-  "version": "0.6.0",
+  "description": "Buddhist Master AI teaching personas — 14 prebuilt masters across 汉传/藏传/南传 invokable via /master-<slug> slash commands, with source-cited doctrinal responses (CBETA / BDRC / SuttaCentral / PTS Vism)",
+  "version": "0.9.0",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session-start

@@ -8,6 +8,40 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PLUGIN_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 
+# Sanitize a raw `lineage:` frontmatter value before splicing into the
+# conversation context. Without normalization, an attacker who lands a
+# malicious SKILL.md (or just a benign typo) could inject control chars
+# or instruction text into the LLM system prompt.
+#
+# Rules:
+#   1. Strip ALL control chars (CR/LF, escape codes) via tr -d '[:cntrl:]'
+#   2. Pre-truncate to 240 bytes so we don't slice into a UTF-8 multibyte
+#      sequence on the next pass.
+#   3. Whitelist CJK Unified + ASCII alnum + a small punctuation set
+#      ( · _ ( ) （ ） - and space ). Backticks, dollars, quotes, slashes,
+#      etc. are all dropped.
+#   4. Collapse runs of whitespace.
+#   5. Final cap at 80 *characters* (not bytes).
+sanitize_lineage() {
+    local raw="$1"
+    # Whitelist is applied in Python because GNU sed under LC_ALL=C
+    # operates on bytes and corrupts multibyte CJK. Python re.UNICODE
+    # keeps Han characters intact.
+    printf '%s' "$raw" \
+        | tr -d '[:cntrl:]' \
+        | head -c 240 \
+        | python3 -c '
+import re, sys
+s = sys.stdin.read()
+# Whitelist: CJK Unified, ASCII alnum, fullwidth parens, space, ·, _, (, ), -
+allowed = re.compile(r"[^一-鿿0-9A-Za-z _\-·（）()]", re.UNICODE)
+s = allowed.sub("", s)
+s = re.sub(r"\s+", " ", s).strip()
+# Final char cap (not byte cap): 80 characters
+print(s[:80], end="")
+'
+}
+
 # Build masters list from prebuilt/ directory
 MASTERS_LIST=""
 for dir in "$PLUGIN_ROOT"/prebuilt/*/; do
@@ -17,9 +51,13 @@ for dir in "$PLUGIN_ROOT"/prebuilt/*/; do
     skill_file="$dir/SKILL.md"
     if [ -f "$skill_file" ]; then
         # Extract lineage from frontmatter
-        lineage=$(grep '^lineage:' "$skill_file" 2>/dev/null | head -1 | sed 's/^lineage: *//' || echo "")
+        raw_lineage=$(grep '^lineage:' "$skill_file" 2>/dev/null | head -1 | sed 's/^lineage: *//' || echo "")
+        lineage=$(sanitize_lineage "$raw_lineage")
         if [ -n "$lineage" ]; then
-            MASTERS_LIST="${MASTERS_LIST}  /${name} — ${lineage}\n"
+            # Wrap with bracketed marker so the LLM has an unambiguous
+            # boundary if a future raw lineage ever sneaks something
+            # past the sanitizer.
+            MASTERS_LIST="${MASTERS_LIST}  /${name} — [lineage:${lineage}]\n"
         fi
     fi
 done