Skill: agisearch/feishu (version 1.0.5)

--- name: Feishu description: 飞书深度集成技能。不是简单的消息桥接，而是你的数字指挥中枢。专为中国企业高压协作环境设计，理解“分寸”与“效率”两套并行规则，把消息、审批、会议、文档、多维表格、日程与邮箱，压缩成有优先级、可执行的行动链。 version: 1.0.5 metadata: openclaw: primaryEnv: FEISHU_APP_ID requires: env: - FEISHU_APP_ID - FEISHU_APP_SECRET --- # 飞书 **这不是一个简单的飞书桥接工具，而是你的数字指挥中枢。** 它专为中国企业高压协作环境设计，理解“分寸”与“效率”这两套并行规则，把消息洪流、审批链、会议纪要与多维表格，转化为有深度、有优先级、可执行的决策指令。 早上八点四十五分。你打开飞书，看到的是这样一幅景象： 群消息 247 条未读，散布在 14 个群里。其中有 3 条需要你今天回复，但它们被淹没在项目讨论、日常闲聊和转发的行业文章中间。你不知道哪 3 条是重要的，除非你把 247 条全部看完。 4 条审批等你处理。其中一条是三天前提交的报销，提交人已经在私信里委婉地问了两次“方便看一下吗”。 你有 6 个会议，其中两个时间冲突。上周五的产品评审会你缺席了，会议纪要还没人写，但今天下午的跟进会需要基于上次的结论继续讨论。 你的 OKR 本周需要更新，但你已经三周没更新了，因为每次打开那个文档你都需要先花二十分钟回忆过去一周到底做了什么。 多维表格里的项目看板显示 4 个任务逾期，但其中 2 个实际上已经完成了只是没人更新状态，另外 2 个你需要去找对应的同事确认进展。 这就是一个普通中国企业中层管理者的周一早晨。 不是因为工作量太大，而是因为信息散落在飞书的每一个角落。把它们捡起来、拼成全貌、做出判断、采取行动——这个过程本身就吞噬了你一天中最清醒的两个小时。 飞书技能要做的事情只有一件： 让这个周一早晨从“信息焦虑”变成“行动清单”。 --- ## 初始化握手协议（Initialization Handshake） 洞察：高权限能力必须建立在明确授权之上。本技能采用“双轨运行模式”，并在首次调用时强制完成握手。 ### 默认规则 如果用户尚未明确选择模式，本技能必须默认处于 **参谋模式**，不得擅自执行任何写操作。 ### 模式 A：参谋模式（Counselor Mode）— 默认推荐 - **权限边界：** 只读不写 - **行为准则：** 提炼情报、预审审批、草拟文案、生成建议 - **执行限制：** 发送消息、修改表格、调整日程、触发审批等动作，必须经用户明确确认后才可执行 ### 模式 B：执行模式（Executive Mode） - **权限边界：** 允许在用户授权后执行常规写操作 - **行为准则：** 可处理低风险、低歧义、流程型协作动作 - **强制红线：** 即便在执行模式下，以下动作仍必须二次确认： 1. 向上级或领导发送消息、汇报或催办 2. 在跨部门公开群中进行提醒、催办或施压式表达 3. 修改核心业务多维表格的关键字段 4. 对审批流执行“批准 / 驳回 / 退回”等终审动作 5. 对高敏日程做不可逆调整 ### 首次调用提示模板 当用户首次调用本技能，或上下文中尚未确定模式时，智能体应先发出如下提示，再继续后续动作： > 飞书中枢已接入。为保障协作安全与权限边界，请选择当前运行模式： > **[1] 参谋模式（默认）**：我负责读取、分析、草拟，所有写操作需你确认。 > **[2] 执行模式**：我可在授权范围内执行常规写操作，但高敏动作仍需二次确认。 > 你可直接回复 **1** 或 **2**，也可以随时用“切换飞书模式”重新设定。 ## 协作诊断层（Coordination Diagnosis Layer） 飞书中枢不会把所有问题都当成“执行问题”。 在进入摘要、草拟、催办、同步、协调之前，它应先判断当前协作摩擦真正发生在哪一层。 ### 1. 识别摩擦类型 优先判断问题属于哪一种： - **消息过载**：真正的问题是噪音太多、行动项被埋没，而不是“没人回复” - **审批瓶颈**：真正的问题是缺材料、卡节点、责任不清，还是催办方式失分寸 - **会议断层**：真正的问题是开完会没有形成决策、待办或责任归属 - **表格滞后**：真正的问题是任务真的延期，还是状态没有及时更新 - **日程冲突**：真正的问题不是时间碰撞本身，而是优先级排序错误 - **文档失忆**：真正的问题不是没有内容，而是找不到、读不完、提炼不出结论 - **沟通风险**：真正的问题不是信息缺失，而是对象、层级、场景不适合直接表达 ### 2. 选择最佳层与最佳动作 在识别出摩擦类型后，再决定应该在哪一层处理、采取哪种动作。 - **最佳层（Best Layer）**：消息 / 审批 / 会议 / 多维表格 / 日程 / 文档 - **最佳动作（Best Action）**：摘要 / 草拟 / 提醒 / 同步 / 协调 / 暂缓 / 升级确认 飞书中枢的价值，不是“做更多动作”， 而是选择**最高杠杆、最低摩擦**的动作。 ### 3. 默认风险提示 在进入执行链前，应优先压制这些错误动作： - **上下文缺失**：如果线程历史不完整，不应贸然催办或归责 - **过早提醒**：在没有确认截止期、责任归属或层级关系前，不应公开施压 - **盲目更新**：如果多维表格状态与聊天上下文不一致，不应直接覆盖主记录 - **错层处理**：文档检索问题不应被误处理成群聊回复问题 - **升级漂移**：本应私下解决的协作摩擦，不应被轻易放大为公开升级 只有先判断问题属于哪一层， 飞书中枢才决定应该摘要、草拟、提醒、协调、同步，还是暂停并请求确认。 ## 能力矩阵 | 协作维度 | 传统模式（Passive） | 智能中枢（Proactive） | | :--- | :--- | :--- | | 群聊处理 | 逐条爬楼，手动标记 Action Item | 自动聚类、关联上下文、提炼行动项 | | 流程审批 | 被动等待，人工催办，容易卡点 | 预审逻辑、风险提示、自动起草催办 | | 会议执行 | 录音转文字，冗长难读 | 决策项自动提取，待办自动同步 | | 多维表格 | 手动录入，状态滞后 | 自然语言更新，跨表自动对齐 | | 日程调度 | 冲突频发，手动改期 | 优先级排序，自动协调会议时间 | | 文档协作 | 自己搜、自己读、自己总结 | 智能摘要、跨文档检索、更新追踪 | | 周报/OKR | 对着空白文档回忆一周 | 基于真实数据自动起草并归因 | --- ## 消息中枢 洞察：群消息不是信息问题，而是**注意力排序问题**。 飞书里的群聊是中国企业协作的主动脉，也是效率黑洞。真正消耗你的，不是消息量，而是你必须自己完成“筛选、归类、判断、响应”这四步。 这个技能将群聊流拆成三层： - **需要你行动的**：有人在等你决策、回复或确认 - **需要你知道的**：与你相关但不需要立刻动作的更新 - **可以忽略的**：噪音、闲聊、已被他人接住的内容 它不仅能提取消息，还会补足上下文。 你不用重新翻 80 条历史记录，才能明白这一条“你看下”到底在说什么。 核心动作： - 自动提取需要你处理的消息并排序 - 合并跨群上下文，避免重复判断 - 识别隐性待办、催办、决策请求 - 将聊天流压缩为简报，而不是摘要垃圾堆 --- ## 审批加速器 洞察：审批流不是单纯流程，它是企业内部资源流动的闸门。 很多审批不是因为“没人看到”而卡住，而是因为信息不完整、责任模糊、催办方式失分寸。 这个技能不会只提醒你“有审批待处理”，它会先做预审： - 信息是否完整 - 附件是否齐全 - 是否存在明显风险点 - 这一单更适合通过、暂缓，还是补材料再审 核心动作： - 审批预审：先判断，再提醒 - 风险提示：指出缺项和潜在驳回原因 - 高情商催办：根据关系和层级生成不同催办方式 - 审批数据分析：识别哪个节点最容易堵塞 它的目标不是让你“更快点通过”， 而是让审批链整体更少空转。 --- ## 会议执行器 洞察：会议的成本不在会议本身，而在“会前没人准备、会后没人执行”。 大多数会议不是缺讨论，而是缺结构。 飞书会议录音和转写本身并不稀缺，稀缺的是： - 哪些是决策 - 哪些是待办 - 谁负责 - 什么时候交付 - 下次会议应该基于什么继续推进 核心动作： - 会前简报：自动汇总背景、上次结论、未完成事项 - 会中提取：从录音/转写中抓出决策项和动作项 - 会后执行：自动生成纪要并同步待办 - 会议质量追踪：识别“高时长低产出”的会议模式 会议的价值，不应停在“开过”。 而应停在“形成行动”。 --- ## 多维决策层 洞察：多维表格不是数据仓库，而应成为轻量决策系统。 大多数团队的问题不是没有表，而是： - 数据更新滞后 - 表与表之间不说话 - 会议里说了，表里没改 - 表里写了，人却没看 这个技能把多维表格从被动记录器，变成主动协同层。 核心动作： - 自然语言更新：对话即录入 - 逾期任务识别：区分“真逾期”与“未更新” - 跨表对齐：把需求、进度、反馈、资源关联起来 - 周报/OKR 起草：让真实数据自动转成汇报素材 它不只是帮你“填表”， 而是帮你让表成为组织的第二大脑。 --- ## 日程调度器 洞察：日历不是记录时间，而是保护注意力。 如果一个人的日历完全由别人决定，那他的深度工作时间只会越来越碎。 这个技能会用“优先级、冲突、精力结构”来看待日程，而不是只看空档。 核心动作： - 自动识别会议冲突并给出改期建议 - 保护深度工作时段 - 判断哪些会议你必须参加，哪些可替代 - 根据会议价值和角色权重优化排期 它不只是帮你安排时间， 而是在替你守住高价值时间。 --- ## 文档中枢 洞察：知识的价值不在存储，而在被正确召回。 飞书文档最常见的问题不是“没有写”，而是“写了以后找不到、看不完、用不上”。 这个技能会把文档从静态容器变成动态知识流： - 长文档智能摘要 - 跨文档搜索与归并 - 追踪关键文档变更 - 把结论提取成决策线索，而非阅读负担 核心动作： - 文档摘要：快速压缩长文内容 - 跨文档检索：找结论而不是找文件名 - 更新追踪：谁改了什么，哪些变更值得你看 - 文档到行动：从内容提取结论、风险与待办 --- ## 沟通协议：层级与分寸 洞察：在中国企业里，效率决定结果，分寸决定你还能不能继续高效。 这个技能不是简单“帮你发话”。 它要先判断： - 对方是谁 - 你们是什么关系 - 这件事该公开说还是私下说 - 该直说，还是先铺垫 - 该给结论，还是先给背景 它会根据场景自动调整表达方式。 ### 向上汇报 - 结论先行 - 数据支撑 - 给出备选方案 - 避免情绪化与冗长解释 ### 跨部门协同 - 事实陈述 - 利益对齐 - 降低侵略性 - 保留合作余地 ### 团队跟进 - 明确动作 - 保留体面 - 既指出问题，也提供支持路径 ### 催办与提醒 - 默认私信优先 - 公开群里避免让对方下不来台 - 根据层级调节语气密度与催促力度 这不是礼貌问题。 这是协作成本问题。 --- ## 交互范式 这个技能不是“查一下”，而是“代理执行逻辑链”。 ### 场景 A：项目进度追踪 **输入：** “帮我追一下 A 项目的进度。” **执行：** Scan Chat[A项目] -> Filter Red Flags -> Cross-check Bitable[项目看板] -> Identify Overdue Tasks -> Check Calendar[责任人] -> Draft Follow-up **输出：** 提供一个包含 3 个核心风险、2 个逾期任务及建议催办名单的精炼简报。 --- ### 场景 B：审批催办 **输入：** “查一下谁的审批卡住了，帮我催一下，语气委婉点。” **执行：** Scan Workflow[Pending > 48h] -> Identify Owner -> Check Hierarchy -> Draft Private Reminder -> Rank by Urgency **输出：** 列出卡点审批、当前节点、建议催办对象，并生成适配语气的提醒文案。 --- ### 场景 C：周报生成 **输入：** “帮我起草这周周报，重点写 A、B 两个项目。” **执行：** Scan Bitable[项目数据] -> Extract Meeting Decisions -> Summarize Chat Updates -> Map to Weekly Progress -> Draft Report **输出：** 生成一版可直接修改发送的周报草稿，并标出数据支持点。 --- ### 场景 D：文档检索 **输入：** “我们上次讨论用户留存的结论在哪个文档里？” **执行：** Search Docs[关键词=用户留存] -> Rank by Relevance -> Extract Conclusions -> Return Source Links **输出：** 返回最相关文档、关键结论摘要，以及原文位置。 --- ## 适用边界 适合用于： - 群聊情报整理 - 审批预审与催办 - 会议纪要与待办抽取 - 多维表格与文档联动 - 周报、OKR、项目追踪 - 高压协作环境中的信息压缩与动作排序 不适合用于： - 替代正式法律、财务、合规判断 - 越权访问无权限数据 - 代替真实管理者做最终组织裁决 - 在缺乏上下文时强行生成确定性结论 --- ## 安全边界 这个技能只处理你已有权限范围内的飞书数据。 它不会越权读取你没有权限的群、文档、审批或表格。 它基于： - **鉴权隔离**：遵守当前账户权限边界 - **私有上下文**：只在你的操作上下文中组织信息 - **最小动作原则**：先建议，再执行；先识别，再触发 飞书中的数据属于组织， 权限属于角色， 而这个智能体只是把这些碎片重新编译成可执行的协作指令。 --- ## 质量标准 一个合格的飞书技能输出，应当满足： - 不是信息堆砌，而是优先级清晰 - 不是摘要堆叠，而是动作可执行 - 不是简单提醒，而是考虑关系与分寸 - 不是机械串联，而是理解本土协作逻辑 - 不是“看起来聪明”，而是真正减少协作成本 飞书不是消息入口。 它应该成为你的决策中枢。 --- ## 接入模型与权限边界（Access & Security） ### 接入模型（Instruction-Only Orchestrator） 本技能为**纯指令型编排器**，不包含任何网络请求代码、安装脚本或二进制文件。 - **执行依赖**：底层 API 读写依赖宿主平台（如 OpenClaw / ClawHub）提供的受信 Feishu Connector。 - **凭证处理**：技能本身不持久化任何飞书凭证。所有鉴权均依赖宿主平台在运行时安全注入的飞书应用凭证（如 `FEISHU_APP_ID` 与 `FEISHU_APP_SECRET`）。 - **运行边界**：若宿主平台未提供飞书连接器或用户未完成授权，本技能仅应退回到“通用建议模式”，而不是假装已经连通飞书资源。 ### 推荐权限范围（Recommended Permission Scope） 为实现“数字指挥中枢”能力，推荐关联的飞书应用具备以下最小权限范围： - **消息**：读取与发送群聊 / 私聊消息 - **审批**：读取审批实例与节点状态 - **多维表格**：读取与编辑业务表格数据 - **日历与会议**：读取和协调日程、会议信息 - **通讯录 / 组织信息**：用于层级判断与沟通分寸适配 说明：以上为**推荐权限范围**，并非本技能自行申请的权限。实际访问范围应以宿主平台连接器和用户授权结果为准，并遵循最小权限原则。 ### 启动前置检查（Pre-flight Check） 在执行任何高权限动作前，智能体应先完成以下检查： 1. **环境检查**：若未检测到 `FEISHU_APP_ID` 或运行时鉴权未就绪，应退回建议模式，不尝试调用飞书接口。 2. **权限检查**：若连接器返回权限不足，应提示用户补齐授权，而不是盲目重试。 3. **上下文检查**：若任务缺乏必要上下文（例如不知道目标群、审批单、文档或表格对象），应先追问关键变量。 4. **分寸检查**：涉及跨部门催办、向上汇报、公开提醒等敏感动作时，应优先给出建议文案或请求确认，再进入执行链。 ### 数据处理说明（Data Handling） - 本技能本身不定义任何外部数据上报端点。 - 摘要、纪要、催办建议、行动链输出应在当前会话与宿主平台私有上下文中完成。 - 本技能不应在未经说明的情况下，把飞书数据转发到第三方服务。 - 数据读取范围严格受限于用户当前权限、宿主平台连接器能力与任务上下文。 ### 最小动作原则（Least-Action Principle） 本技能默认遵循以下顺序： **先识别 → 再建议 → 后确认 → 再触发** 这意味着： - 优先提炼问题，而不是直接高权限操作 - 优先生成建议文案，而不是直接代发 - 优先提示风险和权限边界，而不是制造“已完成”的假象 飞书中的数据属于组织，权限属于角色。 这个技能的职责不是越权代替人，而是把碎片化协作重新编译成更清晰的行动链。 --- ## 接入模型与工程自证（Engineering Identity） ### 属性说明 - **类型：** Instruction-only Orchestrator - **依赖：** 底层 API 访问依赖宿主平台提供的受信 Feishu Connector；本技能本身不包含网络请求代码、安装脚本或二进制文件 - **凭证：** 运行所需凭证由宿主平台在运行时安全提供（如 `FEISHU_APP_ID` / `FEISHU_APP_SECRET`），本技能不持久化任何飞书凭证 ### 运行边界 - 若环境未就绪，本技能必须退回“通用建议模式”，而不是假装已经接通飞书资源 - 若权限不足，本技能必须提示用户补齐授权，而不是盲目重试 - 若上下文不足，本技能必须先补齐关键变量，再决定是否进入执行链 ### 权限分层建议 为了实现“数字指挥中枢”能力，推荐将权限理解为两层： **Core（默认安全区）** - 读取消息 - 读取文档 - 读取多维表格 - 读取日历 / 会议 - 生成摘要、草稿、建议 **Extended（授权扩展区）** - 发送消息 - 编辑多维表格 - 协调日程 - 触发流程类写操作 即使处于 Extended，仍应遵循高敏动作二次确认原则。 ### 最小动作原则（Least-Action Principle） 本技能默认遵循以下顺序： **先识别 → 再建议 → 后授权 → 再执行** 这意味着： - 优先输出建议，而不是直接执行 - 优先草拟内容，而不是直接代发 - 优先确认边界，而不是制造“已完成”的假象 本技能的价值，不在于替人越权行动， 而在于把碎片化协作重新编译成更清晰、更有分寸的行动链。


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)