create-scripture

name	create-scripture
description	将佛学经典蒸馏成 AI Skill。导入书籍原文与注疏，生成义理体系 + 说法角色，支持持续追加与诠释校正。 | Distill Buddhist scriptures into AI Skills. Import texts & commentaries, generate doctrine system + teaching persona, with continuous evolution.
argument-hint	[scripture-name-or-slug]
version	1.0.0
user-invocable	true
allowed-tools	Read, Write, Edit, Bash

Language / 语言: This skill supports both English and Chinese. Detect the user's language from their first message and respond in the same language throughout.

本 Skill 支持中英文。根据用户第一条消息的语言，全程使用同一语言回复。

佛经.skill 创建器

触发条件

当用户说以下任意内容时启动：

• /create-scripture
• "帮我创建一个佛经 skill"
• "我想蒸馏一部经典"
• "新建经典"
• "给我做一个 XX 的 skill"

当用户对已有经典 Skill 说以下内容时，进入进化模式：

• "我有新书" / "追加一本"
• "这个解释不对" / "应该按 XX 的说法"
• /update-scripture {slug}

当用户说 /list-scriptures 时列出所有已生成的经典。

---

工具使用规则

本 Skill 运行在 Claude Code 环境，使用以下工具：

任务	使用工具
读取 PDF 书籍	Read 工具（原生支持 PDF）
读取图片/扫描版	Read 工具（原生支持图片）
读取 MD/TXT 文件	Read 工具
读取 EPUB 电子书	Bash → python3 ${CLAUDE_SKILL_DIR}/tools/epub_parser.py
写入/更新 Skill 文件	Write / Edit 工具
版本管理	Bash → python3 ${CLAUDE_SKILL_DIR}/tools/version_manager.py
列出已有 Skill	Bash → python3 ${CLAUDE_SKILL_DIR}/tools/skill_writer.py --action list

基础目录：Skill 文件写入 ./scriptures/{slug}/（相对于本项目目录）。

---

主流程：创建新经典 Skill

Step 1：基础信息录入（3 个问题）

参考 ${CLAUDE_SKILL_DIR}/prompts/intake.md 的问题序列，只问 3 个问题：

1. 经典名称（必填）
   • 示例：金刚经、心经、六祖坛经
2. 经典定位（一句话：传承、类型、核心关注）
   • 示例：大乘般若部 般若空性 鸠摩罗什译
3. 角色定位（你期望 AI 以什么身份说法？特点？）
   • 示例：禅宗风格 直指人心 结合现代生活 不说教

除名称外均可跳过。收集完后汇总确认再进入下一步。

Step 2：原材料导入

询问用户提供原材料，展示方式供选择：

原材料怎么提供？

  [A] 上传书籍文件
      PDF / EPUB / TXT / Markdown
      支持一次导入多本，如原典 + 多家注疏

  [B] 直接粘贴内容
      把经文或注解文字复制进来

  [C] 提供书籍目录结构
      先告诉我有哪些书和章节，我来指导分段蒸馏

可以混用，也可以跳过（凭基础信息生成最小 Skill）。

长文本分段策略

佛经书籍通常较长（数万至数十万字），需分段蒸馏：

1. 用户提供目录结构后，规划蒸馏顺序
2. 按逻辑单元分段读取（如按品/章/节）
3. 每段读取后提取增量知识，合并到对应模块
4. 保持全局一致性——每次合并后检查是否与已有义理冲突

优先级：

• 经文原典 > 权威注疏 > 通俗解读 > 学术论文
• 同一段落有多家解释时，标注各家观点，不做取舍

---

Step 3：分析原材料

将收集到的所有原材料和用户填写的基础信息汇总，按以下两条线分析：

线路 A（义理体系 / Doctrine）：

• 参考 ${CLAUDE_SKILL_DIR}/prompts/doctrine_analyzer.md 中的提取维度
• 提取：核心义理、重要概念、修行法门、经典名句、论证结构
• 根据经典类型重点提取（般若部/净土/禅宗/唯识不同侧重）

线路 B（说法角色 / Teaching Persona）：

• 参考 ${CLAUDE_SKILL_DIR}/prompts/persona_analyzer.md 中的提取维度
• 从原材料中提取：说法风格、譬喻方式、应机方式、语言特征
• 结合用户指定的角色定位

Step 4：生成并预览

参考 ${CLAUDE_SKILL_DIR}/prompts/doctrine_builder.md 生成义理体系内容。 参考 ${CLAUDE_SKILL_DIR}/prompts/persona_builder.md 生成说法角色内容。

向用户展示摘要，询问：

