diff --git a/skills/lark-vc-agent/SKILL.md b/skills/lark-vc-agent/SKILL.md index 0b709e998..7ca530cbd 100644 --- a/skills/lark-vc-agent/SKILL.md +++ b/skills/lark-vc-agent/SKILL.md @@ -40,7 +40,7 @@ metadata: 4. 入会对所有参会人可见，执行前核实 9 位会议号来源，避免误入错会。 5. 仅支持 `user` 身份，需提前 `lark-cli auth login` 并拥有 `vc:meeting.bot.join:write` scope。 6. 若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。 -7. 若提示 `missing required scope(s)` / `permission_violations`，只按原逻辑提示 `lark-cli auth login --scope "vc:meeting.bot.join:write"`，不要混入早鸟群文案。 +7. 若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 提示执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"` 补授权。 8. 若入会失败，优先查看 `+meeting-join` reference 的错误排查段落，重点确认会议号、密码、会议状态、等候室 / 审批以及会议是否禁止当前身份加入。 ### 2. 感知会中事件（读操作） @@ -58,7 +58,7 @@ metadata: 8. 保留响应里的 `page_token`，下次增量拉取直接续，不要从头再拉。 9. **只要你是基于 `+meeting-events` 来回答一场正在进行中的会议内容，就不能直接复用旧结果。** 无论用户是在问“现在/刚刚/最新”的状态，还是让你“总结一下这个会议讲什么”，都必须先重新拉一次当前事件流，确认拿到的是最新信息，再基于最新结果回答。只有在用户明确要求基于某次历史快照继续分析时，才可以复用旧结果。 10. 若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。 -11. 若提示 `missing required scope(s)` / `permission_violations`，只按原逻辑提示 `lark-cli auth login --scope "vc:meeting.meetingevent:read"`，不要混入早鸟群文案。 +11. 若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 提示执行 `lark-cli auth login --scope "vc:meeting.meetingevent:read"` 补授权。 ### 3. 离开会议（写操作） @@ -67,7 +67,7 @@ metadata: 3. 离会**立即生效**，机器人从会议的参会人列表中消失，对其他参会人可见；若需要重新入会，再跑一次 `+meeting-join` 即可（非真正"不可逆"）。 4. 仅支持 `user` 身份，scope 同 `+meeting-join`（`vc:meeting.bot.join:write`）。 5. 若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。 -6. 若提示 `missing required scope(s)` / `permission_violations`，只按原逻辑提示 `lark-cli auth login --scope "vc:meeting.bot.join:write"`，不要混入早鸟群文案。 +6. 若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 提示执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"` 补授权。 ### 4. Agent 参会最小闭环示范 diff --git a/skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md b/skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md index 204f19477..dedc5e134 100644 --- a/skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md +++ b/skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md @@ -52,7 +52,7 @@ lark-cli vc +meeting-events --meeting-id 69xxxxxxxxxxxxx28 --dry-run ### 2. 仅支持 user 身份 该命令仅支持 `user` 身份，使用前需完成 `lark-cli auth login`。 -若提示 `missing required scope(s)` / `permission_violations`，只按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.meetingevent:read"`，不要混入早鸟群文案。 +若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.meetingevent:read"`。 若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。暂不展示使用手册。 @@ -229,7 +229,7 @@ lark-cli vc +meeting-events \ | `20002 meeting not exist` | `meeting_id` 错误，或会议实例当前已不可获取（常见于把 9 位会议号当 meeting_id 传） | 确认传入的是长数字 `meeting_id`，不是 9 位会议号 | | `HTTP 404` / `HTTP 500` | 服务端当前无法找到或处理该会议实例 | 换一个正在进行且 bot 可见的 meeting_id，或排查后端问题 | | `error.code=20017` / `ErrNotInGray` | 当前用户未命中智能体参会灰度 | 提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd | -| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.meetingevent:read` | 只按 CLI hint 重新 `auth login --scope vc:meeting.meetingevent:read` 补 scope，不要混入早鸟群文案 | +| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.meetingevent:read` | 先提示用户加入早鸟群申请智能体参会灰度：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 重新 `auth login --scope vc:meeting.meetingevent:read` 补 scope | ## 提示 diff --git a/skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md b/skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md index 1d6973fe7..cd25ad306 100644 --- a/skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md +++ b/skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md @@ -36,7 +36,7 @@ lark-cli vc +meeting-join --meeting-number 123456789 --dry-run ### 1. 仅支持 user 身份 -该命令仅支持 `user` 身份，使用前需完成 `lark-cli auth login`。若提示 `missing required scope(s)` / `permission_violations`，只按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"`，不要混入早鸟群文案。 +该命令仅支持 `user` 身份，使用前需完成 `lark-cli auth login`。若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"`。 > **灰度提示：** 若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。暂不展示使用手册。 @@ -113,7 +113,7 @@ lark-cli vc +notes --meeting-ids |---------|---------|---------| | `--meeting-number must be exactly 9 digits` | 会议号不是 9 位纯数字 | 检查是否误传了会议链接或 meeting_id | | `error.code=20017` / `ErrNotInGray` | 当前用户未命中智能体参会灰度 | 提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd | -| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.bot.join:write` | 只按 CLI hint 运行 `auth login --scope vc:meeting.bot.join:write` 完成授权，不要混入早鸟群文案 | +| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.bot.join:write` | 先提示用户加入早鸟群申请智能体参会灰度：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 运行 `auth login --scope vc:meeting.bot.join:write` 完成授权 | | 会议密码错误 | `--password` 错误或未提供 | 向主持人确认会议密码 | | 会议不存在 / 已结束 | 会议号错误或会议未进行中 | 确认会议正在进行中 | | `HTTP 403: no permission` / `121003` | 入会前置条件不满足，通常不是单纯 scope 问题 | 依次确认：1）会议允许智能体加入；2）会议号正确；3）如有密码，已正确传入 `--password`；4）会议已开始；5）等候室 / 入会审批已放行；6）会议未禁止当前身份加入（如限制外部、限制 bot、仅特定成员可入会）；确认后重试 | diff --git a/skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md b/skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md index 80c95d302..d076b59bb 100644 --- a/skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md +++ b/skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md @@ -37,7 +37,7 @@ lark-cli vc +meeting-leave --meeting-id 69xxxxxxxxxxxxx28 --dry-run ### 2. 仅支持 user 身份 该命令仅支持 `user` 身份，使用前需完成 `lark-cli auth login`。只能让当前身份自己离会，无法强制移出其他参会人。 -若提示 `missing required scope(s)` / `permission_violations`，只按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"`，不要混入早鸟群文案。 +若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"`。 若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。暂不展示使用手册。 @@ -96,7 +96,7 @@ lark-cli vc +notes --meeting-ids | `meeting not found` / `invalid meeting_id` | 误传了 9 位会议号 | 必须使用 `meeting.id`，不是会议号 | | `not in meeting` | 当前身份并不在该会议中 | 确认先 `+meeting-join` 成功 | | `error.code=20017` / `ErrNotInGray` | 当前用户未命中智能体参会灰度 | 提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd | -| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.bot.join:write` | 只按 CLI hint 运行 `auth login --scope vc:meeting.bot.join:write` 完成授权，不要混入早鸟群文案 | +| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.bot.join:write` | 先提示用户加入早鸟群申请智能体参会灰度：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 运行 `auth login --scope vc:meeting.bot.join:write` 完成授权 | ## 提示