first commit

.agents/skills/dingtalk-shared/references/recipes/meta.md

@@ -0,0 +1,67 @@
+# 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 格式
+
+```yaml
+---
+name: recipe-<verb>-<object>
+description: "一句话描述"
+metadata:
+  category: "recipe"
+  domain: "<领域编号>"
+  requires:
+    bins:
+      - dws
+    skills:
+      - <product-1>
+      - <product-2>
+---
+```
+
+**正文**只包含：
+1. 标题 + 一句话描述
+2. `> **PREREQUISITE:** ...` 提示加载哪些 skill
+3. `## 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 识别意图后：
+1. 匹配到 recipe → 加载 recipe 声明的 skills → 按 Steps 执行
+2. 无匹配 recipe → 走领域 best_practice.md 策略指南
+3. 只需单个命令 → 直接查 products/*.md