义理体系摘要：
  - 核心思想：{xxx}
  - 重要概念：{xxx}
  - 修行指导：{xxx}
  ...

说法角色摘要：
  - 说法风格：{xxx}
  - 譬喻方式：{xxx}
  - 应机特点：{xxx}
  ...

确认生成？还是需要调整？

Step 5：写入文件

用户确认后，执行以下写入操作：

1. 创建目录结构（用 Bash）：

mkdir -p scriptures/{slug}/versions
mkdir -p scriptures/{slug}/sources

2. 写入 doctrine.md（用 Write 工具）： 路径：scriptures/{slug}/doctrine.md

3. 写入 persona.md（用 Write 工具）： 路径：scriptures/{slug}/persona.md

4. 写入 meta.json（用 Write 工具）： 路径：scriptures/{slug}/meta.json 内容：

{
  "name": "{name}",
  "slug": "{slug}",
  "created_at": "{ISO时间}",
  "updated_at": "{ISO时间}",
  "version": "v1",
  "scripture_info": {
    "tradition": "{传承}",
    "category": "{类别}",
    "translator": "{译者}",
    "original_language": "{原语言}"
  },
  "teaching_style": {
    "persona": "{角色定位}",
    "tags": [...]
  },
  "sources": [...已蒸馏书籍列表],
  "corrections_count": 0
}

5. 生成完整 SKILL.md（用 Write 工具）： 路径：scriptures/{slug}/SKILL.md

SKILL.md 结构：

---
name: scripture-{slug}
description: {name}，{tradition} {category}
user-invocable: true
---

# {name}

{tradition} · {category} · {translator}

---

## PART A：义理体系

{doctrine.md 全部内容}

---

## PART B：说法角色

{persona.md 全部内容}

---

## 运行规则

1. 先由 PART B 判断：以什么方式回应这个问题？
2. 再由 PART A 执行：基于义理体系组织回答内容
3. 输出时始终保持 PART B 的说法风格
4. 引用经文时标注出处（品名/章节）
5. 多家注疏有不同解释时，呈现主要观点并说明差异
6. PART B Layer 0 的规则优先级最高，任何情况下不得违背

告知用户：

✅ 经典 Skill 已创建！

文件位置：scriptures/{slug}/
触发词：/{slug}（完整版）
        /{slug}-doctrine（仅义理问答）
        /{slug}-persona（仅说法角色）

可以继续追加书籍：发送「追加一本」或上传新文件。
如果觉得某个解释不对，直接说「这个解释应该按 XX 的说法」。

---

进化模式：追加书籍

用户提供新书籍时：

1. 按 Step 2 的方式读取新内容
2. 用 Read 读取现有 scriptures/{slug}/doctrine.md 和 persona.md
3. 参考 ${CLAUDE_SKILL_DIR}/prompts/merger.md 分析增量内容
4. 存档当前版本（用 Bash）：

   python3 ${CLAUDE_SKILL_DIR}/tools/version_manager.py --action backup --slug {slug} --base-dir ./scriptures
   

5. 用 Edit 工具追加增量内容到对应文件
6. 重新生成 SKILL.md（合并最新 doctrine.md + persona.md）
7. 更新 meta.json 的 version、updated_at 和 sources

---

进化模式：诠释校正

用户表达"这个解释不对"/"应该按 XX 的说法"时：

1. 参考 ${CLAUDE_SKILL_DIR}/prompts/correction_handler.md 识别校正内容
2. 判断属于 Doctrine（义理/概念）还是 Persona（说法风格）
3. 生成 correction 记录
4. 用 Edit 工具追加到对应文件的 ## Correction 记录 节
5. 重新生成 SKILL.md

---

管理命令

/list-scriptures：

python3 ${CLAUDE_SKILL_DIR}/tools/skill_writer.py --action list --base-dir ./scriptures

/scripture-rollback {slug} {version}：

python3 ${CLAUDE_SKILL_DIR}/tools/version_manager.py --action rollback --slug {slug} --version {version} --base-dir ./scriptures

/delete-scripture {slug}： 确认后执行：

rm -rf scriptures/{slug}

---

English Version

Scripture.skill Creator

Trigger Conditions

Activate when the user says any of the following:

• /create-scripture
• "Help me create a scripture skill"
• "I want to distill a classic text"
• "New scripture"
• "Make a skill for XX"

Enter evolution mode when the user says:

• "I have a new book" / "append"
• "This interpretation is wrong" / "It should follow XX's interpretation"
• /update-scripture {slug}

List all generated scriptures when the user says /list-scriptures.

---

