Zen Koan Daily | 每日禅宗公案

每日禅宗公案配水墨画和语音讲解

每日禅宗公案配水墨画和语音讲解

🎯 What This Skill Does | 功能说明

每天提供完整的禅宗公案体验：

1. 📜 Koan Lecture | 公案讲解

   • 原文（文言文 + 英文）
   • 历史背景
   • 深度解读
   • 现代生活启示

2. 🎨 Zen Ink Wash Art | 禅宗水墨画

   • AI 生成的中国水墨画
   • 极简构图，大量留白（留白）
   • 画面氛围契合公案主题

3. 🔊 Audio Narration | 语音讲解

   • TTS 音频（Edge TTS，免费）
   • 中文：沉静、内省风格的语音
   • 英文：叙述性、冥想风格的语音

🤖 Agent Instructions | AI助手指令

Trigger Commands | 触发命令

用户可输入以下任意一条：

• /koan 或 /公案 → 生成今日公案
• /koan next → 按顺序获取下一则公案
• /koan random → 随机生成一则公案
• /koan 1 → 按 ID 获取指定公案
• zen koan、禅宗公案、tell me a koan → 对话式触发

Workflow | 工作流程

动态生成模式（动态生成模式）

本技能采用大语言模型驱动的动态生成，而非固定数据库：

• 仅存储 2 则参考公案作为示例
• 其余所有公案均由 LLM 实时生成
• 参考典籍来源：《无门关》《碧岩录》《从容录》《景德传灯录》《五灯会元》

触发后执行流程如下：

步骤 1：生成公案内容（LLM生成公案）

LLM 将执行以下操作：

1. 从经典禅宗文献中选取一则恰当的公案

2. 生成完整内容：

   • 原文（文言文 + 英文）
   • 历史背景
   • 深度解读
   • 现代生活启示
   • 用于图像生成的视觉元素

3. 可选：使用已存参考公案（ID 1–2）进行测试

4. 可选：调用 web_search 查找当代禅宗教学资料

步骤 2：格式化讲解文本

对于已存公案（测试用途）：

python3 ~/clawd/skills/zen-koan-daily/scripts/generate_koan.py --id 1 --lang zh

对于 LLM 生成的公案：

• LLM 直接以标准格式生成完整讲解文本
• 结构与参考公案保持一致：
  • 标题 + 所属典籍
  • 原文（📜）
  • 背景（📖）
  • 解读（💡）
  • 现代启示（🌏）
  • 可选：个人启示（🧘 为你而讲）

可选参数：

• --lang zh → 生成中文讲解
• --lang en → 生成英文讲解
• --personal "..." → 基于近期上下文添加个性化启示

步骤 3：获取公案 JSON 数据（用于图像生成）

选项 A — 使用已存公案：

python3 ~/clawd/skills/zen-koan-daily/scripts/generate_koan.py --id 1 --format json

选项 B — LLM 生成公案元数据：
LLM 输出包含视觉元素的 JSON：

{
  "id": 3,
  "title_zh": "俱胝竖指",
  "visual_elements": ["finger", "mountain", "clouds"],
  "mood": "sudden, shocking, direct"
}

步骤 4：生成禅宗水墨画

# 获取提示词命令
python3 ~/clawd/skills/zen-koan-daily/scripts/generate_image.py 
  --koan-json '{"id": 1, "visual_elements": ["dog", "bamboo"], "mood": "serene"}'

# 然后通过 exec 工具运行所显示的 uv 命令

步骤 5：生成 TTS 音频

# 将讲解文本保存至临时文件
echo "" > /tmp/koan.txt

~/clawd/skills/zen-koan-daily/scripts/generate_tts.sh 
  --text-file /tmp/koan.txt 
  --lang zh 
  --output ~/.openclaw/media/outbound/zen-koan/koan-$(date +%Y%m%d).mp3

步骤 6：发送给用户

• 图像（PNG）
• 音频（MP3）
• 讲解文本（已格式化）

📚 Koan Database | 公案数据库

生成模式： 动态生成

已存参考公案： 2 则

• 赵州狗子（Zhaozhou's Dog）
• 平常心是道（Ordinary Mind is the Way）

其他公案： 由 LLM 动态生成，来源包括：

• The Gateless Gate（《无门关》）— 48 则
• Blue Cliff Record（《碧岩录》）— 100 则
• Book of Serenity（《从容录》）— 100 则
• Transmission of the Lamp（《景德传灯录》）
• Five Lamps Meeting at the Source（《五灯会元》）

为何采用动态生成？

