最新案例动态，请查阅基于华为云码道 AI IDE 构建SKILL工坊，实战生成md-to-word构建文档转换能力。小伙伴们快来进行实操吧！

一、概述

1.1 适用对象

• 个人开发者
• 高校学生
• 企业开发者

1.2 案例时间

本案例总时长预计60分钟。

1.3 案例流程

作为一位技术博主，在日常工作中经常需要在多个技术平台之间发布和同步技术博客文章，例如 CSDN、掘金、知乎、微信公众号、企业内部 Wiki 等平台。然而，各大平台所支持的内容格式并不一致：有的支持 Markdown，有的仅支持富文本编辑器（如 Word），有的对图片处理方式不同，还有的对代码块、表格、超链接等元素有着不同的渲染要求。这种格式不兼容的问题，导致博主们往往需要针对每个平台单独调整文章格式，不仅耗时耗力，还容易出现格式错乱、图片丢失、代码高亮失效等问题，严重影响了内容发布的效率和质量。

为了解决这一痛点，我们希望通过华为云码道（CodeArts）代码智能体强大的 AI 能力，结合 skill-creator 技能所搭建 SKILL 工坊，快速构建一个专业的格式转换 SKILL。这个 SKILL 将能够智能识别 Markdown 格式，自动完成 Markdown 到 Word 文档的转换，同时保证字体样式（微软雅黑）、图片链接（本地和网络图片）、超链接、代码块、表格布局等关键元素的完整性和一致性，确保转换后的 Word 文档不会出现乱码，真正实现技术博客从 Markdown 格式到 Word 格式的高效转换，满足企业文档归档、微信公众号编辑器导入等实际应用场景需求。

SKILLs是一种为大型语言模型获取新能力的模块化封装标准。它基于“渐进式披露”（Progressive Disclosure）架构设计，将特定任务的指令、脚本与资源结构化存储为独立单元。该机制允许模型在对话上下文中，通过元数据智能识别用户意图，仅在需要执行特定功能时，才按需加载对应的核心指令（SKILL.md）及可执行资源（如Python脚本、参考文档）。这种架构在保证模型轻量化响应的同时，显著扩展了其处理复杂、多步骤任务的能力。

华为云码道（CodeArts）代码智能体是一款集代码大模型、AI IDE、Code Agent为一体的智能编码产品。一个理解项目需求，懂得编码之道，善用百器的实干派AI研发砖家，开启你的编码自动驾驶模式。

本案例将基于华为云码道AI IDE集成skill-creator技能，构建SKILL工坊。调用SKILL工坊的能力，生成md-to-word，最后通过该SKILL实现技术博客从Markdown格式到Word格式的高效转换。

说明：

1. 完成Windows版AI IDE华为云码道（CodeArts）代码智能体安装部署和基础配置；
2. 下载并在华为云码道上配置skill-creator；
3. 与码道对话，使用skill-creator生成md-to-word；
4. 与码道对话，使用md-to-word将Markdown格式的文档转化成word格式。

1.4 资源总览

本案例预计花费0元。

资源名称	规格	单价（元）
华为云码道（CodeArts）代码智能体	系统标配	免费

二、环境和资源准备

2.1 AI IDE华为云码道安装部署

参考案例《Windows版AI IDE华为云码道（CodeArts）代码智能体安装部署》完成Windows版AI IDE华为云码道（CodeArts）代码智能体安装部署。

2.2 下载skill-creator

登录GitCode平台下载skill-creator。

2.3 华为云码道配置SKILL

1. 在码道右上角打开设置，进入设置界面后选择技能与规则，在项目级板块下技能的右侧点“+ 新建”。编辑技能名称（样例：skill-creator），然后点确定。

2. 点确定后，系统自动在当前目录下创建.codeartsdoer/skills/skill-creator目录，并在该目录下新建了一个SKILL.md文件。

3. 将“2.2 下载skill-creator”中下载好的zip包解压，并将其内的SKILL.md和scripts替换/拷贝到.codeartsdoer/skills/skill-creator目录下，系统将其自动加载至项目级SKILL。

2.4 skill-creator简介

skill-creator 提供创建有效 skill 的完整指导，帮助 AI 智能体获得特定领域的专业能力。它通过提供工具脚本和详细文档，帮助用户快速创建符合规范的新skill。

