知识卡片生成器

将知识内容转化为视觉化的知识卡片图片系列。支持从文章自动提取知识点拆分，也支持直接输入知识点。可选的卡通角色融合——有角色图片时自然融入卡片画面。

两个维度

自由组合：--layout tips --style notion

或使用预设：--preset study-guide → 类型 + 风格一步到位。详见 预设快捷方式。

卡片类型（Layout）

详见 references/card-layouts.md。

风格（Style）

详见 references/styles.md。

使用方式

# 从文章提取知识点生成卡片系列
/panda-knowledge-card article.md

# 指定风格
/panda-knowledge-card article.md --style notion

# 直接输入知识点
/panda-knowledge-card
[粘贴内容或描述知识点]

# 指定卡片类型 + 风格
/panda-knowledge-card --layout tips --style bold

# 使用预设
/panda-knowledge-card article.md --preset study-guide

# 指定平台
/panda-knowledge-card article.md --platform xhs

# 指定角色模式
/panda-knowledge-card article.md --role narrator

选项

工作流程

- [ ] 步骤 0: 预检查（EXTEND.md、角色配置）
- [ ] 步骤 1: 内容分析（文章提取 或 手动输入）
- [ ] 步骤 2: 确认设置（AskUserQuestion）
- [ ] 步骤 3: 生成大纲
- [ ] 步骤 4: 生成提示词 + 图片
- [ ] 步骤 5: 完成报告

步骤 0: 预检查

0.1 加载偏好设置（EXTEND.md）⛔ 阻塞

test -f .panda-skills/panda-knowledge-card/EXTEND.md && echo "project"
test -f "${XDG_CONFIG_HOME:-$HOME/.config}/panda-skills/panda-knowledge-card/EXTEND.md" && echo "xdg"
test -f "$HOME/.panda-skills/panda-knowledge-card/EXTEND.md" && echo "user"

0.2 加载角色配置

从 EXTEND.md 的"角色"区块读取角色信息。角色融合的详细规则引用 panda-article-illustrator 的 character-roles.md。

完整流程详见 references/workflow.md

步骤 1: 内容分析

文章提取模式：分析文章，提取核心知识点，自动拆分为卡片序列。详见 references/extraction-rules.md。

手动输入模式：结构化用户提供的知识点，确定适合的卡片类型。

完整流程详见 references/workflow.md

步骤 2: 确认设置 ⚠️

使用 AskUserQuestion，最多 4 个问题。

完整流程详见 references/workflow.md

步骤 3: 生成大纲

保存 outline.md 到输出目录，包含每张卡片的标题、要点、布局类型、角色动作。

完整模板详见 references/workflow.md

步骤 4: 生成提示词 + 图片

⛔ 提示词文件必须在图片生成之前保存。

1. 为每张卡片创建提示词文件，遵循 references/prompt-construction.md
2. 保存到 prompts/NN-{layout}-{slug}.md
3. 有角色时注入角色区块，使用 --ref 传递角色参考图
4. 调用图片生成技能生成图片

完整流程详见 references/workflow.md

步骤 5: 完成报告

知识卡片生成完成！

主题：[topic]
风格：[style] | 平台：[platform] | 比例：[ratio]
角色：[名称] / [融合模式] 或 "无角色"
卡片：X 张已生成

文件列表：
✓ outline.md
✓ 01-cover-[slug].png
✓ 02-tips-[slug].png
✓ ...
✓ NN-summary-[slug].png

输出目录

{output-dir}/
├── source-{slug}.md          # 源内容（如有）
├── outline.md                # 大纲
├── prompts/
│   └── NN-{layout}-{slug}.md
├── 01-cover-{slug}.png
├── 02-{layout}-{slug}.png
└── NN-summary-{slug}.png

Slug 规则：2-4 个词，kebab-case。冲突：追加 -YYYYMMDD-HHMMSS。

修改已有卡片

参考文档