• ✅ LLM 生成质量优异（经测试验证）
• ✅ 无需手动维护 50–100 则公案
• ✅ 可无限扩展，源自经典文献
• ✅ 每次呈现全新解读
• ✅ 可选启用 web_search 获取当代教学资源

质量保障：

• LLM 经真实禅宗文献训练
• 交叉比对多部经典典籍
• 严格维持统一输出格式
• 经测试验证（参见参考公案）

1. 赵州狗子（Zhaozhou's Dog）— 第一重关
2. 平常心是道（Ordinary Mind is the Way）— 无所求

即将上线：

• 德山棒（Deshan's Stick）
• 临济喝（Linji's Shout）
• 庭前柏树子（The Cypress Tree）
• 青原三境（Three Stages）
• ……以及 42+ 则其他经典公案

存储路径： ~/clawd/skills/zen-koan-daily/references/koans.json

🎨 Image Style | 图片风格

禅宗水墨画美学：

Chinese zen ink wash painting (禅宗水墨画),
minimalist composition, vast empty space (留白),
subtle gradations of black ink on rice paper,
sparse brushstrokes, meditative atmosphere,
traditional Chinese calligraphy style,
serene and contemplative mood

按公案主题匹配视觉元素：

• 狗/佛性类公案 → 狗的剪影、竹子、月亮
• 空/虚类公案 → 广袤天空、素雅茶盏
• 自然类公案 → 云雾缭绕的山峦、松树、梅花

🔊 TTS Configuration | 语音配置

语音模型：

• 中文：zh-CN-XiaoxiaoNeural

  • 温暖、沉静，适合内省类内容
  • 温暖、平静、适合讲解内容

• English：en-US-AriaNeural

  • Calm, narrative, meditative style
  • 平静、叙述风格、冥想氛围

音频格式：

• MP3（压缩格式）
• 保存路径：~/.openclaw/media/outbound/zen-koan/

📖 Output Example | 输出示例

文本（中文）：

🎋 每日禅宗公案 | Daily Zen Koan

━━━━━━━━━━━━━━━━━━━━━━━━

**赵州狗子**
*无门关 第1则*

━━━━━━━━━━━━━━━━━━━━━━━━

📜 **原文**

僧问赵州：「狗子还有佛性也无？」州云：「无。」

━━━━━━━━━━━━━━━━━━━━━━━━

📖 **背景**

赵州从谂禅师（778-897）是唐代著名禅师...

━━━━━━━━━━━━━━━━━━━━━━━━

💡 **白话解读**

赵州答「无」，并非否定佛性...

━━━━━━━━━━━━━━━━━━━━━━━━

🌏 **现代启示**

现代人陷入「有用/无用」「成功/失败」的二元思维...

生成文件：

• koan-1-20260405-090000.png（禅宗水墨画）
• koan-1-20260405-090000.mp3（TTS 语音讲解）
• 讲解文本（通过消息发送）

🔄 Progress Tracking | 进度追踪

自动追踪：

• references/progress.json 记录已推送的公案
• 按顺序轮播全部公案，结束后循环
• 持久化记录推送历史

查看进度：

cat ~/clawd/skills/zen-koan-daily/references/progress.json

🛠️ Installation | 安装

依赖要求：

• Python 3.10+
• Edge TTS：pipx install edge-tts
• Gemini API key（用于图像生成）：export GEMINI_API_KEY="..."

安装方式：

clawhub install zen-koan-daily

或从 GitHub 克隆：

git clone https://github.com/yumyumtum/yumskills.git
cd yumskills/zen-koan-daily

📅 Cron Scheduling | 定时任务

每日上午 6:00 自动推送：

在 OpenClaw 中创建定时任务：

{
  "name": "Daily Zen Koan",
  "schedule": {
    "kind": "cron",
    "expr": "0 6 * * *",
    "tz": "America/Los_Angeles"
  },
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "/koan next"
  }
}

🏷️ Tags & Metadata | 标签与元数据

难度等级：

• beginner — 基础公案（赵州狗子、平常心）
• intermediate — 深入修习（德山棒、临济喝）
• advanced — 微妙证悟（庭前柏树子、青原三境）

宗派归属：

• rinzai — 顿悟传统
• soto — 渐修传统
• both — 普适性教法

🔗 Related Skills | 相关技能

• Continuance — 每日灵性指引
• Nano Banana Pro — AI 图像生成
• Azure TTS — 替代语音合成方案

📜 License | 许可证

GPL-3.0-or-later

开源，可自由使用与修改。

"When you meet a swordsman on the road, draw your sword. Don't recite poetry to one who is not a poet."

"路逢剑客须呈剑，不是诗人莫献诗。"

— Zen saying | 禅宗古语