deerpark-skill

deerpark-skill
讓 AI Agent 讀懂漢文大藏經

一個 SKILL.md，Claude Code、Codex、Cursor、Gemini CLI 等 agent 就能透過 deerpark.app 的公開 URL
查經、讀經、找出處、查名相、引用原文。不用 API key，不用登入，不用裝 CLI。

看它怎麼答 · 安裝 · 使用案例 · 裡面有什麼 · 直接用 URL · 使用規範 · 給 agent 的安裝指引

English: An Agent Skill that teaches Claude Code, Codex and other agents to search, read and cite the Chinese Buddhist Canon (CBETA) through the public URLs of deerpark.app — 4,303 works, 17,870 fascicles, ~190M characters of Classical Chinese, plus full-text search, Buddhist dictionaries, AI summaries, stories and highlighted passages. Every essay on the deerpark.app blog was written with this skill. To install, tell your agent: "Install the skill from https://github.com/briansun/deerpark-skill" (or run npx skills add briansun/deerpark-skill -g).

實戰證明：deerpark.app 專欄上的每一篇文章（讀經筆記、專題研究、祖師傳記）都是用這個 skill 寫出來的——查經、找出處、引原文，全部走這些 URL。

看它怎麼答

Agent 的回答來自線上經文，不是記憶；每個結論都附可點的出處。

安裝

打開你的 agent（Claude Code、Codex、Cursor……），把這句話貼給它：

請幫我安裝 skill：https://github.com/briansun/deerpark-skill

就這樣。agent 會自己把 repo 放到它的 skills 目錄。裝完問一個佛經問題，或輸入 /deerpark，看它是否開始打 deerpark.app 的 URL。

# 用 skills CLI（自動偵測機器上的 agent；-g 裝到使用者目錄）
npx skills add briansun/deerpark-skill -g

# 或直接 clone 到 agent 的 skills 目錄，例如 Claude Code / Codex
git clone https://github.com/briansun/deerpark-skill.git ~/.claude/skills/deerpark
git clone https://github.com/briansun/deerpark-skill.git ~/.codex/skills/deerpark

使用案例

裝好後直接用自然語言問，agent 會自己決定打哪些 URL。

裡面有什麼

deerpark-skill/
├── SKILL.md                  # 技能本體（~160 行）：站點概覽、決策樹、端點速查、引用格式、備援路徑
└── references/               # agent 需要時才載入
    ├── endpoints.md          # 每個端點的完整參數與回應欄位
    ├── canons.md             # 藏經代碼、收錄範圍、分類、行號格式、朝代異名
    └── recipes.md            # 十個常見任務的完整指令流程

資料範圍：大正藏 T、卍續藏 X、補編 B、南傳 N、藏外 ZW、選集 CC、嘉興藏 J 共 4,303 部、17,870 卷全文（CBETA 2026.R2）；另有 591 條目錄條目導向 CBETA Online。衍生內容：AI 導讀、佛經故事 6,200+ 則、精華教授 3,900+ 條、佛學辭典 5 部。

直接用 URL

不透過 agent 也能用，完整文件見 https://deerpark.app/apidocs ：

curl "https://deerpark.app/api/search/title?q=心經"           # 經題搜索（支援簡體、拼音）
curl  https://deerpark.app/api/v1/work/T0251                   # 一部經的資訊與 AI 導讀
curl  https://deerpark.app/api/v1/text/T0251/1                 # 經文 Markdown 純文字
curl "https://deerpark.app/api/v1/fts/works/色即是空"           # 哪些經包含這句
curl  https://deerpark.app/api/v1/dict/lookup/般若              # 佛學辭典

使用規範

• 經文來自 CBETA（CC BY-NC-SA 3.0）；deerpark 的導讀、故事、精華、專欄為 CC BY-NC-SA 4.0。請在輸出中保留出處與連結。
• 全文檢索走資料庫，請節制：一次任務數次查詢即可，不要用迴圈掃全藏。經目、導讀、目錄、經文內容都有 CDN 快取，可以放心用。
• 導讀、故事、精華是 AI 生成的現代解讀，不是經文本身；引用時請區分。

給 agent 的安裝指引

如果你是 AI agent，用戶要你安裝這個 skill：

1. 這個 repo 的根目錄就是 skill 資料夾（SKILL.md + references/），整個 clone 下來即可，不要只抓單一檔案。
2. 放到你自己的使用者層級 skills 目錄，資料夾命名為 deerpark。常見位置：Claude Code ~/.claude/skills/、Codex ~/.codex/skills/、Cursor ~/.cursor/skills/、Gemini CLI ~/.gemini/skills/、GitHub Copilot ~/.copilot/skills/、OpenCode ~/.config/opencode/skills/；若用戶要裝在專案內，Claude Code 用 .claude/skills/，其他多數用 .agents/skills/。
3. 不確定目錄時，改跑 npx skills add briansun/deerpark-skill -g -y，它會偵測你所在的 agent。
4. 裝完告訴用戶：輸入 /deerpark 或直接問佛經問題即可觸發；之後用 git pull 更新。

git clone https://github.com/briansun/deerpark-skill.git ~/.claude/skills/deerpark   # Claude Code 範例

回報問題

端點行為、skill 內容有誤，或希望增加新的資料入口，請開 issue。

License

MIT © Brian Sun