miseon-stack/project-management-skills/feishu-meeting-cards
Claude Code and agent skill by miseon-stack/project-management-skills
- community
Checking that the SKILL.md file is still in the repository.
把飞书会议的「文字记录」docx 转成项目级「报告 + 任务卡片 + 推进建议」,并导入云文档、推送个人私聊。触发场景:用户说"生成报告任务卡片""会议转任务""周会纪要+怎么推进""把这段会议记录整理成任务""发送我的飞书个人"。
Install
npx vskill@latest install miseon-stack/project-management-skills/feishu-meeting-cardsSKILL.md
The same SKILL.md was published earlier as miseon-stack/project-management-skills/feishu-meeting-cards.
会议转写 → 报告 + 任务卡片 + 推送
何时用
- 用户甩来一条飞书会议文字记录链接(
.../docx/xxx),要"报告 / 任务卡片 / 建议如何推进"。 - 周会、项目组会、客户沟通会后需要落地成行动项。
- 最后一步常是"发送我的飞书个人"→ 云文档 + 私聊推送。
步骤
0. 写前对源(★ 2026-10-10 新增,动笔之前先过)
起因:客户A管理层卡片 v1→v10 改 9 次。问题不在"写",在"核"排在了"写"后面。
- 证据齐了才动笔:先把要写的每条结论 → 出处 → 置信度列成三列表给用户过,过了再写稿。错误拦在核对表阶段,不在第 10 版。
- 证据分级:A 一手(妙记转写原文 / 线上表实读 / 群消息原文 / 私聊原文)= 唯一可作事实;B 二手(妙记 AI 摘要 / 上一版稿件 / 转述)须回 A 级复核;C 推断(我判的)不进对客物。
- ★三类高频坑,写前先自查:
- 涉时间节点必回转写原文——相对时间(今天/明天/下周)在 AI 摘要里会被吞或错位 → 日期差一天。
- 禁顺抄上一版稿件——旧稿条目在前提变了之后就是毒药,抄一条核一条。
- 输入若是"汇总"(跨多场会议/跨周),别只读一份 docx:必拉数据仓群消息 + 私聊层(
hub.db不含私聊,须im +messages-search --chat-type p2p);漏私聊会把"已转交他人"的活错挂在自己名下。
- 决策人按职责挂:业务范围→业务方;选型/合规→法务/内控;技术路线→项目侧。不默认挂项目牵头人。
1. 取转写全文
- 转写格式:每段 = 说话人 + 时间戳 + 话语;
<cite uid-ref="u1">配合reference_map给出 open_id(u1/u2/u3映射)。 - 文末
_notice里的document.tips会提示"这是逐字稿"。 - 智能纪要通常是另一个 docx,链接出现在正文首部。
2. 实读线上实施表,把会议产出对到任务编号
- ⚠️ 没有 `--page-all`(那是别的子命令的),record-list 用
--limit(ndjson 默认 2000)。 - 用 python 打印紧凑清单:任务编号 / 状态 / 主题 / 客户方任务+负责人 / 我方任务+负责人 / 最新进展前 70 字。
- 会议里出现的具体人名 → 反查任务里对应条目(如"客户来访登记"→ T64),报告中带上编号才可执行。
3. 产出报告(写本地 md)
固定骨架:
- 一句话结论(3–4 个信号)
- 决议台账:
# / 事项 / 结论 / 客户方责任人 / 我方责任人 / 时限——★承诺必须点名到人,禁默认"我方=某个人" - 任务卡片:我方 / 客户方 / 我方非本人 三组,卡片字段 =
卡号 / 任务 / 交付物或完成口径 / 关联编号 / 优先级 - 推进建议:P0 今晚 / P1 节后(或次日)/ P2 一周内 + "推进要点(避免踩坑)"
- 会上未闭环:卡在哪、找谁
- 可发送文案草稿:★标"待确认,未发送"
- 线上表待更新清单:★只列不写(写线上须用户明确授权)
4. 导入云文档
- ⚠️ `@file` 只接受 cwd 相对路径;给绝对路径报
unsafe file path。把文件复制到临时目录再cd过去。 - 标题若含
【】·等中文可正常用。
5. 回读校验 + 修 markdown 解析坑
★最大的坑:表格 cell 内的加粗会被吞。
- 现象:
①纷享销客+金蝶**各自**接飞书;…**我方建议飞书为中枢**(回读变成①纷享销客+金蝶**各自接飞书…我方建议飞书为中枢**(——**配对错位、内容被吃进加粗。 - 规律:加粗结束符 `
后紧跟中文字符**时不可靠(各自接、逻辑不`);后跟全角标点/空格则通常安全。 - 对策:表格行内一律不用 ``。** 写前跑一遍:
- 修订后覆盖(仅限自己刚创建、无其他内容的文档):
- 覆盖后再回读一次确认表格列未错位。
6. 推送我的飞书私聊
★默认用「消息卡片」,不是 markdown / 不是云文档链接(用户 2026-09-30 明确口径:「消息卡片的形式」「不要文档」)。
- ⚠️ `--content` 不吃 `@file`(
@./card.json报--content is not valid JSON);只有docs +create--content支持@。必须"$(cat card.json)"内联(文件放临时目录再 cd 过去)。
卡片结构(1.0,config.wide_screen_mode + header.template + elements[]):
header.template:orange / blue / red…;header.title={"tag":"plain_text","content":"【项目名】日期 · 主题"}。- 分区:依次放 决议 / 今晚必须收口 / 我方任务卡(🔴🟠🟡 分级)/ 客户方待办 / 未闭环,区与区之间用
{"tag":"hr"}。 - 文本块用
{"tag":"div","text":{"tag":"lark_md","content":"..."}};行内 `加粗` 后紧跟中文在卡片里是安全的(被吞只发生在 markdown 文档导入的表格 cell 里)。 - ⚠️ 卡片 2.0 的 `table` 组件在飞书消息卡片里不渲染,用
div+ 换行代替;note标签也不支持。 - ⚠️ 卡片里不放云文档链接(用户明确不要);纯卡片内容自足。
其他要点:
--user-id发给自己返回 p2pchat_id(该账号为<CHAT_ID>= 飞书里的「我」)。★该会话无未读红点,用户可能"看不到" → 推送后主动说明位置。- ★要「有红点提醒」就改用应用身份发(实测可行):
- bot 是 app
<APP_ID>= 「Claw」;落到与 Claw 的 p2p<CHAT_ID>,有未读提醒,卡片正常渲染。 - 换身份重发要换 idempotency-key(key 相同会被判重复)。
--idempotency-key防重复发送(换形式重发要换 key)。- 回读校验:
lark-cli im +messages-mget --message-ids om_xxx --as user,看msg_type=interactive与sender.name。 - ★回读里若看到
<card title="...">…</card>,那是 lark-cli 的反解渲染,不是原始 content(post 类消息同样被反解成 markdown)——卡片本身没坏,不要据此以为发送失败。
卡片美化模板(1.0,实测可渲染)
★排序铁律:行动在前、背景在后(用户 2026-09-30 判过一轮"不够清晰")。区块顺序固定为: 概览数字条 → ① 我今晚要做 → ② 节后要做 → ③ 要客户动 → ④ 卡点找谁 → 背景决议 → 人员一行。
- 用
①②③圈号做小节前缀,比1.2.3.更容易跳读。 - 背景/决议放最后,别放前面占屏;人员速查降到一行(两列网格太占版面,只在"人手分工"是主题时才用)。
- 每条行动写成
**动词短句**+ 换行缩进补"给谁/完成口径",避免长句换行糊成一片。
版式自上而下:
- 概览数字条 ——
column_set4 栏(background_style: "grey"→ 灰底小块,观感最接近官方模板):
hr- 人员速查 ——
div.fields,每项{"is_short":true,"text":{"tag":"lark_md","content":"**姓名 · 侧**\n角色"}}→ 自动排成两列网格;最后一条is_short:false占整行。 hr+div小节标题(**四条决议(点名到人)**)- 决议 ——
div.fields,4 条各is_short:false:**1 · 事项**\n结论|责任人 hr+ 任务卡 —— 单个div,按 🔴 P0 / 🟠 P1 / 🟡 P2 三段分组,同段落多条用·并排省行hr+ 客户方待办(· **人** → 事)+ 未闭环找谁(· 事 → **人**)
要点:
- 概览块 + fields 网格是"美化"的性价比最高两招;不需要卡片 2.0(2.0 的
table/note不渲染,且 1.0 已够)。 - 只允许颜色 emoji(🔴🟠🟡🟢),别加 📌/✅ 这类装饰 emoji。
- 长卡片(>3KB content)没问题,实测 3.3KB 正常渲染。
对外版(发客户群)
内部版 ≠ 对外版。要发客户群/客户可见处时,先跑 `feishu-outbound-gate` 门禁,再按白名单改写:
| 删/改 | 内部版里长什么样 | |
|---|---|---|
| 删整块 | 我方的行动清单(含 "落表 / 发某人 / 回原厂" 这类内部动作)、概览数字条、人员速查、"卡点"块 | |
| 中性化措辞 | 「卡点 → 找谁」→「待确认事项」;「缺人 → 客户财务同事出面邀(已邀 3–4 次未成)」→「需补充人力,建议由分管领导牵头协调」 | |
| 删内部观察 | 「客户IT负责人病假中」「最大工期风险」「X 邀 Y 数次未成」——不能把客户内部的人和状态写进对客材料 | |
| 去内部人名 | 我方实名(本人 / 团队负责人 / CSM负责人)→ 一律写「我方」;客户侧优先用部门/角色(销售支持部 / 信息部门),要点名到人须用户逐条确认 | |
| 改标题视角 | 「行动清单(节前收口)」→「纪要要点与后续安排」;表头色 orange → blue(内部橙 / 对外蓝,便于一眼区分) |
保留不改:已确认的硬节点(如 10/8)、客户方既有的分工对象、方案建议口径("建议以飞书为中枢,待贵司决策")。 新增措辞:原文里没有的承诺/日期一律不加;末行加「如有出入请指出,我方即时修订」而非内部口吻。
⚠️ 外发必须有明确授权(群名 + 「发」);「我要发的」只授权出稿,不授权发出去。
对外版 2.0:按事项重组(用户 2026-09-30 判「要更清晰」后的定版)
对外版 v1 沿用内部版的分块(要点 / 待确认 / 我方安排 / 贵司待办)→ 对客场景的硬伤是同一事项被切进 3–4 个段落("集成"同时出现在要点②、待确认③、我方安排①、贵司待办⑤),客户读完仍不知"谁做、何时做"。
2.0 改按事项重组,固定 4 块:
要点:
- 每条事项固定两行对照「我方:」「贵司:」,替代散文——这是清晰度的主要来源。
- 同一事项只出现一次;决策项去重合并。
- 卡片里用
**N.事项名**\n我方:…\n贵司:…,不要用 `div.fields` 做两列(fields 在窄屏会挤成一坨,且长文本换行不可控)。 - 概览条压到 3 栏:
事项 N / 待决策 N / 硬节点日期。 - 「贵司:—」这种空值保留不删(保持两行节奏一致,扫读更快)。
对外版 3.0:内容具体化(用户 2026-09-30 判「内容太笼统」后的定版)
结构对了仍会"不清晰",因为用词是空话。对客文本禁用笼统动词,按三条规则改写:
| 规则 | 笼统(禁) | 具体(用) | |
|---|---|---|---|
| ① 名词要具体 | 「提供方案与技术支持」「集成资料清单」 | 写材料名 + 所含内容物:「提交《集成方案对比》(飞书中枢 / CRM 中枢,含数据流向、冗余、导出方式、费用、工期)」 | |
| ② 动词可核对 | 支持 / 推进 / 关注 / 加强 / 配合好 | 确定 / 安排 / 整理 / 提交 / 确认 —— 完成后能被外部核对 | |
| ③ 时间落到日期 | 尽快 / 后续 / 节后 / 近期 | 「今日」「10/8」——客户能对着日历等 |
配套两条:
- 拆执行 vs 拍板:事项块的「贵司」行只写执行动作(安排对接、整理口径),决策块只写要拍板的(路线 / 接口 / 费用)。不拆就会两处重复(这是"不清晰"的常见隐藏成因)。
- ⚠️ 具体化会引入承诺:把内部排期(如 P1 节后首日交材料)写进对客材料 = 对客承诺。做法:照写具体日期,但在文件里单列「发前必核:新增承诺 N 条」让用户确认能否兑现,或退回「节后首周」。
★教训(诊断顺序):用户说"不清晰"时,按序排查 ① 内容笼统 → ② 信息重复 → ③ 排序(行动在后)→ ④ 版式。连错两次就直接出选项让用户点(AskUserQuestion),不要第三次盲改——2026-09-30 客户A对客版即连错两轮后才问到真因。
管理层版(向上汇报)
同一份会议材料有 4 种受众版本,别混用:
| 版本 | 给谁 | 人称 | 关键差异 | |
|---|---|---|---|---|
| 内部版 | 自己 | 我方实名 | 只写"我"要做的,带 JC 编号、卡点、内部观察 | |
| 对客版 | 客户群 | 「我方」/ 部门角色 | 删决策块与内部观察,通篇中性、可公开 | |
| 管理层版 | 客户管理层 / 上级 | 点名到人 | 突出「要谁拍板 + 何时 + 不决的影响」,任务清单降为附注 | |
| 卡片 | 任意上述 | 同上 | 消息卡片形式,无云文档链接 |
管理层版结构(固定):
要点:
- 管理层只看三样:卡在哪、要谁拍板、什么时候。任务明细是附注,不要放主体。
- 「需管理层决策」条必须四要素齐全:决策事项 / 决策人 / 需要时间 / 未决策的影响(最后一项最容易被漏,也最能推动拍板)。
- ★决策人按职责挂,不默认挂项目牵头人(2026-10-10 实证:两条决策项全挂"客户接口人",实为业务范围归客户方接口人(营销中心)、选型合规归陈娜(法务)/曾雪敏(内控))。业务范围→业务方;选型/合规→法务/内控;技术路线→项目侧。
- ★只陈述事实,不写判定:不写「定了 / 没定 / 尚待验证 / 已对齐」——把过程发言当结论等于替客户下结论。用户明确口径(2026-10-10):"只写有这事情"。
- ★已发出的条目要删:用户说某条"已发过了",整条移除并自检关键词 0 命中(2026-10-10 实证)。
- 到人写法:
事项 —— 责任人,时间,责任人与时间加粗(如集成中枢路线 —— 客户接口人,10/8 前)。 - 表头色:内部 orange / 对客 blue / 管理层 indigo —— 一眼区分,避免发错版本。
- ★发布边界:即使点名到人,仍守对外门禁——不写人员状态(病假)、不写内部排期编号、不写客户内部人事协调过程;客户高管用尊称。管理层版通常是"可外发"版本,按对客标准审一遍再发。
- ★"给我发一下" ≠ 授权推送给管理层:那只授权发到用户自己的会话。要真正推给管理层,须问清发往哪个群/哪个对象。
固定模板 + 生成脚本(2026-09-30 起,管理层周报默认走这个)
用户已定版:「以后用这个形式推」。别再手写卡片 JSON,用生成器:
--to以oc_开头自动走--chat-id,否则--user-id。- 数据与版式分离:每周只改数据 JSON(
项目资料/<日期>_项目周报_数据源.json),版式由脚本产出,保证形式不漂移。 - 脚本负责的固定版式:概览条 → 一 整体状态 → 二 任务总览 → 三 进展 → 四 需管理层决策 → 五 风险 → 六 下一周期 → 页脚;日期/时间自动加粗,
text/item/owner内可自行写**。 - ★板式一致性校验:新写的卡片要与脚本产物 diff 一遍(比对
elements里各div.text.content),避免手工版与模板版两套形式并存。
注意事项
- 只读红线:写线上表、发群消息、发客户私聊,都要用户明确授权("发送/提交/写进去"才算,go/好/嗯不算)。默认只出草稿 + 待更新清单。
- 对外物最小改动:给客户看的版本,只做"对外可见性"必要替换,不顺手改负责人/分工。
- 写前先对源(见 §步骤 0):不拿 AI 摘要当事实源、不顺抄旧稿、涉时间节点回转写原文、决策人按职责挂。
- 出手前跑门禁:给管理层/客户的版本,自跑 `feishu-outbound-gate` 六道检查,不等用户喊(2026-10-10 实证:手上明明有门禁却跳过,导致 9 次返工)。
- 改完必自检:重新生成卡片后,用脚本统计关键词命中数(如
错词 → 0、客户方接口人 → 3)自证改干净;多版本并存时明确声明"以 vN 为准、vX 作废"。 - 本地交付物与线上文档若因去加粗而不一致,同步回本地,避免两份漂移。
- 完成后把关键坑(新踩到的)补进本 skill。
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/feishu-meeting-cards/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/miseon-stack/project-management-skills/feishu-meeting-cards)