Template Library Agent Skill

模板库

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

输入

| 字段 | 必填 | 说明 |

|------|------|------|

| 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。

操作路由

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

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

• save 前：LLM 阅读源内容，识别固定结构与可变区域，把具体值改写成 {{变量名}}

占位符（如产品名 → {{product_name}}、痛点 → {{pain_point}}），再把改写后的正文

通过 --text 或 --file 交给脚本。脚本负责提取变量清单、写文件、登记索引。

• use 前：LLM 根据 topic/Profile 为每个变量推导填充值，通过 --var/--vars 传入。

脚本负责替换、usage_count 自增、原子写回索引。

调用脚本

• 统一入口（默认 --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                        # 确认后真正删除

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

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

Profile 感知

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

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