task-summary-to-lark

name	task-summary-to-lark
version	1.2.0
description	长时间任务完成后汇总结果并发送到飞书/Lark。当用户说「发到飞书」「发到 Lark」「汇总发送」「通知飞书」「同步到飞书」「发结果到群里」或在完成长时间任务后需要将结果发送到飞书时使用。

任务完成汇总 & 飞书通知

将 Claude 执行长时间任务的完成结果进行汇总，并通过 lark-cli 发送到飞书。

触发条件

本 Skill 仅在长时间任务完成后触发，而非每次对话都发送通知。满足以下任一条件即视为长时间任务：

• 涉及 5 个以上文件 的修改
• 执行了编译验证（如 ./gradlew assembleDebug）
• 包含多步骤实现（如新增功能模块、重构、多文件联动改动）
• 用户使用了 plan / make-plan / do 等规划类流程
• 对话中累计进行了 10 轮以上 的工具调用

以下场景不触发自动通知（用户手动调用 /task-summary-to-lark 除外）：

• 简单问答、代码解释
• 单文件小幅修改（如改一行文案、修一个 typo）
• 仅读取/搜索代码，未产生实际改动

前置条件：lark-cli

在执行任何操作前，先检查 lark-cli 是否可用：

which lark-cli && lark-cli auth status

如果 lark-cli 未安装

按以下步骤引导用户完成安装和配置：

1. 安装 lark-cli

npm install -g @larksuite/cli

2. 安装飞书 Claude Code Skills

npx skills add larksuite/cli -y -g

3. 初始化应用配置

如果用户已有飞书应用凭证（App ID / App Secret）：

lark-cli config init

如果用户没有现成应用，自动创建一个新应用：

lark-cli config init --new

注意：config init 是交互式命令，需要用户在终端中手动执行。 提示用户在 Claude Code 中输入 ! lark-cli config init 来执行。

4. 授权登录

推荐方式（自动选择常用权限范围）：

lark-cli auth login --recommend

也可以按需选择权限域：

lark-cli auth login --domain im    # 仅即时通讯权限

同样需要用户手动执行：! lark-cli auth login --recommend 登录过程会打开浏览器进行 OAuth 授权。

5. 验证配置

lark-cli auth status

确认输出中显示已认证的用户信息后，即可继续。

完整安装参考: https://github.com/larksuite/cli/blob/main/README.zh.md

---

使用场景

• 完成一轮开发/修复后，将改动摘要发到飞书群或个人
• 代码审查完成后，将审查结果发到飞书
• 任何任务完成后，需要将结果通知相关人员

汇总格式

使用 Markdown 格式，结构如下：

**✅ 任务完成通知**

**📋 任务**: <任务简要描述>
**🕐 时间**: <完成时间, YYYY-MM-DD HH:mm>
**📂 分支**: <当前 git 分支名>

**📝 改动摘要**:
<按功能模块分组列出改动要点，每项一行，使用 - 列表>

**📁 涉及文件** (<N> 个):
<列出关键文件路径，超过 5 个时只列最重要的 5 个并标注"等 N 个文件">

**💡 备注**: <如有额外信息，如待验证项、已知限制等>

执行步骤

Step 1: 检查环境

运行 which lark-cli && lark-cli auth status 检查 lark-cli 是否已安装且已认证。

• 如果未安装或未认证，按上方「前置条件」引导用户完成配置
• 配置完成后再继续

Step 2: 收集信息

1. 回顾当前对话中已完成的任务内容
2. 运行 git diff --stat 获取改动文件统计
3. 运行 git branch --show-current 获取当前分支
4. 获取当前时间

Step 3: 生成汇总

按上述格式生成 Markdown 汇总内容。要求：

• 语言：中文
• 简洁明了，不堆废话
• 改动摘要按功能模块分组，突出「做了什么」和「为什么」
• 如果有编译验证结果，也一并说明

Step 4: 确认发送目标

向用户确认发送目标，支持以下方式：

• 群聊: 需要 --chat-id oc_xxx
• 个人: 需要 --user-id ou_xxx
• 如果用户之前在对话中提过目标，直接使用
• 如果用户说「发给我」，运行 lark-cli auth status 获取当前用户的 userOpenId 并使用

Step 5: 发送消息

使用 lark-cli 发送：

lark-cli im +messages-send \
  --as bot \
  --chat-id <chat_id> \    # 或 --user-id <user_id>
  --markdown "<汇总内容>"

注意事项：

• 使用 --markdown 参数发送，飞书会自动渲染 Markdown
• 必须使用 --as bot 身份发送（im +messages-send 仅支持 bot 身份）
• Markdown 内容中的双引号需要转义
• 发送前先向用户展示汇总内容，确认无误后再发送
• 发送成功后告知用户消息已发送

快捷用法

用户可以直接说：

• /task-summary-to-lark — 汇总当前对话任务并发送
• /task-summary-to-lark 发给我 — 汇总并发送给用户本人
• /task-summary-to-lark oc_xxx — 汇总并发送到指定群聊