Recipe 规范

每个 recipe 是一个 SKILL.md，格式与产品 skill 同等身份。

架构三层

Layer 1: _common/conventions.md     → 全局共享（认证、安全规则、字段术语）
                                       相当于 gws-shared/SKILL.md

Layer 2: products/*.md              → 产品能力（命令用法、flags、示例）
                                       相当于 gws-gmail/SKILL.md, gws-docs/SKILL.md

Layer 3: recipe-xxx/SKILL.md        → 组合配方（固定步骤 + 声明依赖）
                                       相当于 recipe-send-team-announcement/SKILL.md

Recipe SKILL.md 格式

---
name: recipe-<verb>-<object>
description: "一句话描述"
metadata:
  category: "recipe"
  domain: "<领域编号>"
  requires:
    bins:
      - dws
    skills:
      - <product-1>
      - <product-2>
---

正文只包含：

标题 + 一句话描述
> **PREREQUISITE:** ... 提示加载哪些 skill
## Steps — 编号步骤，每步一条 dws 命令

不包含（这些留给 conventions.md 和 best_practice.md）：

安全门控/决策分支/踩坑提醒
失败处理策略
数据佐证

命名规则

recipe-<verb>-<object>[-<modifier>]

动词	含义	示例
send	发送	recipe-send-message
create	创建	recipe-create-todo
query	查询	recipe-query-doc
write	写入	recipe-write-doc
resolve	解析	recipe-resolve-contact
generate	生成	recipe-generate-daily-report
share	分享	recipe-share-doc-and-notify

路由规则

Agent 识别意图后：

匹配到 recipe → 加载 recipe 声明的 skills → 按 Steps 执行
无匹配 recipe → 走领域 best_practice.md 策略指南
只需单个命令 → 直接查 products/*.md

1.8 KiB Raw Blame History

Recipe 规范

架构三层

Recipe SKILL.md 格式

命名规则

路由规则

1.8 KiB

Raw Blame History