【Skill 创作】我做了一个office文件和markdown文件互相转换的 Skill

Skill 简介

这是一个帮助开发者、写作者和知识工作者在 Office 文档与 Markdown 之间进行双向转换的 Skill,基于 pandoc 和 markitdown
两个命令行工具。适合需要频繁处理 DOCX、PPTX、XLSX、PDF 等格式与 Markdown 互相转换的同学使用。

使用场景

使用AI处理文字工作,将会带来很多的效率提升,但是,AI 对 Markdown 的理解和处理远好于二进制Office 格式。一般的思路先将office文件转换为markdown格式,丢给AI分析,然后再将markdown转换为office文件。每次使用命令行很麻烦,而且命令行对于普通人的学习成本脚本,所以希望可以通过AI agent来自动化这个过程。

创造思路

  • 核心原则

skill的编写大同小异,实践下来,有两种比较好用的做法:

  1. 面向需求结果编写。

所谓面向需求,就是借助AI工具,直接告诉AI你希望实现的效果,并且告诉AI它可以使用到的工具,让AI自行生成skill即可。此法比较适合非开发者。

2. 面向过程编写

所以面向过程,就是分析你的人工操作过程,记录下来,然后通过AI你的实现步骤,最后让AI根据你操作步骤生成skill即可,此法比较适合逻辑能力比较清晰的开发者。

编写完成后,使用skill 进行测试,完善skill的边界条件。

  • 具体实现

    1. 收集技术方案。

    使用AI进行检索,收集实现方案,测试方案的可行性。这里推荐使用 superpowers的braining skill。

    2. 这里我使用的是面向过程的原则。

    告诉AI,我是如何实现office和markdown的转换,然后让AI将这个过程转为skill。这里推荐使用 mermaid 来描述的步骤,或者画流程图,让支持多模态的大模型识别流程图。

    1. 反复测试。通过测试,补充边界条件,然后让AI修改。

使用步骤

调用skill的方法有两种:

  1. 直接通过关键字,例如:将“xxx.docx” 转换为 “markdown”格式。
  2. 直接使用 /office-md-bridge 斜杠命令。

效果展示

Skill 链接

总结与思考

  • 后续优化

  • markitdown的安装,对于非开发者来说,还是有难度,后续将这个过程自动化。

整成 MD 格式喂给AI模型吗?

2 个赞

是的。大模型对office文件(如docx)的处理能力比较弱,将其转换为markdown方便喂给AI。对于使用claude code cli这些 agent cli非常好用。

2 个赞

投一票就完了

2 个赞