码小正， 你的代码格式 AI 校正官

最新案例动态，请查阅码小正， 你的代码格式 AI 校正官。小伙伴们快来进行实操吧！

一、概述

1.1 适用对象

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

1.2 案例时间

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

1.3 案例流程

开发一款自带 “强迫症” 的 AI SKILL，专治代码格式混乱、命名不规范、缩进乱糟糟等问题！不管是 Python 还是 Java 代码，喊一声 “码小正”，就能自动扫描代码里的 “不规矩” 之处，一键格式化到合规标准，还能生成超易懂的问题报告，让你的代码从 “潦草草稿” 变身 “工整范本”，新手也能写出大厂规范的代码。

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

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

说明：

1. 完成Windows版AI IDE华为云码道（CodeArts）代码智能体安装部署和基础配置；
2. 下载并在华为云码道上配置skill-creator；
3. 与码道对话，使用skill-creator生成AI SKILL；
4. 加载AI SKILL，对单文件 / 整个项目执行检查与格式化，生成检查报告并展示问题。

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 ──> 发现问题 ──> 确定改进点 ──> 实施修改 ──> 再次测试
 └────────────────────────────────────────────────────────┘

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

三、生成ma-shang-he-gui文档转化SKILL

3.1 生成【码上合规】

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

使用 skill-creator 创建一个代码规范检查与自动格式化 SKILL，名称为 ma-shang-he-gui（对外展示名：码上合规）。
功能要求：
1. 支持 Python（PEP8）和 Java（Google Java Style）。
2. 可检查单个文件，也可批量检查整个项目。
3. 自动修复：缩进、空行、引号、逗号、命名风格。
4. 输出结构化检查报告，包含文件、行号、问题、建议。
5. 提供简单配置开关，可开启/关闭某类规则。
6. 脚本放在 scripts 目录，配置放在 config 目录。

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

SKILL 目录结构：

ma-shang-he-gui/
├── SKILL.md           # 技能说明、使用指令（标注对外展示名：码上合规）
├── config/            # 检查规则配置
│   ├── python_config.yaml
│   └── java_config.yaml
├── references/        # 规范文档
└── scripts/
    ├── check.py       # 代码检查主逻辑
    ├── format.py      # 自动格式化
    ├── report.py      # 生成报告
    └── main.py        # 统一入口

注：若涉及变更文件，请点击全部变更。
任务执行过程中，会提示安装python插件，配置python环境，根据系统提示点安装配置即可，若已手动安装配置则跳过此步骤。

码道使用skill-creator自动生成名为ma-shang-he-gui（码上合规）的SKILL，然后测试，打包。

若在生成过程中出现问题，可再次向智能体提出要求继续完成内容生成。

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

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

3.2 测试ma-shang-he-gui【码上合规】

准备一个Python或者Java的不规范代码文件，与码道对话：

码上合规，批量检查当前项目中text.py 文件，按PEP8规范列出所有违规点，然后对有问题的文件自动格式化，最后生成整改报告。

码道通过SkillTool调用ma-shang-he-gui【码上合规】，解析需求描述，并开始自动执行任务。

任务执行完成，可以看到项目资源管理器中已经生成了修改后正确的Python文件。

打开“执行总结.md”可以看到该文件的所有修改结果。

用户可以根据转化效果，使用skill-creator继续优化ma-shang-he-gui【码上合规】，对其他代码语言进行检测。

注：本文中不规范代码文件示例与生成的ma-shang-he-gui【码上合规】已上传至gitCode，各位开发者按需下载。

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

反馈改进建议

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