| name | cclaw |
| version | 1.10.0 |
| description | Open-source comedy AI + video editing + poster generation. Create standup/sketch/manzai/scripts, edit videos via FFmpeg, and generate comedy posters via canvas-design. Supports Damai/Maoyan/Xiudong platform specs. Keywords: comedy, standup, sketch, video, edit, poster, canvas. |
| description_zh | 全球首个开源喜剧 AI + 视频剪辑 + 海报生成工具。创作脱口秀/小品/漫才/剧本等喜剧内容，或通过自然语言脚本驱动 FFmpeg 进行视频剪辑，或生成脱口秀/演出/金句海报及大麦/猫眼/秀动等平台标准规格物料。 |
| category | data-analysis |
Cclaw — 喜剧写手 + 视频剪辑 + 海报生成
技能架构
本技能分两大模块：
- writing — 喜剧文本创作（知识驱动）
- tools — 工具执行（脚本驱动：视频剪辑 + 海报生成）
Cclaw/
├── SKILL.md
├── commands.md ← 文本命令 + 视频命令
├── modules/
│ ├── writing/ ← 7种喜剧输出模板
│ └── tools/
│ ├── video/ ← 视频剪辑（FFmpeg + 自然语言脚本）
│ └── poster/ ← 海报生成（brief驱动 + canvas-design视觉）
├── knowledge/
│ ├── theory/ ← 喜剧底层原理（必读）
│ └── cases/ ← 案例库 + 创作方法论（必读）★
└── references/ ← 索引
工作流程（四步，含意图确认分支）
Step 1：识别命令
读取 commands.md，根据用户输入判断是文本创作还是视频工具。
- 文本创作 → 进入 Step 1B
- 视频工具 → 进入 Step 2B
- 海报工具 → 进入 Step 2C
Step 1B：意图确认分支
判断用户给了多大信息量：
情况A — 用户给了明确场景和方向
包含具体话题、主题、场景描述、情绪关键词等实质内容
例如："写一段关于程序员相亲的脱口秀"、"吐槽地铁上不让座的大爷"
→ 直接跳过 Step 1C，立即进入 Step 2A（创作流程：黑话→模板→案例→理论→输出）
情况B — 用户只给模糊泛化提示
只有体裁关键词，无具体方向。触发词包括：
"写一段脱口秀" / "写个漫才" / "写个小品" / "来一段" / "创作" 等（无具体话题）
→ 必须先执行 Step 1C：意图确认，确认完毕后再进入 Step 2A
Step 1C：意图确认四问（仅情况B触发）
交互原则：每个问题用户可以只选选项，也可以选选项+补充描述。辅助解析时同时提取：①选择的选项 ②用户的额外描述用于丰富创作
用以下对话与用户交互，每轮等待用户回复：
第一步：选定体裁
请先告诉我，你想要创作哪一种喜剧内容？
A. 脱口秀
B. 漫才
C. Sketch 短喜剧
D. 日式短剧（コント）
示例A回复：「A」
示例B回复：「A，我想讲程序员的生活」
第二步：选定内容核心题材
根据选择的体裁，对应不同创作内核（可只选数字，也可补充你的想法）：
若选择【脱口秀】，请挑选创作内核：
- 个人亲身经历与生活故事
- 日常社会、生活细节观察
- 个人态度、价值观输出观点
- 热点事件、社会新闻评论
示例A回复：「1」或「1，我想讲相亲的经历」
若选择【漫才】，请挑选创作内核：
- 日常离谱小事吐槽
- 认知偏差、常识反差梗
- 情侣/朋友/职场人物矛盾
- 脑洞幻想、无厘头设定
示例回复：「2」或「2，就是那种理工男跟文科男聊天的日常」
若选择【Sketch】，请挑选创作内核：
- 经典场景夸张演绎
- 身份错位、人设反差
- 社会现象戏剧化讽刺
- 小众脑洞、荒诞短剧设定
示例回复：「3」或「3，我想讽刺那些跟风考研的人」
若选择【日式短剧】，请挑选创作内核：
- 极端性格被逼到极限（偏执/懦弱/自大/较真）
- 日常场景被打破（办公室/医院/便利店/家里）
- 明确目标+层层阻碍升级
- 荒诞反转收尾
示例回复：「1」或「1，我想写一个偏执狂在便利店买东西」
第三步：锁定核心情绪感受
请选择最能描述你感受的选项（可只选字母，也可补充你的想法）：
A. 对某个现象的强烈共鸣（"说的就是你！我也遇到过！"）
B. 意外感/荒诞感（"居然还能这样？！"）
C. 优越感（"看ta出糗，真爽"）
D. 情绪发泄（把憋了很久的话说出来了，爽！）
E. 自我解嘲（把自己的糗事说出来，跟自己和解）
F. 讽刺批判（对这个现象开炮）
G. 荒诞幽默（完全不讲道理，但就是好笑）
H. 温暖治愈（笑着笑着被打动了）
示例A回复：「A」
示例B回复：「A，每次看到这种情况我就超有共鸣」
第四步：明确表演受众对象
本次段子/短剧的演出观众是谁？（可只选数字，也可补充你的想法）
- 孩童/低龄群体
- 年轻人、大学生、职场青年
- 中年、中老年群体
- 全年龄通用，大众适配
示例回复：「2」或「2，主要是给职场人士看」
确认完毕后将四个选项汇总成一句话创作方向。
第五步：选定风格（可选，跳过则自动推断）
风格是大类下的"怎么讲"的调性选择。如果用户已指定风格则跳过；若是模糊创作请求，推荐最匹配的1-2种风格供确认，或让用户补充。
→ 读取 knowledge/style-guide.md，根据前四步的信息推断推荐风格。
汇总格式示例：
"我要创作一段脱口秀，主题是日常社会生活细节观察，情绪强烈共鸣（A式），受众普通人，风格自嘲式"
Step 2A：文本创作（知识驱动）
按顺序读取知识，每个步骤都要查，不能跳过：
⓪ 加载黑话手册
→ knowledge/blackbook.md
→ 读取本次创作涉及的所有行业术语（蒸馏/龙虾/国潮/模型崩溃等）的统一解释
→ 黑话手册是第一优先级——无论创作什么主题，先加载黑话，确保术语含义一致、不泄底、不跳步
② 读取输出模板 + 确定风格
→ modules/writing/<类型>-template.md
→ 确定结构规范、分段要求、对话格式
→ 同步读取风格推荐：knowledge/style-guide.md 中该大类下的风格列表
→ 若是模糊请求（情况B），输出风格推荐供用户确认；若是明确请求（情况A），根据 prompt 自动推断风格并说明理由
③ 读取案例库（按风格筛选） ★
→ knowledge/cases/<类型>/ 下的所有 .md 文件
→ 读取时检索风格标签：style:
→ 优先读与本次风格匹配的案例，辅读其他风格建立对比
→ 提取创作思路、人物原型、节奏技巧
→ 如果该类型目录为空或只有 README，至少读取一个其他类型的案例来建立感觉
→ 风格匹配规则：案例的 style: 标签与本次创作风格完全匹配优先；部分匹配次之；无标签案例最后读
④ 读取理论原理
→ knowledge/theory/eb7cb5ef.md — 喜剧核心原理（必读）
→ knowledge/theory/ac07d434.md — 包袱结构与铺垫节奏
→ knowledge/theory/126b44e8.md — 笑的心理学
→ knowledge/theory/9d01e4da.md — 喜剧类型速查
→ knowledge/theory/japanese-sketch.md — 日式短剧核心理论（仅日式短剧必读）
⑤ 按模板创作（融入风格调性）
→ 套用结构，融合案例灵感和理论手法
→ 风格调性贯穿全文：用词语气、节奏密度、情感落点均贴合选定风格
→ 输出成品
Step 2B：视频工具（脚本驱动）
→ 读取 modules/tools/video/README.md
→ 解析自然语言脚本
→ 生成 FFmpeg 命令并执行
Step 2C：海报工具（brief 驱动）
→ 读取 modules/tools/poster/README.md
→ 识别海报类型：
- 通用海报：standup-poster / comedy-show / social-card
- 演出平台海报：damai-poster / maoyan-poster / damai-detail / maoyan-detail
- Banner：banner-maoyan / banner-xiudong / banner-damai-999 / banner-damai-1404
→ 信息收集（两步）：
- 场景A：刚创作完内容 → 自动提取（标题/金句/作者），只确认缺失信息
- 场景B：单独请求 → 交互确认 brief 模板中的必填字段
→ 填充 design brief：读取对应
briefs/<类型>.md 模板，用收集的信息填充
→ 调用 canvas-design：将填充好的 brief 作为 canvas-design 的输入，按其工作流生成视觉作品
→ 输出 PNG 或 PDF
演出平台规格速查：
| 类型 | 尺寸 | 用途 |
|---|
| 大麦海报 | 1020×1360 | APP首图 |
| 猫眼海报 | 1800×2400 (≤2M) | APP首图 |
| 大麦详情 | 1020px宽 | 详情页长图 |
| 猫眼详情 | 800px宽 (≤13M) | 详情页长图，支持动图 |
| 猫眼Banner | 1053×180 | 首页轮播 |
| 秀动Banner | 1114×200 | 首页轮播 |
| 大麦Banner | 999×375 / 1404×320 | 首页/活动页 |
Step 3：输出
→ 创作输出 → 附加创作笔记（手法说明 + 知识来源标注）
⚠️ 输出规则：正文不含结构标签
- 正文（脱口秀/小品/漫才/剧本等）是给演员/观众看的，必须干净，不含任何结构标记（如【开场 Hook】【第一段】等）
- 结构标签仅供创作规划时在脑中参考，不要出现在最终输出里
- 创作笔记可以标注各段的手法、节奏、设计意图，方便创作者复盘
知识库完整索引
黑话手册（底层术语，⓪优先加载）
| 文件 | 内容 |
|---|
knowledge/blackbook.md | 行业术语统一解释（蒸馏/龙虾/国潮/模型崩溃等），每次创作第一步加载 |
knowledge/style-guide.md | 风格体系索引：各体裁下的风格分类、自动推断逻辑、风格标签规范 |
knowledge/theory/ | 喜剧底层原理（必读） |
理论（底层原理，必读）
| 文件 | 内容 |
|---|
knowledge/theory/eb7cb5ef.md | 喜剧创作核心原理（机械化法则、心不在焉、反差等） |
knowledge/theory/ac07d434.md | 包袱结构与铺垫节奏（三番四抖、重复升级） |
knowledge/theory/126b44e8.md | 笑的心理学机制（期望落空、压抑释放） |
knowledge/theory/9d01e4da.md | 喜剧类型速查（各类型特征与核心手法） |
knowledge/theory/japanese-sketch.md | 日式短剧（コント）创作理论（角色/情境/目的三要素、起承转合四步结构、装傻吐槽机制、节奏铁律） |
案例库（创作参考，★本次强化）★
注意：各目录内容充实程度不均。实际有内容的标注 ✅，空目录标注（待填充）。
| 类型 | 路径 | 内容 | 状态 |
|---|
| 脱口秀 | knowledge/cases/standup/ | 成长路径模型、三大杂念粉碎法、排毒日记法、脱口秀第一课一二章笔记、灵感库训练体系 | ✅ 充实，有风格标签 |
| 小品 | knowledge/cases/sketch/ | 小品结构模板、人物关系设计 | ✅ 有模板，有风格标签 |
| 漫才 | knowledge/cases/manzai/ | 目录待填充 | ⚠️ 空目录 |
| 日式短剧 | knowledge/cases/japanese-sketch/ | 目录待填充 | ⚠️ 空目录 |
| 仿讽 | knowledge/cases/parody/ | 目录待填充 | ⚠️ 空目录 |
| 剧本 | knowledge/cases/script/ | 目录待填充 | ⚠️ 空目录 |
★ cases 目录为空时： 直接跳过 cases 步骤，不读取其他类型案例。
特别说明：
knowledge/cases/standup/growth-path.md — 脱口秀创作者心法，包含成长阶段模型、排毒日记法（素材挖掘格式）、三大杂念粉碎法。创作脱口秀时必读。knowledge/cases/sketch/sketch创作模板_平台课程.md — 小品创作模板，包含小品三要素、四种节奏、人物弧线设计。knowledge/theory/japanese-sketch.md — 日式短剧（コント）核心理论，包含角色/情境/目的三要素、起承转合四步结构、装傻吐槽机制、15秒节奏铁律。创作日式短剧时必读。
输出模板
| 类型 | 文件 |
|---|
| 脱口秀 | modules/writing/standup-template.md |
| 小品 | modules/writing/sketch-template.md |
| 漫才 | modules/writing/manzai-template.md |
| 日式短剧 | modules/writing/japanese-sketch-template.md |
| 剧本 | modules/writing/script-template.md |
| 讽刺 | modules/writing/satire-template.md |
| 仿讽 | modules/writing/parody-template.md |
| 荒诞剧 | modules/writing/absurdist-template.md |
风格体系
风格是大类（脱口秀/漫才/Sketch/日式短剧）之下的第二层维度，同一体裁可以有完全不同的讲法。详见 knowledge/style-guide.md。
一切喜剧效果的根本来源：生命中出现机械性、僵硬性。
三大铁律：
- 角色越不自觉，越可笑
- 观众越不动情，越能发笑
- 效果逐级递增
⛔ 理论隐身规则（必须遵守）
- ❌ 正文禁止：人名、书名、理论术语标签
- ✅ 创作笔记可保留：手法名 + 简要说明 + 知识来源文件
喜剧手法速查
三大情境手法
三大语言手法
相声三翻四抖
- 三番（四抖） — 反复铺垫，第三/四遍突然反转抖包袱
漫才核心节奏
- 连续否认 — 三次以上否定，每次理由更荒谬，最后放弃反驳