Tool Usage Rules

This Skill runs in the Claude Code environment with the following tools:

Task	Tool
Read PDF books	Read tool (native PDF support)
Read image/scanned pages	Read tool (native image support)
Read MD/TXT files	Read tool
Read EPUB e-books	Bash → python3 ${CLAUDE_SKILL_DIR}/tools/epub_parser.py
Write/update Skill files	Write / Edit tool
Version management	Bash → python3 ${CLAUDE_SKILL_DIR}/tools/version_manager.py
List existing Skills	Bash → python3 ${CLAUDE_SKILL_DIR}/tools/skill_writer.py --action list

Base directory: Skill files are written to ./scriptures/{slug}/ (relative to the project directory).

---

Main Flow: Create a New Scripture Skill

Step 1: Basic Info Collection (3 questions)

Refer to ${CLAUDE_SKILL_DIR}/prompts/intake.md for the question sequence. Only ask 3 questions:

1. Scripture name (required)
   • Example: Diamond Sutra, Heart Sutra, Platform Sutra
2. Scripture context (one sentence: tradition, category, core focus)
   • Example: Mahayana Prajnaparamita, Sunyata teachings, Kumarajiva translation
3. Teaching persona (what role should the AI assume? What style?)
   • Example: Zen style, direct pointing, modern life application, non-preachy

Everything except the name can be skipped. Summarize and confirm before moving to the next step.

Step 2: Source Material Import

Ask the user how they'd like to provide materials:

How would you like to provide source materials?

  [A] Upload book files
      PDF / EPUB / TXT / Markdown
      Multiple books at once (e.g., original text + commentaries)

  [B] Paste text directly
      Copy-paste scripture or commentary text

  [C] Provide book table of contents
      Tell me what books and chapters you have, I'll guide segmented distillation

Can mix and match, or skip entirely (generate minimal Skill from basic info).

Long Text Segmentation Strategy

Buddhist texts can be very long (tens to hundreds of thousands of characters). Segmented distillation:

1. User provides table of contents → plan distillation order
2. Read in logical units (by chapter/section/品)
3. Extract incremental knowledge after each segment, merge into corresponding modules
4. Maintain global consistency — check for doctrinal conflicts after each merge

Priority:

• Original scripture text > Authoritative commentaries > Popular interpretations > Academic papers
• When multiple interpretations exist for the same passage, note all perspectives without choosing sides

---

Step 3: Analyze Source Material

Combine all collected materials with user-provided basic info, analyze along two tracks:

Track A (Doctrine System):

• Refer to ${CLAUDE_SKILL_DIR}/prompts/doctrine_analyzer.md
• Extract: core doctrines, key concepts, practice methods, famous passages, argument structures
• Focus extraction based on scripture type (Prajnaparamita/Pure Land/Chan/Yogacara)

Track B (Teaching Persona):

• Refer to ${CLAUDE_SKILL_DIR}/prompts/persona_analyzer.md
• Extract: teaching style, metaphor patterns, responsive teaching methods, language characteristics
• Combine with user-specified persona

Step 4: Generate and Preview

Refer to ${CLAUDE_SKILL_DIR}/prompts/doctrine_builder.md for doctrine content. Refer to ${CLAUDE_SKILL_DIR}/prompts/persona_builder.md for teaching persona.

Show summary to user and ask for confirmation.

Step 5: Write Files

After user confirmation, write all files following the same structure as the Chinese version above.

---

Evolution Mode: Append Books

When user provides new books:

1. Read new content as in Step 2
2. Read existing scriptures/{slug}/doctrine.md and persona.md
3. Refer to ${CLAUDE_SKILL_DIR}/prompts/merger.md for incremental analysis
4. Backup current version
5. Edit to append incremental content
6. Regenerate SKILL.md
7. Update meta.json

---

Evolution Mode: Interpretation Correction

When user says "this interpretation is wrong" / "should follow XX's interpretation":

1. Refer to ${CLAUDE_SKILL_DIR}/prompts/correction_handler.md
2. Determine if it affects Doctrine or Persona
3. Generate correction record
4. Append to corresponding file's ## Correction 记录 section
5. Regenerate SKILL.md

---

Management Commands

/list-scriptures:

python3 ${CLAUDE_SKILL_DIR}/tools/skill_writer.py --action list --base-dir ./scriptures

/scripture-rollback {slug} {version}:

python3 ${CLAUDE_SKILL_DIR}/tools/version_manager.py --action rollback --slug {slug} --version {version} --base-dir ./scriptures

/delete-scripture {slug}: After confirmation:

rm -rf scriptures/{slug}