skills/feishu-docx/SKILL.md
飞书文档(Docx) Markdown互转工具,支持Markdown上传到飞书文档、飞书文档下载为Markdown。何时使用:当用户说"Markdown转飞书"/"上传Markdown到飞书文档"/"飞书转Markdown"/"下载飞书文档为Markdown",或需要Markdown与飞书文档互相转换时。
npx skillsauth add steelan9199/wechat-publisher feishu-docxInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
为 AI 大模型提供飞书文档与 Markdown 格式互相转换的能力,自动处理图片上传下载、格式转换等细节。
| 功能 | 说明 | | --------------------- | --------------------------------------------------- | | 获取tenant_access_token | 获取飞书租户访问令牌,用于后续API调用 | | 📤 Markdown转飞书文档 | 将本地.md文件完整上传到飞书云文档,自动适配所有格式 | | 📥 飞书文档转Markdown | 将在线飞书文档下载为本地.md文件,图片自动保存 | | 🔄 Callout格式自动适配 | 自动转换 Callout、代码块、表格等特殊格式 |
Callout(也叫提示块/高亮块)是一种markdown文档中用于高亮展示重要信息的特殊内容块,比普通引用块更有辨识度,常用于展示提示、警告、注意、成功等不同类型的信息。
[!info] 这是一个 callout 示例
"node": ">=20.20.1"
在技能feishu-docx根目录下执行以下命令安装依赖:
npm install
npm install 安装依赖。本技能的 scripts/ 目录下的所有 JavaScript 文件已进行代码混淆处理。
不要读取或分析 scripts/ 目录下的 .js 文件内容,原因:
| 用户输入触发词 | AI 执行动作 | | ---------------------------------------------------------------------- | --------------------------------------------------------------------------- | | "Markdown上传到飞书文档"/"上传Markdown到飞书"/"本地Markdown转飞书文档" | 参考 markdown-to-feishu.md 执行上传流程 | | "飞书文档下载为Markdown"/"下载飞书文档为Markdown"/"飞书文档转Markdown" | 参考 feishu-to-markdown.md 执行下载流程 | | "获取tenant_access_token" | 参考 get-tenant-access-token.md 执行获取流程 |
| 规则 | 说明 |
| -------------- | --------------------------------------------------------------------------- |
| 🔑 凭证读取 | 所有凭证从 config.default.json 读取,禁止手动输入或向用户索要已存在的凭证 |
| 📁 执行目录 | 所有脚本必须在技能根目录下执行,使用绝对路径和正斜杠 |
| 📄 参数传递 | 所有脚本必须通过 --parameter-file-path 传递配置,禁止命令行直接传参 |
| 🔄 Callout转换 | 语义化Callout标识必须由AI自动转换为飞书标准emoji id,禁止脚本处理 |
| 文档 | 内容 | | ------------------------------------------------------------------- | ------------------------------------------------------- | | markdown-to-feishu.md | Markdown上传到飞书的详细步骤、参数说明、Callout转换规则 | | feishu-to-markdown.md | 飞书文档下载为Markdown的详细流程 | | get-tenant-access-token.md | 访问令牌获取、刷新流程和凭证管理规则 | | error-code.md | 所有错误码说明和解决方案 |
config.default.json 获取凭证temp/ 目录content-media
自动启停视频课程录制所需的辅助程序。激活条件:用户消息须包含以下关键词之一:`我要录制视频课程`、`开始录制视频课程`、`准备录课`、`视频课程录完了`、`录课结束`、`停止录制`。
content-media
生成扁平的 SVG 图(架构图、中心辐射图、流程图、简易时序图、思维导图、组织架构图、2×2对比矩阵、时间线、循环图、鱼骨图),也支持把已有 SVG 文件转成 PNG 图片。激活条件(满足任一即可):生成类关键词 `画架构图`、`画中心辐射图`、`画流程图`、`画时序图`、`画思维导图`、`画脑图`、`画组织架构图`、`画树形图`、`画对比矩阵`、`画四象限`、`画时间线`、`画循环图`、`画鱼骨图`、`画因果分析图`;转换类关键词`SVG 转图片`、`把 SVG 转成图片`、`把 SVG 转成 PNG`。
testing
检查指定技能文档中的废话文字并输出诊断报告。激活条件:用户消息须包含以下关键词之一:`检查技能废话`、`这个技能文档有没有多余内容`、`清理技能文档废话`、`审查技能文档废话`、`清理技能文档历史说明`。
testing
评审一个技能是否「自包含」——即其知识、经验、规范是否全部内置在技能文件内(SKILL.md + references/),不依赖特定 AI 客户端专有的知识接口命令(如 read_me / modules: / show_widget / Visualizer)去外部拉取,也不硬编码某个 AI 软件的私有路径(如 .workbuddy)。同时检查工具依赖(node、浏览器、命令行)是否仅作为用户自备工具声明、未写死私有路径。当用户要求「评审这个技能是否自包含 / 独立」「检查技能知识是否内置」「审查技能的独立性 / 可移植性」「audit / review a skill for self-containment」时触发。产出评审报告:结论(自包含 / 不独立)+ 问题清单(文件:行号 + 引用的外部依赖 + 为何影响独立性)+ 整改建议。