Automation Recipe Book

自动化配方手册专业版是面向从个人到企业的全场景自动化配方系统。在免费版8个配方基础上扩展至25+配方（6大类别），新增配方生成器框架、高级模式（条件分支/并行执行/错误处理/重试）、企业自动化模板、调试与监控工具包、配方分享与导入、版本管理与回滚七大高级能力。Use when 需要提升效率、自动化流程、批量处理、...

天轰穿@thcjp

Install

openclaw skills install @thcjp/automation-recipe-book

核心功能: 本技能提供中文交互等能力。

核心功能: 本技能提供时使用、与回滚七大高级能力、、工作流优化时使用等能力。

自动化配方手册(专业版)

付费版进阶功能

能力	免费版	付费版
基础功能	支持	支持
自动化配方手册(专业版)配方生成	不支持	支持
复杂工作流可视化编排	不支持	支持
条件分支与异常重试	不支持	支持
定时触发与事件驱动	不支持	支持
执行日志与审计追踪	不支持	支持

能力清单

详细内容已移至 references/detail.md -

功能一：25+配方库（6大类别）

功能二：配方生成器框架

详细代码示例已移至 references/detail.md

生成器能力：

自然语言描述需求，自动生成YAML配方
自动选择合适的trigger与action类型
自动推断参数（如cron频率、通知渠道）
生成后自动验证语法与逻辑
支持迭代修改（"把通知改成飞书"）

功能三：高级模式

功能四：企业自动化模板

功能五：调试与监控工具包

bash

agent recipe visualize --name daily-news --output flowchart.png
# ...
agent recipe trace --name daily-news --last-run
# ...
agent recipe analyze --name daily-news --period 7d
# ...
agent recipe validate --name daily-news
# ...
agent recipe dry-run --name daily-news --mock-input '{"title":"test"}'

调试能力：

可视化：自动生成配方可视化流程图（Mermaid格式）
执行追踪：逐步显示每个action的输入、输出、耗时
性能分析：识别耗时最长的步骤、失败率最高的步骤
试运行：用mock数据模拟执行，不产生副作用
断点调试：在指定步骤暂停，检查中间状态

功能六：配方版本管理与回滚

bash

agent recipe versions --name daily-news
# ...
agent recipe rollback --name daily-news --to previous
# ...
agent recipe rollback --name daily-news --to v1.2.0
# ...
agent recipe diff --name daily-news --v1 v1.0.0 --v2 v1.1.0
# ...

功能七：配方分享与导入

bash

agent recipe export --name daily-news --output daily-news.zip
# ...
agent recipe import --file daily-news.zip
# ...
agent recipe install --from community --name trending-news-monitor

典型场景

痛点：企业内部有大量审批、通知、报表流程，依赖人工流转，效率低且易出错. 配置：

text

1. 启用approval-flow配方，实现多级审批自动流转
2. 启用sla-monitor配方，监控关键流程SLA
3. 启用compliance-check配方，每周合规检查
4. 启用weekly-report配方，自动生成周报

效果：审批流转从平均2天缩短至4小时，SLA违规率下降70%，合规检查自动化，周报无需手动整理.

使用方法

60秒上手（升级激活）

专业版完全兼容免费版的目录结构与配方格式：

bash

ls ~/workspace/automations/recipes/
# ...
cat ~/workspace/automations/config.json | grep edition

120秒上手（配方生成器）

text

用户："帮我生成一个配方：每天晚上11点检查我的待办清单，如果有高优先级未完成项，发钉钉提醒我"
# ...
Agent："已生成配方：
  name: todo-urgent-reminder
  trigger: schedule (每天 23:00)
  actions:
    1. 读取待办清单
    2. 筛选高优先级未完成项
    3. 条件判断：是否有未完成项
    4. 发送钉钉通知
  已保存至 ~/workspace/automations/recipes/todo-urgent-reminder.yaml
  是否立即启用？"

300秒上手（完整企业配置）

请求格式

参数名	类型	必填	说明
content	string	否	处理的内容输入
mode	string	否	处理模式, 可选值: json/text/markdown
style	string	否	输出风格, 参考 `references/style.md`

结果格式

json

