Reshape multi shared recipe dirs for agent-friendly paths, content unchanged.

Move dingtalk-shared best_practices/_common into references/recipes/, drop duplicated product _common/conventions copies, and retarget links. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-06 10:53:28 +08:00
1 parent 86f2b14449
commit 657df05d40
@@ -71,7 +71,7 @@ skills/mono/
 | 跨产品路由 / 工作流 | `references/routing.md`、`workflow-routing.md`、`intent-guide.md` |
 | 运行时最小契约长文 | `references/runtime-contract.md`（受 context-budget 约束） |
 | 全局协议（确认门禁 / Schema 教学等） | `references/`；见质检基线 |
-| 与 mono 全局文同名迁移 | `error-codes`、`url-patterns`、`capability-limits`、`channel-login`、`global-reference`、`best_practices/` |
+| 与 mono 全局文同名迁移 | `error-codes`、`url-patterns`、`capability-limits`、`channel-login`、`global-reference`、`recipes/`（shared 层：`recipes/shared/`、`recipes/lite-catalog.md`） |

 产品专属规则（如 AI 表格 `field-rules`）允许下沉到对应 `dingtalk-*`，须在覆盖表注明。

@@ -23,7 +23,7 @@ import "embed"
 // FS holds the peer mono and multi installable skill trees. Schema-generation
 // inputs live under internal/cli and are intentionally not embedded. The all:
 // prefix keeps underscore-prefixed directories (for example,
-// references/best_practices/_common) that plain embed patterns would skip.
+// dingtalk-shared/references/recipes/shared) that plain embed patterns would skip.
 //
 //go:embed all:mono all:multi
 var FS embed.FS
@@ -5,7 +5,7 @@
 | Recipe | 行动指南（固定路线） |
 |--------|-------------------|
 | read-aitable | 1. `aitable base search --query "<表格名>"` → 取 `baseId`/`tableId`<br>2. `aitable field get --base-id <baseId> --table-id <tableId>` → 取 `fieldId`<br>3. `aitable record query --base-id <baseId> --table-id <tableId>` → 取记录（分页）<br>　　需要筛选时 `--filters` 格式见 [aitable-filter-sort.md](./aitable/aitable-filter-sort.md)，根节点必须是 `{"operator":"and\|or","operands":[...]}`<br>4. 总结数据 |
