Team Lark — Development skill for Claude Code

team-lark —— 一个 Agent 化的团队

把团队的**意识同步、对齐、状态管理**全部 Agent 化的 Claude Code / lark-cli skill。

每个人 = 人 + 他的 agent = 一个节点；所有节点连到**飞书多维表格**这个共享状态层。你跟自己的 agent 对话，agent 替你读写团队的共享真相——查任务、发起/指派、交付、验收、看全局进度，全用一句话搞定。

还能开**主动模式**：一个定时器每天自动跑一遍，给每个人私信发当天的个人简报，没人需要先开口（见下方「主动模式」）。

**为什么用飞书：** 同类的「AI 团队同事」（如 Anthropic Claude Tag）绑死 Slack，国内团队基本用不上。本工具接的是**飞书**——国内团队的标配，配上 `lark-cli` + Claude，国内就能真正落地。

核心理念

• 飞书多维表格 = 团队的共享真相：任务/状态/交付物都在这，全团队随时看到同一份状态。
• 关系，而非身份：没有老板/员工这种固定角色。每件事上只有 发起人 / 负责人 / 验收人，随事而定、随时流转。
• 每次进入先对齐：每次运行 skill，先读一遍共享状态，出一份「今日简报」（今天做了什么 + 所有没做的 + 等我验收的）。
• 状态机：待领取 → 进行中 → 待验收 →（验收人）→ 已完成 / 打回 →（回到）进行中。

---

需要哪些权限（看这张表就够）

飞书是**两层权限**，两层都要过，缺任一层就 `permission denied`：

**第一层 · 应用 scope**（管理员在自建应用「权限管理」里开通一次，全团队共用一个应用）：

你要它干什么	在应用「权限管理」里开通	审批	必须
读「人设/部门/职位」生成扮演设定	以普通用户身份读取通讯录：contact:user.department:readonly、contact:user.employee:readonly	免审	✅
读写任务表 / 成员表	多维表格（bitable）查看与编辑	免审	✅
发私信（状态变更通知 + 主动模式每日简报）	发送单聊消息（im，以用户身份发消息）	免审	✅（主动模式必须）
（可选）群里 @ 提醒 / 群通知	获取与发送群组消息（im 群）	免审	可选

⚠️ **别用** `contact:contact:readonly`（高敏感、要管理员审核）——上面两个免审通讯录权限就够。

**第二层 · Base 文档编辑权**：每个成员还要对那张**具体的多维表格**有编辑权（在 Base 右上角「分享」里把成员加为可编辑）。

读出来部门是 `0`、职位为空 = scope 通了但通讯录后台没填，请管理员补部门/职位。

---

快速开始

1. 装依赖

• Claude Code（或任何支持 skill 的 agent 环境）
• `lark-cli`：npm i -g @larksuite/cli（或按官方 README）

2. 装 skill

git clone https://github.com/ericshang98/team-lark.git ~/.claude/skills/team-lark

3. 建一个飞书自建应用（团队只需建一个，全员共用 · 管理员做一次）

给 `lark-cli` 一个 OAuth 客户端 + 权限容器。本工具走**用户身份 `user_access_token`**——每人各自登录时仍是自己的身份。**整个团队一个应用就够。**

1. 去 飞书开放平台 → 创建企业自建应用（比如就叫 team-lark）。
2. 开通机器人能力（群通知 / @人会用到）。
3. 「权限管理」→ 按上方 §需要哪些权限 那张表，逐项开通（通讯录两项 + 多维表格 + 发送单聊消息；要群通知再加群消息）。
4. 设可用范围 = 团队成员，创建版本 → 发布上线（管理员审批通过才生效）。

4. 每个成员各自登录（⚠️ 必须带 `--