Knowledge Card Generator

Knowledge Card Generator

Generate beautiful knowledge concept cards (知识概念卡片) from any content: book summaries, course notes, meeting insights, or topic overviews.

When to Use

Trigger this skill when the user:

What It Does

1. Extracts 4-5 core concepts from the input (book/notes/topic) 2. Generates a high-quality PNG card (2400px width, 3x DPI) with: - Gradient top bar + title + subtitle - Each concept: icon + title + tag + quote + explanation - Bottom quote block (optional) - Brand footer 3. Sends the image directly to the current chat

Workflow

Step 1: Analyze Input

If user provides raw content (book summary, notes, transcript), extract:

If user provides structured data (JSON), use it directly.

Step 2: Choose Theme

Pick a theme color based on content tone:

Step 3: Generate Card

Run the script:

node scripts/generate.js \
  --title "书名或主题" \
  --subtitle "副标题（可选）" \
  --badge "标签（如：核心概念）" \
  --theme "blue" \
  --concepts '[
    {
      "icon": "💡",
      "color": "#3B82F6",
      "bg": "#DBEAFE",
      "title": "概念名称",
      "tag": "标签",
      "quote": "金句或原文引用",
      "desc": "2-3句解读，用加粗强调关键词"
    },
    ...
  ]' \
  --quote "底部金句（可选）" \
  --quote-author "—— 作者" \
  --brand "心光年觉醒读书会" \
  --vol "Vol.01 · 系列名" \
  --output /tmp/output.png

The script prints the output path on success.

Step 4: Send to User

⚠️ 发图方式按渠道不同，必须分支处理：

#### 飞书渠道（channel=feishu） 直接调飞书 API 上传图片再发送，不要用 message(filePath=...)（会失败）：

# Step 4a: 获取 token
APP_ID="your_feishu_app_id"        # 替换成你的飞书 App ID
APP_SECRET="your_feishu_app_secret"  # 替换成你的飞书 App Secret
TOKEN=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
  -H "Content-Type: application/json" \
  -d "{\"app_id\":\"$APP_ID\",\"app_secret\":\"$APP_SECRET\"}" \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['tenant_access_token'])")
Step 4b: 上传图片，获取 image_key
IMAGE_KEY=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/images" \
  -H "Authorization: Bearer $TOKEN" \
  -F "image_type=message" \
  -F "image=@/path/to/output.png" \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['data']['image_key'])")
Step 4c: 发送图片消息
receive_id 是目标用户的 open_id 或群的 chat_id
receive_id_type: open_id（私聊）或 chat_id（群聊）
curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"receive_id\":\"$RECEIVE_ID\",\"msg_type\":\"image\",\"content\":\"{\\\"image_key\\\":\\\"$IMAGE_KEY\\\"}\"}"

然后用 message 工具发一条文字消息作为说明（可选）。

#### QQ 渠道（channel=qqbot） 使用 qqbot-media skill 的 标签发送图片： 先读取 ~/.openclaw/workspace/skills/qqbot-media/SKILL.md 获取详细用法。

#### 其他渠道（Discord、Telegram、WeChat 等） 使用 message 工具：

message(action=send, filePath=/path/to/output.png, message="简短介绍文字")

Concept Structure Guidelines

Good concept:

{
  "icon": "🧬",
  "color": "#E11D48",
  "bg": "#FFE4E6",
  "title": "专属知识",
  "tag": "不可替代性",
  "quote": "如果可以培训，就可以被AI或他人取代",
  "desc": "专属知识不是课程能教的技能，而是你天赋 × 好奇心 × 热爱的独特组合。别人学你，感觉像在上班；你做它，感觉像在玩。"
}

Tips:

blue:   { accent: '#2563EB', light: '#EFF6FF', border: '#BFDBFE' }
green:  { accent: '#059669', light: '#F0FDF4', border: '#BBF7D0' }
orange: { accent: '#D97706', light: '#FFFBEB', border: '#FDE68A' }
red:    { accent: '#E11D48', light: '#FFF1F2', border: '#FECDD3' }
purple: { accent: '#7C3AED', light: '#F5F3FF', border: '#DDD6FE' }
teal:   { accent: '#0284C7', light: '#F0F9FF', border: '#BAE6FD' }