skill-creator/
├── SKILL.md                          # SKILL 核心文档，skill-creator 的核心说明文档，提供创建 skill 的完整指导
└── scripts/                          # 工具脚本目录
    ├── init_skill.py                 # 初始化脚本，创建新 skill 的目录结构和模板文件
    ├── package_skill.py              # 打包脚本，验证并打包 skill 为可分发的 zip 文件
    ├── quick_validate.py             # 验证脚本，快速验证 skill 的结构和格式是否符合规范
    └── __pycache__/                  # Python 缓存目录，存储编译后的 Python 字节码，提高脚本执行速度

其他功能说明：

1. 打包 SKILL：创建可分发的 zip 文件。

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   验证 SKILL  │ ──> │  验证通过？   │ ──> │  创建 zip 包  │
└──────────────┘     └──────────────┘     └──────────────┘
                            │
                            │ 失败
                            ▼
                    ┌───────────────┐
                    │ 报告错误并退出  │
                    └───────────────┘

验证内容：YAML frontmatter 格式和必需字段；SKILL 命名约定；描述完整性。

2. 迭代优化：根据使用反馈持续改进。

使用 SKILL ──> 发现问题 ──> 确定改进点 ──> 实施修改 ──> 再次测试
 └────────────────────────────────────────────────────────┘

常见改进方向：补充遗漏的使用场景；优化指令表达；添加新的脚本或参考文档。

三、生成md-to-word文档转化SKILL

3.1 生成md-to-word

skill-creator 配置完成后，返回码道对话界面，在对话框中输入如下内容：

使用skill-creator创建一个skill，将 Markdown 文件转换为 Word 文件的 skill，需要具备以下要求：
1、将该skill命名为'md-to-word'；
2、转化后的字体为简体中文使用微软雅黑字体，正文使用11号字，一级标题使用三号字，二级标题使用四号字，三级标题使用小四号字，四号标题使用五号字； 
3、检查转化后不要出现字体乱码的情况； 
4、在 Markdown 文件中，格式：[CodeArts代码智能体](https://www.huaweicloud.com/product/codeartside/snap.html)，需要将[]中的内容附加（）中的超链接；
5、在 Markdown 文件中，格式：格式<img src="./images/image-2026xxxxxxx.png" width=800px />，将图片从对应目录中复制到word中，大小默认设置为500px；
6、在 Markdown 文件中，格式：<img src="https://fileserve...***.png" width=500px />，将图片下载至./image目录，并将下载至本地的图片复制到word中，，大小默认设置为500px。

码道通过SkillTool调用skill-creator，解析功能需求，并开始自动执行任务。

任务执行过程中，会提示安装python插件，配置python环境，根据系统提示点安装配置即可，若已手动安装配置则跳过此步骤。

码道使用skill-creator自动生成名为md-to-word的SKILL，然后测试，打包。

生成后的md-to-word还不能直接使用，需要手动将其移动至./.codeartsdoer/skills目录下。移动后，系统自动加载配置到项目级技能列表当中。

注：若移动后不能自动生效，请参考“2.3 华为云码道配置SKILL”手动配置SKILL。

3.2 测试md-to-word

准备一篇md格式的技术博客文档，与码道对话：

使用md-to-word将名为"基于AI IDE华为云码道（CodeArts）代码智能体构建SKILL工坊"的Markdown文件转化成Word格式。

码道通过SkillTool调用md-to-word，解析功能需求，并开始自动执行任务。

任务执行完成，可以看到项目资源管理器中已经生成了对应的Word格式的文档。

打开Word文档检查格式，确定是按照所需转化。

用户可以根据转化效果，使用skill-creator继续优化md-to-word，如：字体段落、代码格式、图片、表格美化等。

注：本文中生成md-to-word已上传至gitCode，各位开发者按需下载。

至此，基于AI IDE华为云码道（CodeArts）代码智能体构建SKILL工坊案例结束，各位小伙伴快使用华为云码道（CodeArts）代码智能体体验吧。

反馈改进建议

如您在案例实操过程中遇到问题或有改进建议，可以到论坛帖评论区反馈即可，我们会及时响应处理，谢谢！