drop recipes/shared intermediate dir under multi skills
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
玉澜
@@ -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`、`recipes/`（shared 层：`recipes/shared/`、`recipes/lite-catalog.md`） |
|
||||
| 与 mono 全局文同名迁移 | `error-codes`、`url-patterns`、`capability-limits`、`channel-login`、`global-reference`、`recipes/`（`conventions.md`、`meta.md`、`lite-catalog.md`） |
|
||||
|
||||
产品专属规则（如 AI 表格 `field-rules`）允许下沉到对应 `dingtalk-*`，须在覆盖表注明。
|
||||
|
||||
|
||||
+1
-1
@@ -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,
|
||||
// dingtalk-shared/references/recipes/shared) that plain embed patterns would skip.
|
||||
// mono/references/best_practices/_common) 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. 按[「多源并行采集」](recipes/shared/conventions.md#多源并行采集公共模式)执行 → 补充背景<br>3. `doc create --name "<报告名>" --content "<分析报告>"` |
|
||||
| generate-data-report | 1. 同 read-aitable 步骤 1-3<br>2. 按[「多源并行采集」](recipes/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,7 +1,7 @@
|
||||
# 通讯录（组织架构）
|
||||
|
||||
> **SKILL.md** 中 #8 内联 3 条 **lite**：`get-contact-self`、`search-person`、`search-user`。下列 recipe、专用规则与消歧请在命中 #8 且**超出**上述 lite 时阅读本文。
|
||||
> 产品命令见 [contact.md](./contact.md)。通用批量/并行见 [recipes/shared/conventions.md](recipes/shared/conventions.md)。
|
||||
> 产品命令见 [contact.md](./contact.md)。通用批量/并行见 [recipes/conventions.md](recipes/conventions.md)。
|
||||
|
||||
## 专用规则（#8 非 lite 步骤必守）
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
3. 将「姓名 + 部门 + 职位」列表展示给用户，请用户确认选择哪一位
|
||||
4. 使用用户确认的 `userId` 继续后续操作
|
||||
> **根因**：`aisearch person` 不返回完整部门信息，无法仅凭搜索结果区分同名用户。**必须**追加 `contact user get` 获取部门信息才能消歧。
|
||||
- **批量**：多个 `userId` 用 `contact user get --ids id1,id2,...`；多部门成员列表按需并行，遵守单次批量上限与 [recipes/shared/conventions.md](recipes/shared/conventions.md)。
|
||||
- **批量**：多个 `userId` 用 `contact user get --ids id1,id2,...`；多部门成员列表按需并行，遵守单次批量上限与 [recipes/conventions.md](recipes/conventions.md)。
|
||||
- **子部门枚举**：已知父部门 `deptId` 时**优先** `contact dept list-children --dept <父deptId>` 直接拿到完整子部门列表；只知道部门名时先 `contact dept search --query "<父部门名>"` 取 `deptId` 再 `list-children`；用户明示的子部门名（无需枚举）可直接 `dept search` 命中。多子部门展开见 `explore-subdepts-and-members`。
|
||||
|
||||
## 与其他场景消歧
|
||||
|
||||
@@ -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)。通用批量/并行见 [recipes/shared/conventions.md](recipes/shared/conventions.md)。
|
||||
> 产品命令见 [mail.md](./mail.md)。通用批量/并行见 [recipes/conventions.md](recipes/conventions.md)。
|
||||
|
||||
## 专用规则（#9 非 lite 步骤必守）
|
||||
|
||||
|
||||
@@ -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]` → 获取行动项列表 无脚本时按[「多源并行采集」](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 "<通知内容>"` 通知已创建 |
|
||||
| meeting-followup | 1. **提取待办优先**：`python scripts/minutes_extract_todos.py [--id <taskUuid>] [--limit N]` → 获取行动项列表 无脚本时按[「多源并行采集」](recipes/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 或让用户再选某一条 |
|
||||
|
||||
@@ -45,7 +45,7 @@ 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/recipes/shared/conventions.md) |
|
||||
| 批量/多源采集 | [conventions.md](references/recipes/conventions.md) |
|
||||
| 固定短流程 | [lite-catalog.md](references/recipes/lite-catalog.md) 对应章节 |
|
||||
|
||||
产品命令、脚本和字段细节位于对应产品 skill，不在 `dingtalk-shared` 重复维护。
|
||||
|
||||
@@ -29,7 +29,7 @@ skill 完成。
|
||||
- 单一目标、短链路、无多源汇总：在
|
||||
[lite-catalog.md](recipes/lite-catalog.md) 中只读取对应 recipe。
|
||||
- 涉及多源采集、批量处理、交叉分析、汇总/归纳或三个以上产品：使用上表的完整
|
||||
行动指南，并按 [conventions.md](recipes/shared/conventions.md) 执行批量和
|
||||
行动指南，并按 [conventions.md](recipes/conventions.md) 执行批量和
|
||||
ID 传递规则。
|
||||
- 产品 skill 已内联完整步骤时，直接执行其步骤，不再重复读取通用 recipe。
|
||||
|
||||
|
||||
@@ -14,6 +14,6 @@
|
||||
|
||||
| Recipe | 行动指南（固定路线） |
|
||||
|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| generate-progress-report | 1. 按[「多源并行采集」](recipes/shared/conventions.md#多源并行采集公共模式)执行<br>2. 交叉比对各源数据<br>3. `doc create --name "<报告名>" --content "<报告内容>"` |
|
||||
| batch-create-todo | 1. 按[「多源并行采集」](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>`，逐项核对标题、执行者、优先级和截止时间；不能只以退出码或创建响应作为成功证据 |
|
||||
| generate-progress-report | 1. 按[「多源并行采集」](recipes/conventions.md#多源并行采集公共模式)执行<br>2. 交叉比对各源数据<br>3. `doc create --name "<报告名>" --content "<报告内容>"` |
|
||||
| batch-create-todo | 1. 按[「多源并行采集」](recipes/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
-1
@@ -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.
|
||||
// dingtalk-shared/references/recipes/shared — are included rather than skipped.
|
||||
// mono/references/best_practices/_common — are included rather than skipped.
|
||||
//
|
||||
//go:embed all:skills/mono all:skills/multi
|
||||
var EmbeddedSkills embed.FS
|
||||
|
||||
Reference in New Issue
Block a user