模板库

保存、复用、管理内容模板 — 把成功经验变成可复制的结构

输入

字段	必填	说明
action	是	操作类型：save / use / list / edit / delete / get
template_name	视操作	模板名称（save / use / edit / delete / get 时必填）
source_file	否	要保存为模板的源文件路径（save 操作时使用）
source_text	否	要保存为模板的文本内容（save 操作时，与 source_file 二选一）
category	否	模板分类：xiaohongshu / weibo / douyin / zhihu / wechat / x / general
variables	否	模板变量的填充值，JSON 格式（use 操作时使用）
topic	否	使用模板时的主题/话题（use 操作时使用）
profile_name	否	绑定画像名称（有 Profile 上下文时自动填入）

输出

save 操作

## 模板已保存

**名称**: {template_name}
**分类**: {category}
**存储位置**: templates/{category}/{template_name}.md

### 提取的模板结构
| 部分 | 结构描述 | 可变区域 |
|------|----------|----------|
| 标题 | 数字 + 痛点提问 | {{title_number}}, {{pain_point}} |
| 开头 | 反常识钩子 | {{hook_statement}} |
| 正文 | 3 段式（问题-方案-证据） | {{problem}}, {{solution}}, {{evidence}} |
| 结尾 | 行动号召 + 互动引导 | {{cta}}, {{question}} |

### 模板变量
共提取 {n} 个变量，下次使用时填入具体内容即可。

use 操作

## 模板应用结果

**使用模板**: {template_name}
**主题**: {topic}

---

{根据模板结构 + 变量填充生成的内容}

---

> 基于模板 `{template_name}` 生成，可进一步调整。

list 操作

## 模板库

**总数**: {n} 个模板

### 按分类

#### 小红书 ({n1} 个)
| 模板名 | 说明 | 变量数 | 使用次数 | 创建日期 |
|--------|------|--------|----------|----------|
| 种草对比 | 双产品对比种草结构 | 8 | 5 | 2026-07-10 |
| 教程步骤 | N 步教程卡片结构 | 6 | 3 | 2026-07-08 |

#### 微博 ({n2} 个)
| 模板名 | 说明 | 变量数 | 使用次数 | 创建日期 |
|--------|------|--------|----------|----------|
| 热点评论 | 热搜话题评论结构 | 5 | 7 | 2026-07-12 |

#### 通用 ({n3} 个)
| ... | ... | ... | ... | ... |

执行步骤

模板文件读写、INDEX.json 维护、usage_count 自增、{{var}} 提取与替换已固化为 scripts/templates.py（纯 stdlib，argparse 子命令）。LLM 只做意图路由、内容结构分析 （把成功内容改写成含 {{var}} 占位符的模板正文）和结果呈现，不手写 JSON、不手动 增删文件。 索引与模板文件均原子写入（临时文件 + rename），增删模板同步更新 INDEX.json。

操作路由

1. 解析用户意图，映射到脚本子命令：
   • "保存模板" / "存为模板" → save
   • "用模板" / "套用模板" / "复用上次的结构" → use
   • "模板列表" / "有哪些模板" / "常用模板" → list
   • "编辑模板" / "改模板" → edit
   • "删除模板" → delete
   • "预览模板" / "看看模板" → get

LLM 侧职责（save/use 前的分析）

2. save 前：LLM 阅读源内容，识别固定结构与可变区域，把具体值改写成 {{变量名}} 占位符（如产品名 → {{product_name}}、痛点 → {{pain_point}}），再把改写后的正文 通过 --text 或 --file 交给脚本。脚本负责提取变量清单、写文件、登记索引。
3. use 前：LLM 根据 topic/Profile 为每个变量推导填充值，通过 --var/--vars 传入。 脚本负责替换、usage_count 自增、原子写回索引。

调用脚本

4. 统一入口（默认 --root templates）：

   S=skills/openclaw/template-library/scripts/templates.py
   python3 $S save 种草对比 --category xiaohongshu --description "双产品对比" \
           --text "标题：{{title}} A={{product_a}} vs B={{product_b}} CTA={{cta}}"
   python3 $S list --category xiaohongshu                  # 按分类列出，按使用次数降序
   python3 $S get 种草对比                                  # 预览内容 + 元信息
   python3 $S use 种草对比 --var title=夏日防晒 --var product_a=安耐晒
   python3 $S use 种草对比 --vars '{"title":"夏日防晒","cta":"点赞收藏"}'
   python3 $S edit 种草对比 --category general --description "改描述" --text "新正文 {{x}}"
   python3 $S delete 种草对比                                # 预览（dry-run）
   python3 $S delete 种草对比 --apply                        # 确认后真正删除
   

5. 脚本内置保证（无需 LLM 判断）：

   • save 同名默认报错，需 --force 覆盖；edit 改分类会移动文件并清理旧文件
   • use 未填的变量保留 {{占位符}} 并在 stderr 警告，不会静默出错
   • delete 默认 dry-run，仅打印将删除的模板，加 --apply 才真正删并清理索引
   • 所有写操作原子化，增删模板与 INDEX.json 始终一致

6. 结果呈现：把脚本输出整理成"输出"章节的 Markdown 返回给用户。

Profile 感知

• 有 Profile 上下文时：
  • save 操作自动将模板绑定到当前画像
  • list 操作优先显示当前画像的模板，其他画像的模板标记为"共享"
  • use 操作自动加载画像的 style.md 做语气适配
  • 模板文件的 frontmatter 中记录 profile: {画像名称}
• 无 Profile 上下文时：
  • 所有模板标记为 profile: shared（共享模板）
  • list 操作显示全部模板，不做画像筛选
  • use 操作不做语气适配，直接输出模板填充结果

自研溯源与参考项目见同目录 EASEL-META.md。