CtrlK
BlogDocsLog inGet started
Tessl Logo

enterprise-workflow

企业 IM 工作流自动化:文档、表格、待办/任务、会议/日程一键创建。 Use when: operator要求创建企微/飞书的文档/表格/待办/会议/日程/幻灯片,或"一句话生成完整工作流"。 Not for: 普通聊天、消息收发(那是 F088 Transport Plane 的活)。 Output: 资源链接(文档 URL、企微会议链接、日程 summary 等)通过 callback 返回。

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Enterprise Workflow — 企业 IM 工作流自动化

F162:通过厂商官方 CLI 驱动企业操作。 架构决策:ADR-029 — ActionService + CliExecutor + callback route。

两条腿并行:

  • Phase A(企业微信)wecom-cli(Rust)→ callback /api/callbacks/wecom-action
  • Phase B(飞书/Lark)lark-cli(Go,@larksuite/cli)→ callback /api/callbacks/lark-action

如何选平台

operator提到用哪边
企微 / wecom / 企业微信 / 腾讯 IMWeCom (/api/callbacks/wecom-action)
飞书 / feishu / lark / 字节 IMLark (/api/callbacks/lark-action)
只说"企业 IM"没指定先问一句哪个平台;demo 场景默认 WeCom

所有操作都必须走 callback route,不要裸调 CLI(ADR-029 Decision 2)。

POST /api/callbacks/{wecom|lark}-action
Content-Type: application/json

{
  "invocationId": "<your invocationId>",
  "callbackToken": "<your callbackToken>",
  "action": "<action_name>",
  ...action-specific params
}

🟩 WeCom(企业微信)能力

操作action说明
创建文档create_docMarkdown 文档
创建智能表格create_smart_table自定义字段 + 数据行
创建待办create_todo分发给指定人员
创建会议create_meeting预约会议,自动邀请
黄金链路golden_chain一句话 → 文档 + 表格 + 待办 + 会议

WeCom golden_chain 示例

{
  "action": "golden_chain",
  "docName": "Q2 产品 PRD",
  "docContent": "# Q2 产品规划\n...",
  "tableName": "Q2 任务跟踪表",
  "tasks": [
    { "content": "完成 API 设计", "assigneeUserId": "zhangsan", "remindTime": "2026-04-20 09:00:00" }
  ],
  "meetingTitle": "Q2 PRD 评审会",
  "meetingStart": "2026-04-20 14:00",
  "meetingDurationSeconds": 3600,
  "meetingInviteeUserIds": ["zhangsan", "lisi"]
}

WeCom 单独操作

// create_doc
{ "action": "create_doc", "docName": "会议纪要", "content": "..." }

// create_smart_table
{
  "action": "create_smart_table",
  "tableName": "Bug 跟踪表",
  "fields": [
    { "fieldTitle": "Bug", "fieldType": "FIELD_TYPE_TEXT" },
    { "fieldTitle": "优先级", "fieldType": "FIELD_TYPE_SINGLE_SELECT" }
  ],
  "records": [{ "Bug": "登录超时", "优先级": "P1" }]
}

// create_todo
{ "action": "create_todo", "content": "Review PRD", "followerUserIds": ["zhangsan"], "remindTime": "2026-04-20 09:00:00" }

// create_meeting
{ "action": "create_meeting", "title": "评审", "startDatetime": "2026-04-20 14:00", "durationSeconds": 3600, "inviteeUserIds": ["zhangsan"] }

🟦 Lark(飞书)能力

操作action说明
创建文档create_docMarkdown 飞书文档(docx)
创建多维表create_baseBitable 多维表格 app
创建任务create_task任务 v2,支持 assignee + due
创建日程create_calendar_eventCalendar 事件(lark-cli v1.x 不暴露 VC/meeting URL;需要会议链接时另用 vc +create
创建幻灯片create_slides飞书专属 — 企微 demo 没有
黄金链路golden_chain一句话 → 文档 + 多维表 + 任务 + 日程(+ 可选幻灯片)

Lark 的 assignee 用 open_idou_xxx),日历参会人支持 ou_xxx(用户)、oc_xxx(群)、omm_xxx(会议室)。

Lark golden_chain 示例

{
  "action": "golden_chain",
  "docTitle": "Q2 产品 PRD",
  "docMarkdown": "# Q2 产品规划\n...",
  "baseName": "Q2 任务跟踪表",
  "tasks": [
    { "summary": "完成 API 设计", "assigneeOpenId": "ou_xxx", "due": "+3d" }
  ],
  "calendarSummary": "Q2 PRD 评审会",
  "calendarStart": "2026-04-20T14:00:00+08:00",
  "calendarEnd": "2026-04-20T15:00:00+08:00",
  "calendarAttendeeOpenIds": ["ou_xxx", "ou_yyy"],
  "includeSlides": true
}

Lark 单独操作

// create_doc
{ "action": "create_doc", "title": "会议纪要", "markdown": "# 纪要\n..." }

// create_base(多维表)
{ "action": "create_base", "name": "Bug 跟踪表", "timeZone": "Asia/Shanghai" }

// create_task
{ "action": "create_task", "summary": "Review PRD", "assigneeOpenId": "ou_xxx", "due": "2026-04-20" }

// create_calendar_event
{
  "action": "create_calendar_event",
  "summary": "评审",
  "start": "2026-04-20T14:00:00+08:00",
  "end": "2026-04-20T15:00:00+08:00",
  "attendeeOpenIds": ["ou_xxx"]
}

// create_slides(飞书专属)
{ "action": "create_slides", "title": "Q2 Deck" }

回贴格式(两边通用)

拿到 callback 返回的链接后,组织成简洁回复:

WeCom

已完成工作流创建:

📄 文档: Q2 产品 PRD — https://doc.weixin.qq.com/xxx
📊 表格: Q2 任务跟踪表 — https://doc.weixin.qq.com/yyy
✅ 待办: 2 条已分发(张三、李四)
🎥 会议: Q2 PRD 评审会 — https://meeting.tencent.com/dm/zzz

Lark

已完成工作流创建:

📄 文档: Q2 产品 PRD — https://feishu.cn/docx/xxx
📊 多维表: Q2 任务跟踪表 — https://feishu.cn/base/yyy
✅ 任务: 2 条已分发
🗓 日程: Q2 PRD 评审会(开始 2026-04-20 14:00)
🎞 幻灯片: Q2 Deck — https://feishu.cn/slides/www

取用户 ID

  • WeCom:如果不知道 userId,先让 Hub 查通讯录(走 TypeScript import,不走 callback)。demo 场景下用operator自己的 userId。
  • LarksearchUsers 需要 contact:contact.search 授权;没授权就优先拿已知 open_id,或operator自己的。

注意事项

  • 权限:需要对应应用有 API 权限(文档/表格/待办/会议/通讯录)
  • ≤10 人企业限制(WeCom):部分功能可能受限,遇到降级处理
  • 错误码
    • 502 { error: "..., code, msg }:厂商 API 报错
    • 503 { error: "<cli> unavailable" }:CLI 未安装或未登录
  • 不要裸调 CLI:审计链会断裂(ADR-029 Decision 2)
  • 飞书黄金链路比企微多一层 Slides(飞书专属),展示时可强调此差异
Repository
zts212653/clowder-ai
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.