-| generate-data-report | 1. 同 read-aitable 步骤 1-3<br>2. 按[「多源并行采集」](_common/conventions.md#多源并行采集公共模式)执行 → 补充背景<br>3. `doc create --name "<报告名>" --content "<分析报告>"` |
+| generate-data-report | 1. 同 read-aitable 步骤 1-3<br>2. 按[「多源并行采集」](../../dingtalk-shared/references/recipes/shared/conventions.md#多源并行采集公共模式)执行 → 补充背景<br>3. `doc create --name "<报告名>" --content "<分析报告>"` |
 | create-aitable-record | **批量导入优先**：`python scripts/import_records.py <baseId> <tableId> data.csv\|data.json [batch_size]`（自动分批创建）<br>单条/少量：1. `aitable base search --query "<表格名>"` → 取 `baseId`/`tableId`<br>2. `aitable field get --base-id <baseId> --table-id <tableId>` → 取 `fieldId` 与类型<br>3. `aitable record create --base-id <baseId> --table-id <tableId> --records '[{"cells":{"<fieldId>":"值"}}]'` |
 | update-aitable-record | 1. `aitable base search --query "<表格名>"` → 取 `baseId`/`tableId`<br>2. `aitable record query --base-id <baseId> --table-id <tableId>` → 取 `recordId`，**先展示让用户确认**<br>3. `aitable record update --base-id <baseId> --table-id <tableId> --records '[{"recordId":"<recordId>","cells":{...}}]'` |
 | search-aitable-template | 1. `aitable template search --query "<关键词>"` → 取 `templateId`<br>2. 用户选定<br>3. `aitable base create --name "<表格名>" --template-id <templateId>` → 取 `baseId` |
@@ -1,44 +0,0 @@
-# 业务域通用规范
-
-> 仅服务本 skill 已迁入的行动指南。安全门控、危险操作确认、`--format json` 等已在本 skill 的 `SKILL.md` 中定义，此处不重复。
-
-## 批量查询规范
-
-| # | 规范 |
-|---|------|
-| 1 | **并行查详情**：拿到多个 ID 后，用 `&` 合并到同一条 Shell 命令并行执行 + `wait`，**严禁逐条串行** |
-| 2 | **翻页**：分页接口须拉全直至无更多 |
-| 3 | **优先批量 API**：有批量接口则用批量；无则按 #1 并行 |
-| 4 | **群消息**：必须先 `chat search --query` 得 `openConversationId`，再 `chat message list --group <openConversationId> --time "<yyyy-MM-dd HH:mm:ss>" --direction older`；多群同条命令并行 |
-| 5 | **列表少轮次**：带条件搜索/列表 → 一次采全详情；**禁止**无新参数时重复同一 `list` / `search` |
-
-## 多源并行采集（公共模式）
-
-> recipe 引用方式：`按「多源并行采集」执行（关键词=<X>，时间=<Y>至<Z>）`。
-
- 同条 Shell：`&` 并行 + `wait`；分页须采全。
- 只保留与主题相关的数据，无关丢弃。
- 有批量详情接口优先；否则并行拉详情（见上表 #1）。
- 具体采哪些产品列表由对应 **行动指南 recipe** 与当前产品参考决定；不要引入本文档未覆盖的产品路线。
-
-## 字段术语与 ID 传递
-
-> list 返回 JSON 后，必须提取下表字段传给后续命令。**禁止用其他字段替代。**
-
-| 字段 | 来源 | 传递给 |
-|------|------|--------|
-| `taskUuid` | `minutes list` | `minutes get summary/info/batch --id(s)` |
-| `userId` | `aisearch person` / `contact user search` / `contact dept list-members` | `contact user get --ids`、`todo --executors`、`calendar --users` |
-| `deptId` | `contact dept search` | `contact dept list-members --ids <deptId1,deptId2...>`；多子部门时对每个子部门分别 `dept search` 取 id |
-| `nodeId` | `drive search` / `wiki node search` | `doc read/update --node`、`drive copy/move/rename/delete --node` |
-| `nodeId` | `wiki node list` 中的 folder 类型节点 / `wiki node create --type folder` | `wiki node list --folder`、`wiki node create --folder`、`drive upload --folder`、`drive copy/move --folder` |
-| `eventId` | `calendar event list` | `calendar event get/update --id` |
-| `processInstanceId` | `oa approval list-*` | `oa approval detail/approve --instance-id` |
-| `openConversationId` | `chat search` | `chat message list/send --group` |
-| `todoTaskId` | `todo task list` | `todo task update/done --task-id` |
-| `reportId` | `report inbox list` / `report outbox list` | `report entry get/stats --report-id` |
-| `baseId` / `tableId` | `aitable base search` | `aitable record query --base-id --table-id` |
-| `dentryUuid` | `drive list` / `drive mkdir` | `drive info/download/copy/move/rename/delete --node`、`drive list/mkdir/upload/copy/move --folder` |
-| `dentryId` | `drive info` 的数字字段 | 仅用于 `chat message send --dentry-id` |
-
-**ID 边界硬约束**：`dentryId` 通常是纯数字，只表示聊天文件消息需要的钉盘条目数字 ID；它不是父目录 ID。遇到 `drive --node/--folder`、`doc --node`、`wiki node --folder` 时，只能使用 `dentryUuid` / `nodeId` / 文档 URL。若当前上下文只有数字型 `dentryId`，必须先重新 `drive list` / `drive search` / `wiki node list` 获取正确 ID，不能把该数字直接代入后续命令。
@@ -1,7 +1,7 @@
 # 通讯录（组织架构）

 > **SKILL.md** 中 #8 内联 3 条 **lite**：`get-contact-self`、`search-person`、`search-user`。下列 recipe、专用规则与消歧请在命中 #8 且**超出**上述 lite 时阅读本文。
-> 产品命令见 [contact.md](./contact.md)。通用批量/并行见 [_common/conventions.md](_common/conventions.md)。
+> 产品命令见 [contact.md](./contact.md)。通用批量/并行见 [conventions.md](../../dingtalk-shared/references/recipes/shared/conventions.md)。

 ## 专用规则（#8 非 lite 步骤必守）

@@ -15,7 +15,7 @@
  3. 将「姓名 + 部门 + 职位」列表展示给用户，请用户确认选择哪一位
  4. 使用用户确认的 `userId` 继续后续操作
  > **根因**：`aisearch person` 不返回完整部门信息，无法仅凭搜索结果区分同名用户。**必须**追加 `contact user get` 获取部门信息才能消歧。
- **批量**：多个 `userId` 用 `contact user get --ids id1,id2,...`；多部门成员列表按需并行，遵守单次批量上限与 [_common/conventions.md](_common/conventions.md)。
+- **批量**：多个 `userId` 用 `contact user get --ids id1,id2,...`；多部门成员列表按需并行，遵守单次批量上限与 [conventions.md](../../dingtalk-shared/references/recipes/shared/conventions.md)。
 - **子部门枚举**：已知父部门 `deptId` 时**优先** `contact dept list-children --dept <父deptId>` 直接拿到完整子部门列表；只知道部门名时先 `contact dept search --query "<父部门名>"` 取 `deptId` 再 `list-children`；用户明示的子部门名（无需枚举）可直接 `dept search` 命中。多子部门展开见 `explore-subdepts-and-members`。

 ## 与其他场景消歧
@@ -1,44 +0,0 @@
-# 业务域通用规范
-
-> 仅服务本 skill 已迁入的行动指南。安全门控、危险操作确认、`--format json` 等已在本 skill 的 `SKILL.md` 中定义，此处不重复。
-
-## 批量查询规范
-
-| # | 规范 |
-|---|------|
-| 1 | **并行查详情**：拿到多个 ID 后，用 `&` 合并到同一条 Shell 命令并行执行 + `wait`，**严禁逐条串行** |
-| 2 | **翻页**：分页接口须拉全直至无更多 |
-| 3 | **优先批量 API**：有批量接口则用批量；无则按 #1 并行 |
-| 4 | **群消息**：必须先 `chat search --query` 得 `openConversationId`，再 `chat message list --group <openConversationId> --time "<yyyy-MM-dd HH:mm:ss>" --direction older`；多群同条命令并行 |
-| 5 | **列表少轮次**：带条件搜索/列表 → 一次采全详情；**禁止**无新参数时重复同一 `list` / `search` |
-
-## 多源并行采集（公共模式）
-
-> recipe 引用方式：`按「多源并行采集」执行（关键词=<X>，时间=<Y>至<Z>）`。
-
- 同条 Shell：`&` 并行 + `wait`；分页须采全。
- 只保留与主题相关的数据，无关丢弃。
- 有批量详情接口优先；否则并行拉详情（见上表 #1）。
- 具体采哪些产品列表由对应 **行动指南 recipe** 与当前产品参考决定；不要引入本文档未覆盖的产品路线。
-
-## 字段术语与 ID 传递
-
-> list 返回 JSON 后，必须提取下表字段传给后续命令。**禁止用其他字段替代。**
-
-| 字段 | 来源 | 传递给 |
-|------|------|--------|
-| `taskUuid` | `minutes list` | `minutes get summary/info/batch --id(s)` |
-| `userId` | `aisearch person` / `contact user search` / `contact dept list-members` | `contact user get --ids`、`todo --executors`、`calendar --users` |
-| `deptId` | `contact dept search` | `contact dept list-members --ids <deptId1,deptId2...>`；多子部门时对每个子部门分别 `dept search` 取 id |
-| `nodeId` | `drive search` / `wiki node search` | `doc read/update --node`、`drive copy/move/rename/delete --node` |
-| `nodeId` | `wiki node list` 中的 folder 类型节点 / `wiki node create --type folder` | `wiki node list --folder`、`wiki node create --folder`、`drive upload --folder`、`drive copy/move --folder` |
-| `eventId` | `calendar event list` | `calendar event get/update --id` |
-| `processInstanceId` | `oa approval list-*` | `oa approval detail/approve --instance-id` |
-| `openConversationId` | `chat search` | `chat message list/send --group` |
-| `todoTaskId` | `todo task list` | `todo task update/done --task-id` |
-| `reportId` | `report inbox list` / `report outbox list` | `report entry get/stats --report-id` |
-| `baseId` / `tableId` | `aitable base search` | `aitable record query --base-id --table-id` |
-| `dentryUuid` | `drive list` / `drive mkdir` | `drive info/download/copy/move/rename/delete --node`、`drive list/mkdir/upload/copy/move --folder` |
-| `dentryId` | `drive info` 的数字字段 | 仅用于 `chat message send --dentry-id` |
-
-**ID 边界硬约束**：`dentryId` 通常是纯数字，只表示聊天文件消息需要的钉盘条目数字 ID；它不是父目录 ID。遇到 `drive --node/--folder`、`doc --node`、`wiki node --folder` 时，只能使用 `dentryUuid` / `nodeId` / 文档 URL。若当前上下文只有数字型 `dentryId`，必须先重新 `drive list` / `drive search` / `wiki node list` 获取正确 ID，不能把该数字直接代入后续命令。
@@ -1,44 +0,0 @@
-# 业务域通用规范
-
-> 仅服务本 skill 已迁入的行动指南。安全门控、危险操作确认、`--format json` 等已在本 skill 的 `SKILL.md` 中定义，此处不重复。
-
-## 批量查询规范
-
-| # | 规范 |
-|---|------|
-| 1 | **并行查详情**：拿到多个 ID 后，用 `&` 合并到同一条 Shell 命令并行执行 + `wait`，**严禁逐条串行** |
-| 2 | **翻页**：分页接口须拉全直至无更多 |
-| 3 | **优先批量 API**：有批量接口则用批量；无则按 #1 并行 |
-| 4 | **群消息**：必须先 `chat search --query` 得 `openConversationId`，再 `chat message list --group <openConversationId> --time "<yyyy-MM-dd HH:mm:ss>" --direction older`；多群同条命令并行 |
-| 5 | **列表少轮次**：带条件搜索/列表 → 一次采全详情；**禁止**无新参数时重复同一 `list` / `search` |
-
-## 多源并行采集（公共模式）
-
-> recipe 引用方式：`按「多源并行采集」执行（关键词=<X>，时间=<Y>至<Z>）`。
-
- 同条 Shell：`&` 并行 + `wait`；分页须采全。
- 只保留与主题相关的数据，无关丢弃。
- 有批量详情接口优先；否则并行拉详情（见上表 #1）。
- 具体采哪些产品列表由对应 **行动指南 recipe** 与当前产品参考决定；不要引入本文档未覆盖的产品路线。
-
-## 字段术语与 ID 传递
-
-> list 返回 JSON 后，必须提取下表字段传给后续命令。**禁止用其他字段替代。**
-
-| 字段 | 来源 | 传递给 |
-|------|------|--------|
-| `taskUuid` | `minutes list` | `minutes get summary/info/batch --id(s)` |
-| `userId` | `aisearch person` / `contact user search` / `contact dept list-members` | `contact user get --ids`、`todo --executors`、`calendar --users` |
-| `deptId` | `contact dept search` | `contact dept list-members --ids <deptId1,deptId2...>`；多子部门时对每个子部门分别 `dept search` 取 id |
-| `nodeId` | `drive search` / `wiki node search` | `doc read/update --node`、`drive copy/move/rename/delete --node` |
-| `nodeId` | `wiki node list` 中的 folder 类型节点 / `wiki node create --type folder` | `wiki node list --folder`、`wiki node create --folder`、`drive upload --folder`、`drive copy/move --folder` |
-| `eventId` | `calendar event list` | `calendar event get/update --id` |
-| `processInstanceId` | `oa approval list-*` | `oa approval detail/approve --instance-id` |
-| `openConversationId` | `chat search` | `chat message list/send --group` |
-| `todoTaskId` | `todo task list` | `todo task update/done --task-id` |
-| `reportId` | `report inbox list` / `report outbox list` | `report entry get/stats --report-id` |
-| `baseId` / `tableId` | `aitable base search` | `aitable record query --base-id --table-id` |
-| `dentryUuid` | `drive list` / `drive mkdir` | `drive info/download/copy/move/rename/delete --node`、`drive list/mkdir/upload/copy/move --folder` |
-| `dentryId` | `drive info` 的数字字段 | 仅用于 `chat message send --dentry-id` |
-
-**ID 边界硬约束**：`dentryId` 通常是纯数字，只表示聊天文件消息需要的钉盘条目数字 ID；它不是父目录 ID。遇到 `drive --node/--folder`、`doc --node`、`wiki node --folder` 时，只能使用 `dentryUuid` / `nodeId` / 文档 URL。若当前上下文只有数字型 `dentryId`，必须先重新 `drive list` / `drive search` / `wiki node list` 获取正确 ID，不能把该数字直接代入后续命令。
@@ -1,7 +1,7 @@
 # 邮件

 > 邮件的 4 条 **lite** recipe：`mail-list-mailbox`、`mail-search`、`mail-send`、`mail-reply-forward`，见 [lite-recipes.md](./lite-recipes.md)。下列专用规则与消歧请在命中邮件场景且**超出**上述 lite 时阅读本文。
-> 产品命令见 [mail.md](./mail.md)。通用批量/并行见 [_common/conventions.md](_common/conventions.md)。
+> 产品命令见 [mail.md](./mail.md)。通用批量/并行见 [conventions.md](../../dingtalk-shared/references/recipes/shared/conventions.md)。

 ## 专用规则（#9 非 lite 步骤必守）

@@ -1,44 +0,0 @@
-# 业务域通用规范
-
-> 仅服务本 skill 已迁入的行动指南。安全门控、危险操作确认、`--format json` 等已在本 skill 的 `SKILL.md` 中定义，此处不重复。
-
-## 批量查询规范
-
-| # | 规范 |
-|---|------|
-| 1 | **并行查详情**：拿到多个 ID 后，用 `&` 合并到同一条 Shell 命令并行执行 + `wait`，**严禁逐条串行** |
-| 2 | **翻页**：分页接口须拉全直至无更多 |
-| 3 | **优先批量 API**：有批量接口则用批量；无则按 #1 并行 |
-| 4 | **群消息**：必须先 `chat search --query` 得 `openConversationId`，再 `chat message list --group <openConversationId> --time "<yyyy-MM-dd HH:mm:ss>" --direction older`；多群同条命令并行 |
-| 5 | **列表少轮次**：带条件搜索/列表 → 一次采全详情；**禁止**无新参数时重复同一 `list` / `search` |
-
-## 多源并行采集（公共模式）
-
-> recipe 引用方式：`按「多源并行采集」执行（关键词=<X>，时间=<Y>至<Z>）`。
-
- 同条 Shell：`&` 并行 + `wait`；分页须采全。
- 只保留与主题相关的数据，无关丢弃。
- 有批量详情接口优先；否则并行拉详情（见上表 #1）。
- 具体采哪些产品列表由对应 **行动指南 recipe** 与当前产品参考决定；不要引入本文档未覆盖的产品路线。
-
-## 字段术语与 ID 传递
-
-> list 返回 JSON 后，必须提取下表字段传给后续命令。**禁止用其他字段替代。**
-
-| 字段 | 来源 | 传递给 |
-|------|------|--------|
-| `taskUuid` | `minutes list` | `minutes get summary/info/batch --id(s)` |
-| `userId` | `aisearch person` / `contact user search` / `contact dept list-members` | `contact user get --ids`、`todo --executors`、`calendar --users` |
-| `deptId` | `contact dept search` | `contact dept list-members --ids <deptId1,deptId2...>`；多子部门时对每个子部门分别 `dept search` 取 id |
-| `nodeId` | `drive search` / `wiki node search` | `doc read/update --node`、`drive copy/move/rename/delete --node` |
-| `nodeId` | `wiki node list` 中的 folder 类型节点 / `wiki node create --type folder` | `wiki node list --folder`、`wiki node create --folder`、`drive upload --folder`、`drive copy/move --folder` |
-| `eventId` | `calendar event list` | `calendar event get/update --id` |
-| `processInstanceId` | `oa approval list-*` | `oa approval detail/approve --instance-id` |
-| `openConversationId` | `chat search` | `chat message list/send --group` |
-| `todoTaskId` | `todo task list` | `todo task update/done --task-id` |
-| `reportId` | `report inbox list` / `report outbox list` | `report entry get/stats --report-id` |
-| `baseId` / `tableId` | `aitable base search` | `aitable record query --base-id --table-id` |
-| `dentryUuid` | `drive list` / `drive mkdir` | `drive info/download/copy/move/rename/delete --node`、`drive list/mkdir/upload/copy/move --folder` |
-| `dentryId` | `drive info` 的数字字段 | 仅用于 `chat message send --dentry-id` |
-
-**ID 边界硬约束**：`dentryId` 通常是纯数字，只表示聊天文件消息需要的钉盘条目数字 ID；它不是父目录 ID。遇到 `drive --node/--folder`、`doc --node`、`wiki node --folder` 时，只能使用 `dentryUuid` / `nodeId` / 文档 URL。若当前上下文只有数字型 `dentryId`，必须先重新 `drive list` / `drive search` / `wiki node list` 获取正确 ID，不能把该数字直接代入后续命令。
@@ -27,7 +27,7 @@ dws minutes list mine --limit 5 --format json

 | Recipe           | 行动指南（固定路线）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | ---------------- |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| meeting-followup | 1. **提取待办优先**：`python scripts/minutes_extract_todos.py [--id <taskUuid>] [--limit N]` → 获取行动项列表 无脚本时按[「多源并行采集」](_common/conventions.md#多源并行采集公共模式)执行 2. 提取行动项 3. `aisearch person --keyword "<姓名>" --dimension name` → 取 `userId` → `todo task create --title "<行动项>" --executors <userId> --priority <10/20/30/40>`（每条行动项；批量时切到 `dingtalk-todo` 的 batch-create-todo recipe，批量脚本只在该 sub-skill 内可用） 4. `chat message send --group <openConversationId> --text "<通知内容>"` 通知已创建                                                                                                                                                                                         |
+| meeting-followup | 1. **提取待办优先**：`python scripts/minutes_extract_todos.py [--id <taskUuid>] [--limit N]` → 获取行动项列表 无脚本时按[「多源并行采集」](../../dingtalk-shared/references/recipes/shared/conventions.md#多源并行采集公共模式)执行 2. 提取行动项 3. `aisearch person --keyword "<姓名>" --dimension name` → 取 `userId` → `todo task create --title "<行动项>" --executors <userId> --priority <10/20/30/40>`（每条行动项；批量时切到 `dingtalk-todo` 的 batch-create-todo recipe，批量脚本只在该 sub-skill 内可用） 4. `chat message send --group <openConversationId> --text "<通知内容>"` 通知已创建                                                                                                                                                                                         |
 | share-minutes    | **拉摘要优先**：`python scripts/minutes_recent_summary.py [--limit N] [--output summary.md]` → 获取近期听记摘要 备选手动：1. `minutes list mine` → 取 `taskUuid` 2. 用户选定 3. `minutes get summary --id <taskUuid>` → 取摘要 4. 单聊：`aisearch person --keyword "<姓名>" --dimension name` → 取 `openDingTalkId` → `chat message send --open-dingtalk-id <openDingTalkId> --text "<摘要内容>"`（推荐）；群聊：`--group <openConversationId> --text "<摘要内容>"` 发送。仅当无法获取 openDingTalkId 时才用 `--user <userId>`（备选）                                                                                                                                                                                |
 | browse-minutes   | 1. `minutes list all --query "<关键词>" --limit <N>` → 取全量 `taskUuid`（翻页直至无更多；无主题筛选用 `minutes list mine`；**有时间范围时加 `--start`/`--end` 服务端过滤**，如 `--start "2026-04-01T00:00:00+08:00" --end "2026-04-30T23:59:59+08:00"`） 2. **详情/元数据优先** `minutes get batch --ids <uuid1,uuid2,...>`（仅 API 上限时拆多批）；**摘要专项**且无 batch 字段时再用并行 `get summary` 或 `**python scripts/minutes_recent_summary.py --limit <N>`** 3. 汇总展示；**同一用户诉求下避免**「半截 list → 再 list 剩余」「拆 4 条一批 summary 连跑多轮」等无必要拆分                                                                                                                                                             |
 | minutes-raw-export | 适用"下载/导出最近一周听记原文/逐字稿/转写内容/完整记录"：1. 按用户时间词计算 `--start` / `--end`（最近一周示例：7 天前 00:00:00+08:00 到今天 23:59:59+08:00） 2. `minutes list all --start "<ISO>" --end "<ISO>" --format json` 获取范围内所有可见听记；为空时直接说明无相关数据 3. 对列表中每个 `taskUuid` 逐一 `minutes get transcription --id <taskUuid> --format json`，如返回 `cursor` / `nextToken` / `nextCursor`，继续用 `--cursor <token>` 拉完后续页 4. 交付文件或最终回复必须包含各听记的真实转写段落，可附标题/时间/组织，禁止只交 summary 或让用户再选某一条 |
@@ -1,44 +0,0 @@
-# 业务域通用规范
-
-> 仅服务本 skill 已迁入的行动指南。安全门控、危险操作确认、`--format json` 等已在本 skill 的 `SKILL.md` 中定义，此处不重复。
-
-## 批量查询规范
-
-| # | 规范 |
-|---|------|
-| 1 | **并行查详情**：拿到多个 ID 后，用 `&` 合并到同一条 Shell 命令并行执行 + `wait`，**严禁逐条串行** |
-| 2 | **翻页**：分页接口须拉全直至无更多 |
-| 3 | **优先批量 API**：有批量接口则用批量；无则按 #1 并行 |
-| 4 | **群消息**：必须先 `chat search --query` 得 `openConversationId`，再 `chat message list --group <openConversationId> --time "<yyyy-MM-dd HH:mm:ss>" --direction older`；多群同条命令并行 |
-| 5 | **列表少轮次**：带条件搜索/列表 → 一次采全详情；**禁止**无新参数时重复同一 `list` / `search` |
-
-## 多源并行采集（公共模式）
-
-> recipe 引用方式：`按「多源并行采集」执行（关键词=<X>，时间=<Y>至<Z>）`。
-
- 同条 Shell：`&` 并行 + `wait`；分页须采全。
- 只保留与主题相关的数据，无关丢弃。
- 有批量详情接口优先；否则并行拉详情（见上表 #1）。
- 具体采哪些产品列表由对应 **行动指南 recipe** 与当前产品参考决定；不要引入本文档未覆盖的产品路线。
-
-## 字段术语与 ID 传递
-
-> list 返回 JSON 后，必须提取下表字段传给后续命令。**禁止用其他字段替代。**
-
-| 字段 | 来源 | 传递给 |
-|------|------|--------|
-| `taskUuid` | `minutes list` | `minutes get summary/info/batch --id(s)` |
-| `userId` | `aisearch person` / `contact user search` / `contact dept list-members` | `contact user get --ids`、`todo --executors`、`calendar --users` |
-| `deptId` | `contact dept search` | `contact dept list-members --ids <deptId1,deptId2...>`；多子部门时对每个子部门分别 `dept search` 取 id |
-| `nodeId` | `drive search` / `wiki node search` | `doc read/update --node`、`drive copy/move/rename/delete --node` |
-| `nodeId` | `wiki node list` 中的 folder 类型节点 / `wiki node create --type folder` | `wiki node list --folder`、`wiki node create --folder`、`drive upload --folder`、`drive copy/move --folder` |
-| `eventId` | `calendar event list` | `calendar event get/update --id` |
-| `processInstanceId` | `oa approval list-*` | `oa approval detail/approve --instance-id` |
-| `openConversationId` | `chat search` | `chat message list/send --group` |
-| `todoTaskId` | `todo task list` | `todo task update/done --task-id` |
-| `reportId` | `report inbox list` / `report outbox list` | `report entry get/stats --report-id` |
-| `baseId` / `tableId` | `aitable base search` | `aitable record query --base-id --table-id` |
-| `dentryUuid` | `drive list` / `drive mkdir` | `drive info/download/copy/move/rename/delete --node`、`drive list/mkdir/upload/copy/move --folder` |
-| `dentryId` | `drive info` 的数字字段 | 仅用于 `chat message send --dentry-id` |
-
-**ID 边界硬约束**：`dentryId` 通常是纯数字，只表示聊天文件消息需要的钉盘条目数字 ID；它不是父目录 ID。遇到 `drive --node/--folder`、`doc --node`、`wiki node --folder` 时，只能使用 `dentryUuid` / `nodeId` / 文档 URL。若当前上下文只有数字型 `dentryId`，必须先重新 `drive list` / `drive search` / `wiki node list` 获取正确 ID，不能把该数字直接代入后续命令。
@@ -45,8 +45,8 @@ metadata:
 | `confirmation_required` / 写操作确认 | [confirmation.md](references/confirmation.md) |
 | 命令发现、Schema / `--compact` / `--all` | [schema-usage.md](references/schema-usage.md) |
 | 怀疑能力不支持 | [capability-limits.md](references/capability-limits.md) |
-| 批量/多源采集 | [conventions.md](references/best_practices/_common/conventions.md) |
-| 固定短流程 | [lite-recipes.md](references/best_practices/_common/lite-recipes.md) 对应章节 |
+| 批量/多源采集 | [conventions.md](references/recipes/shared/conventions.md) |
+| 固定短流程 | [lite-catalog.md](references/recipes/lite-catalog.md) 对应章节 |

 产品命令、脚本和字段细节位于对应产品 skill，不在 `dingtalk-shared` 重复维护。

@@ -1,7 +1,7 @@
 # 通用规范

 > full recipe 执行时的共享规范。安全门控、危险操作确认、`--format json` 等已在根 [SKILL.md](../../../SKILL.md) 中定义，此处不重复。
-> Recipe 元规范（YAML frontmatter、命名、三层架构）见 [recipe-conventions.md](recipe-conventions.md)。
+> Recipe 元规范（YAML frontmatter、命名、三层架构）见 [meta.md](meta.md)。

 ## 批量查询规范

@@ -27,9 +27,9 @@ skill 完成。
 ## Lite 与 Full

 - 单一目标、短链路、无多源汇总：在
-  [lite-recipes.md](best_practices/_common/lite-recipes.md) 中只读取对应 recipe。
+  [lite-catalog.md](recipes/lite-catalog.md) 中只读取对应 recipe。
 - 涉及多源采集、批量处理、交叉分析、汇总/归纳或三个以上产品：使用上表的完整
-  行动指南，并按 [conventions.md](best_practices/_common/conventions.md) 执行批量和
+  行动指南，并按 [conventions.md](recipes/shared/conventions.md) 执行批量和
  ID 传递规则。
 - 产品 skill 已内联完整步骤时，直接执行其步骤，不再重复读取通用 recipe。

@@ -14,6 +14,6 @@

 | Recipe | 行动指南（固定路线）                                                                                                                                                                                                                                                                                                                                                                                    |
 |--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| generate-progress-report | 1. 按[「多源并行采集」](_common/conventions.md#多源并行采集公共模式)执行<br>2. 交叉比对各源数据<br>3. `doc create --name "<报告名>" --content "<报告内容>"`                                                                                                                                                                                                                                                                    |
-| batch-create-todo | 1. 按[「多源并行采集」](_common/conventions.md#多源并行采集公共模式)执行 → 从结果提取任务条目<br>2. 每条：`aisearch person --keyword "<姓名>" --dimension name` → 取真实 `userId`；同名时先消歧<br>3. 逐条执行 `todo task create --title "<标题>" --executors <userId> --priority <10/20/30/40>`，从每次响应收集真实 `todoTaskId`；单批超 30 条须用户确认<br>4. 对全部 `todoTaskId` 并行执行 `todo task get --task-id <todoTaskId>`，逐项核对标题、执行者、优先级和截止时间；不能只以退出码或创建响应作为成功证据 |
+| generate-progress-report | 1. 按[「多源并行采集」](../../dingtalk-shared/references/recipes/shared/conventions.md#多源并行采集公共模式)执行<br>2. 交叉比对各源数据<br>3. `doc create --name "<报告名>" --content "<报告内容>"`                                                                                                                                                                                                                                                                    |
+| batch-create-todo | 1. 按[「多源并行采集」](../../dingtalk-shared/references/recipes/shared/conventions.md#多源并行采集公共模式)执行 → 从结果提取任务条目<br>2. 每条：`aisearch person --keyword "<姓名>" --dimension name` → 取真实 `userId`；同名时先消歧<br>3. 逐条执行 `todo task create --title "<标题>" --executors <userId> --priority <10/20/30/40>`，从每次响应收集真实 `todoTaskId`；单批超 30 条须用户确认<br>4. 对全部 `todoTaskId` 并行执行 `todo task get --task-id <todoTaskId>`，逐项核对标题、执行者、优先级和截止时间；不能只以退出码或创建响应作为成功证据 |
 | assign-and-notify | 1. `aisearch person --keyword "<姓名>" --dimension name` → 取 `userId`<br>2. `todo task create --title "<标题>" --executors <userId> --priority <10/20/30/40>` → 取 `todoTaskId`<br>3. `todo task get --task-id <todoTaskId>` 回读任务，确认无误后再通知<br>4. `chat search --query "<群名>"` → 取 `openConversationId` → `chat message send --group <openConversationId> --text "<通知内容>"` |
@@ -1,44 +0,0 @@
-# 业务域通用规范
-
-> 仅服务本 skill 已迁入的行动指南。安全门控、危险操作确认、`--format json` 等已在本 skill 的 `SKILL.md` 中定义，此处不重复。
-
-## 批量查询规范
-
-| # | 规范 |
-|---|------|
-| 1 | **并行查详情**：拿到多个 ID 后，用 `&` 合并到同一条 Shell 命令并行执行 + `wait`，**严禁逐条串行** |
-| 2 | **翻页**：分页接口须拉全直至无更多 |
-| 3 | **优先批量 API**：有批量接口则用批量；无则按 #1 并行 |
-| 4 | **群消息**：必须先 `chat search --query` 得 `openConversationId`，再 `chat message list --group <openConversationId> --time "<yyyy-MM-dd HH:mm:ss>" --direction older`；多群同条命令并行 |
-| 5 | **列表少轮次**：带条件搜索/列表 → 一次采全详情；**禁止**无新参数时重复同一 `list` / `search` |
-
-## 多源并行采集（公共模式）
-
-> recipe 引用方式：`按「多源并行采集」执行（关键词=<X>，时间=<Y>至<Z>）`。
-
- 同条 Shell：`&` 并行 + `wait`；分页须采全。
- 只保留与主题相关的数据，无关丢弃。
- 有批量详情接口优先；否则并行拉详情（见上表 #1）。
- 具体采哪些产品列表由对应 **行动指南 recipe** 与当前产品参考决定；不要引入本文档未覆盖的产品路线。
-
-## 字段术语与 ID 传递
-
-> list 返回 JSON 后，必须提取下表字段传给后续命令。**禁止用其他字段替代。**
-
-| 字段 | 来源 | 传递给 |
-|------|------|--------|
-| `taskUuid` | `minutes list` | `minutes get summary/info/batch --id(s)` |
-| `userId` | `aisearch person` / `contact user search` / `contact dept list-members` | `contact user get --ids`、`todo --executors`、`calendar --users` |
-| `deptId` | `contact dept search` | `contact dept list-members --ids <deptId1,deptId2...>`；多子部门时对每个子部门分别 `dept search` 取 id |
-| `nodeId` | `drive search` / `wiki node search` | `doc read/update --node`、`drive copy/move/rename/delete --node` |
-| `nodeId` | `wiki node list` 中的 folder 类型节点 / `wiki node create --type folder` | `wiki node list --folder`、`wiki node create --folder`、`drive upload --folder`、`drive copy/move --folder` |
-| `eventId` | `calendar event list` | `calendar event get/update --id` |
-| `processInstanceId` | `oa approval list-*` | `oa approval detail/approve --instance-id` |
-| `openConversationId` | `chat search` | `chat message list/send --group` |
-| `todoTaskId` | `todo task list` | `todo task update/done --task-id` |
-| `reportId` | `report inbox list` / `report outbox list` | `report entry get/stats --report-id` |
-| `baseId` / `tableId` | `aitable base search` | `aitable record query --base-id --table-id` |
-| `dentryUuid` | `drive list` / `drive mkdir` | `drive info/download/copy/move/rename/delete --node`、`drive list/mkdir/upload/copy/move --folder` |
-| `dentryId` | `drive info` 的数字字段 | 仅用于 `chat message send --dentry-id` |
-
-**ID 边界硬约束**：`dentryId` 通常是纯数字，只表示聊天文件消息需要的钉盘条目数字 ID；它不是父目录 ID。遇到 `drive --node/--folder`、`doc --node`、`wiki node --folder` 时，只能使用 `dentryUuid` / `nodeId` / 文档 URL。若当前上下文只有数字型 `dentryId`，必须先重新 `drive list` / `drive search` / `wiki node list` 获取正确 ID，不能把该数字直接代入后续命令。
@@ -23,7 +23,7 @@ import "embed"
 // into the binary. Retired build-only inputs (for example the former
 // internal/cli/schema_hints tree) must stay absent from this embed. The `all:`
 // prefix is required so dot/underscore entries — e.g.
-// references/best_practices/_common — are included rather than skipped.
+// dingtalk-shared/references/recipes/shared — are included rather than skipped.
 //
 //go:embed all:skills/mono all:skills/multi
 var EmbeddedSkills embed.FS