{
  "success": true,
  "data": {
    "result": "处理结果",
    "status": "success",
    "metadata": {
    "metadata": {
      "template_used": "reviewer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}

输出模板参考: assets/output.json

异常管理

问题	可能原因	解决方案	优先级
配方不触发	trigger配置错误	验证cron表达式；检查trigger类型	高
action执行失败	依赖技能未安装或未配置	检查requires字段；安装依赖技能	高
生成器配方质量差	需求描述不清晰	补充细节；迭代修改；手动调整	中
条件分支不生效	条件表达式语法错误	检查if/elif/else语法；用dry-run验证	高
并行执行结果丢失	wait策略配置错误	检查wait参数（all/any/first_n）	中
无效	on_failure未配置或retry次数为0	配置on_failure段；设置合理retry次数	高
配方性能差	action过多或串行执行	优化action数量；启用并行执行	中
版本回滚失败	版本文件损坏或不存在	检查版本目录；从git恢复	高
可视化生成失败	Mermaid语法错误或action类型不支持	检查action类型；更新可视化工具	低
导入配方失败	格式不兼容或依赖缺失	检查配方格式；安装依赖技能	中
企业模板对接失败	企业系统API变更	检查API可用性；更新模板配置	高

依赖与配置

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux
Python: 3.8+（用于配方验证与可视化脚本）

第三方依赖

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent平台内置LLM提供
调度器	内置	必需	Agent平台调度能力
PyYAML	Python库	配方解析必需	`pip install pyyaml`
Mermaid CLI	工具	可视化必需	`npm install -g @mermaid-js/mermaid-cli`

API Key 配置

本技能核心功能无需额外API Key
配方生成器使用Agent平台内置LLM
配方中引用的外部服务由对应技能管理API Key
告警webhook通过环境变量配置

可用性分类

分类: MD+EXEC（）
说明: 基于Markdown的AI Skill，

案例展示

场景二：团队协作编排（项目经理角色）

痛点：团队成员任务分配不透明，进度追踪困难，会议纪要无人整理. 配置：

text

1. 用配方生成器创建"任务自动分配"配方（按技能匹配任务）
2. 启用meeting-reminder配方，会议前提醒
3. 启用meeting-notes配方，会议后自动生成纪要并分发
4. 启用weekly-report配方，每周五自动汇总进度

效果：任务分配自动化且更合理，会议纪要5分钟内生成分发，周报自动汇总无需催收.

场景三：数据处理流水线（数据工程师角色）

痛点：数据ETL流程复杂，步骤间有依赖，需要断点恢复与错误处理. 配置：

效果：并行抽取缩短40%耗时，校验步骤保障数据质量，失败自动重试，无需夜间值守.

场景四：内容运营自动化（内容运营角色）

痛点：需要每日在多个平台发布内容，手动操作耗时且容易遗漏. 配置：

text

1. 启用content-generate配方，每日生成3篇候选文章
2. 启用multi-publish配方，工作日9点自动发布到3个平台
3. 启用seo-optimize配方，自动优化标题与关键词
4. 启用social-schedule配方，社媒内容排期发布

效果：内容生产与发布全自动化，运营人员从执行者变为审核者，产能提升3倍.

疑问整理

Q1：免费版与专业版有什么区别？

免费版提供8个基础配方与结构解析。专业版新增7大功能：25+配方库（6大类）、配方生成器、高级模式（条件分支/并行/错误处理）、企业模板、调试工具包、版本管理、配方分享。此外提供多角色场景指南、性能优化策略和多平台集成示例.

Q2：配方生成器如何工作？

用户用自然语言描述需求（如"每天检查待办，高优先级发钉钉"），生成器分析需求后自动选择trigger与action类型，推断参数，生成YAML配方，并自动验证语法与逻辑。支持迭代修改（"把钉钉改成飞书"）.

Q3：高级模式支持哪些控制流？

支持：条件分支（if/elif/else）、并行执行（parallel+wait策略）、循环（loop+终止条件）、子配方调用（call_recipe）、错误处理（on_failure+retry+backoff）、异常捕获（try/catch）.

Q4：企业模板包含哪些？

包含：多级审批流自动化、SLA监控与告警、合规检查（GDPR/SOC2/ISO27001）、数据治理流程、访问权限审计、报告自动生成。模板可按企业需求定制参数.

Q5：调试工具包如何帮助排查问题？

提供5大工具：可视化（生成流程图）、执行追踪（逐步查看输入输出）、性能分析（识别瓶颈步骤）、试运行（mock数据模拟）、断点调试（指定步骤暂停检查）。新配方建议先试运行验证.

Q6：版本管理支持回滚吗？

支持。每次配方变更自动保存版本，最多保留20个版本。可回滚到上一版本或指定版本，可对比两个版本差异。配置auto_rollback_on_failure: true后，配方执行连续失败3次自动回滚到上一稳定版本.

Q7：能分享配方给团队吗？

可以。导出配方为zip包（含YAML与依赖说明），团队成员导入即可使用。也可通过社区配方市场分享与安装热门配方。导入的配方会自动验证兼容性.

Q8：配方能调用其他技能吗？

可以。配方中的action可引用任何已安装的技能（如fetch、mail、browser）。在action的requires字段声明依赖技能，调度器会自动加载。未安装的技能会提示用户安装.

Q9：25+配方都开箱即用吗？

大部分配方修改参数后即可使用（如改URL、通知渠道）。部分企业模板（如审批流）需要与企业现有系统对接，需额外配置。每个配方都有详细的参数说明与前置条件说明.

Q10：配方执行失败会怎样？

根据on_failure配置处理：

retry：自动重试N次（支持指数退避）
notify：通知指定渠道
escalate：升级通知上级
auto_rollback：回滚到上一版本未配置on_failure时，仅记录日志不重试.

Q11：能同时运行多少个配方？

无硬性限制，但建议根据Agent资源合理安排。高频配方（每分钟级）不超过5个，中频（每小时级）不超过20个，低频（每日级）无限制。调度器会自动错峰执行，避免资源竞争.

故障处理体系

错误场景	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	请求重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

诊断与修复

错误现象	可能原因	诊断步骤	解决方案
配方无法触发	触发器配置错误或时间设置不正确	检查触发器类型和cron表达式，确认时间设置	修正cron表达式，确保触发器类型正确
Action执行失败	依赖的技能未安装或配置错误	检查`requires`字段，确认依赖技能已安装	安装缺失的技能，并正确配置
配方生成器无法生成配方	用户输入描述不清晰或语法错误	仔细检查用户输入，确保描述清晰且语法正确	提供更清晰的描述，修正语法错误
配方执行速度慢	Action过多或执行顺序不当	分析配方中的Action，考虑并行执行或优化顺序	优化Action数量，考虑并行执行
配方版本回滚失败	版本文件损坏或不存在	检查版本目录，确认版本文件完整	恢复损坏的版本文件或从备份中恢复

安全规范

风险项	等级	防护措施	验证方法
配方泄露	高	对配方文件进行加密存储，限制访问权限	定期审计访问日志，确保没有未授权访问
配方执行错误	中	对配方执行进行监控，设置错误告警	检查告警日志，确保错误被及时处理
数据泄露	高	对敏感数据进行加密处理，确保数据传输安全	定期进行安全审计，确保加密措施有效
未授权访问	高	实施严格的身份验证和授权机制	定期进行安全测试，确保没有未授权访问
系统漏洞	高	保持系统更新，及时修复已知漏洞	定期进行漏洞扫描，确保系统安全

创新优势

场景	效率提升量化分析	差异性对比
数据处理流水线	通过并行执行缩短40%耗时，错误自动重试，无需夜间值守	相比传统ETL流程，自动化配方手册(专业版)大幅提升效率，减少人工干预
团队协作编排	自动分配任务，会议纪要自动生成，周报自动汇总	相比手动操作，自动化配方手册(专业版)提高团队协作效率，减少沟通成本
内容运营自动化	内容生产与发布全自动化，运营人员从执行者变为审核者	相比手动发布，自动化配方手册(专业版)大幅提升内容运营效率，减少人力成本
企业审批流程	多级审批自动流转，SLA监控与告警，合规检查自动化	相比传统审批流程，自动化配方手册(专业版)提高审批效率，降低错误率
日常任务管理	自动检查待办清单，发送提醒，生成报告	相比手动管理，自动化配方手册(专业版)提高个人工作效率，减少遗漏和重复工作

效率指标

操作场景	手动耗时	自动化耗时	效率提升
文件解析与提取	5-10分钟/个	<5秒/个	60-120x
批量文件处理(100个)	8-16小时	<5分钟	96-192x
API调用与响应解析	2-3分钟/次	<1秒/次	120-180x
多接口数据聚合	15-30分钟	<10秒	90-180x
命令执行与结果收集	3-5分钟/次	<2秒/次	90-150x
重复任务批量执行	因任务而异	线性缩减	5-50x
错误排查与修复	10-30分钟	<30秒	20-60x

特色分析

对比维度	自动化配方手册(专业版)	传统手动方式	通用脚本工具
自动化程度	全流程自动	完全手动	部分自动
错误处理	内置错误恢复	依赖人工经验	基本try-catch
可复用性	参数化配置	一次性脚本	模板化
安全合规	内置安全检查	无安全保障	无安全保障
适用场景	25+自动化配方库+配方生成器+高级模式+企业模板+调试工具包，支撑从个人到企业	通用场景	通用场景

问题解答汇总

Q1: 自动化配方手册(专业版)支持哪些输入格式？

A1: 25+自动化配方库+配方生成器+高级模式+企业模板+调试工具包，支撑从个人到企业的全场景自动化。自动化配方手册专业版是面向从个人到企业的全场景自动化配方系统。在。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

疑问解答精选

故障应对方案

针对自动化配方手册(专业版)使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

自动化配方手册(专业版)通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块

功能边界

极端边界输入可能影响输出质量,建议对异常输入做预校验
API调用受平台速率限制,高频场景需实现请求队列和退避策略
模型推理耗时与输入长度正相关,超长输入需考虑分段处理
大文件处理可能消耗较多内存,建议对超大文件进行分块处理
命令执行权限需遵循最小权限原则,避免以root/administrator权限运行