lark-share 用于把知识洞察或消息通过飞书群聊自定义机器人 Webhook 以格式化卡片形式分享给团队。触发词包括"share"、"lark-share",或用户想发送格式化消息时使用。
主要能力:根据主题研究并撰写 lark_md 格式消息,经预览确认后通过脚本发送到飞书群聊,支持标题、颜色及可选图片附件。
配置:配置文件位于 ~/.lark-share/config.json,包含 webhook_token(必填,即 /hook/ 后的路径片段)、language(zh 或 en,默认 zh)、signing_secret(可选 HMAC 签名密钥,留空则使用 webhook_token 签名)。配置不存在时进入初始化流程:向用户索取 Webhook URL 或 token(完整 URL 会提取 token),询问语言偏好与签名密钥,然后创建配置文件。
使用方式:命令为 /lark-share [subject]。提供 subject 则作为主题;未提供则询问用户想分享的主题。工作流分三步:一、研究主题并起草 lark_md 消息,结构为简短引言、要点或技巧、实用示例或结论,保持简洁(约 5–15 行),标题需吸引注意并加 emoji,正文不重复标题,语言遵循配置;二、预览并确认,必须让用户确认后发送,可选发送、编辑、取消;三、发送,命令为 python3 $LARK_SHARE_SCRIPTS/lark_webhook.py "<message>" --title "<title>" --color blue,脚本自动读取配置中的 token。可选参数 --image <path> 附加图片。
脚本路径:LARK_SHARE_SCRIPTS=$(python3 -c "import os; p='.claude/skills/lark-share/scripts'; print(os.path.abspath(p) if os.path.isdir(p) else os.path.expanduser('~/.agents/skills/lark-share/scripts'))")
lark_md 语法支持粗体、斜体、删除线、链接、单行代码、换行符 \n 及 @ 全员。限制:仅支持单行代码,无多行代码块;图片上传依赖 handoff 技能,未安装时跳过。