技能（Skill）是一种能力封装机制，用于将专业知识（如编码经验、常见问题、解决方案等）组织为可复用的模块。技能本质为由指令集、执行脚本与配套资源组成的标准化能力单元，以SKILL.md为核心配置文件，搭配可选捆绑资源构成结构化目录，整合特定任务所需的知识与工具。其核心价值是华为云码道CodeArts代码智能体可以按需动态加载技能包，精准适配多类研发场景，有效提升专项开发任务的执行能力、运行稳定性与整体研发效率。

技能的目录结构参考如下： 

skill-name/

├── SKILL.md (必填)

│     ├── YAML frontmatter 元数据 (必填)

│     │     ├── name: (必填)

│     │     └── description: (必填)

│     └── Markdown 指令 (必填)

└── Bundled Resources/ 捆绑资源 (选填)

       ├── scripts/ - 可执行代码 (Python/Bash 等)

       ├── references/ - 旨在根据需要加载到上下文中的文档

       └── assets/ - 输出中使用的文件 (模板、图标、字体等)

在软件开发过程中，开发者需频繁处理代码重构、测试用例生成、文档编写、部署配置等复杂且重复的专业任务。这些任务往往涉及多个工具的协同操作和特定领域的专业知识，传统方式下需要开发者手动编排步骤、查阅文档、反复调试，不仅耗时耗力，还容易因经验不足导致错误或遗漏。

随着开发场景的复杂化，不同技术栈、不同业务领域对专业能力的需求日益多样化。开发者难以全面掌握所有领域的最佳实践，而团队内部的经验传承也面临知识流失和标准不一的问题。新技术的快速发展带来了大量新兴工具和方法，开发者需要快速学习和应用这些新能力，但学习曲线陡峭、实践成本高昂。

华为云码道CodeArts代码智能体已内置多个技能，开箱即用，开发者无需深入了解底层细节，快速提升开发效率。若需定制专属技能，提供多种添加方式，支持手动新建或导入已有文件，灵活高效，助您轻松扩展开发能力。技能添加成功后，开发者只需调用相应技能，智能体即可自动规划执行路径、协调工具资源、完成专业操作，将复杂任务简化为一次调用，有效降低开发技术门槛。

 

• 专业封装：技能内置特定领域的最佳实践和专业知识，经过验证和优化，确保执行结果符合行业标准和质量要求，降低因经验不足导致的错误风险。

• 动态加载：技能按需加载到上下文中，减少上下文占用，智能体根据任务需求自动识别并调用合适的技能，实现资源的灵活调度和高效利用。

• 可复用性：技能采用结构化封装，支持跨项目、跨团队共享复用，避免重复造轮子，促进知识沉淀和团队协作，提升整体研发效能。

• 灵活定制：技能支持参数配置、指令扩展和资源绑定，开发者可根据实际需求调整技能行为，适配个性化场景，满足多样化的开发要求。

• 标准化管理：技能具备统一的目录结构和参数规范，支持版本控制、权限管理和生命周期管理，便于企业统一管控和持续优化。

 

场景一：代码开发与重构

开发者在进行日常编码或代码重构时，面对复杂的业务逻辑实现、设计模式应用或代码规范调整，往往需要查阅大量文档并反复尝试。使用代码开发类技能后,开发者只需描述功能需求或重构目标，技能自动分析现有代码结构，生成符合规范的实现方案或重构建议，确保代码质量和一致性，大幅缩短开发周期并降低技术债务。

场景二：测试用例生成与质量保障

测试工程师在面对大型项目或复杂业务逻辑时，手动编写测试用例工作量大、覆盖面难以保证，容易出现边界条件遗漏和异常场景缺失。使用测试类技能后，技能自动分析被测代码的结构和逻辑，生成覆盖边界条件、异常场景的全面测试用例，并提供覆盖率分析，提升测试效率和代码质量保障能力，缩短测试周期。

场景三：文档编写与知识管理

技术文档编写需要遵循特定格式、覆盖完整内容并保持与代码同步更新，这项工作繁琐且容易滞后，影响团队知识传承和项目可维护性。使用文档类技能后，技能根据代码结构、API定义和项目信息自动生成文档框架和内容，支持多种文档格式和规范，减轻文档维护负担，提升文档质量和时效性，促进知识沉淀。

场景四：运维部署与环境管理

运维团队在处理多环境部署、配置管理和故障排查时，需要协调多个工具并执行一系列标准化操作，步骤繁琐且容易出错，影响环境一致性和业务稳定性。使用运维类技能后，技能自动执行部署流程、配置检查和日志分析，提供标准化操作路径和异常处理建议，保障环境一致性，缩短部署时间，提升运维效率。

场景五：数据分析与报表生成

数据分析师在处理Excel、CSV等数据文件时，需要编写查询语句、执行统计分析和生成可视化报表，工作重复且对SQL技能要求较高。使用数据分析类技能后，技能通过自然语言理解分析需求，自动生成SQL查询、执行数据处理并输出分析结果，降低技术门槛，提升数据分析效率，使非技术人员也能快速完成数据洞察。

 

技能的运行从用户发起调用或智能体自动识别触发开始。用户可通过直接输入技能名称、使用“/”命令或在对话中描述任务需求来触发技能调用。智能体根据任务描述自动匹配适用的技能，加载技能定义并执行相应操作。

图1 技能的工作原理

 

步骤一：技能识别与匹配

智能体分析用户输入的任务描述或显式的技能调用指令，识别需要使用的技能。对于显式调用，智能体直接定位目标技能；对于隐式调用，智能体根据技能的描述信息和适用场景进行语义匹配，选择最合适的技能。匹配成功后，智能体准备加载技能。

步骤二：技能加载与解析

执行引擎根据技能的作用范围和存储位置，从本地目录或云端平台加载技能定义文件SKILL.md和所需的资源文件。引擎解析YAML元数据获取技能名称和描述，解析Markdown指令理解执行步骤和参数要求，同时加载References目录下的参考文档到上下文中，为后续执行做准备。

步骤三：指令执行与工具调度

执行引擎按照技能指令中定义的步骤逐步执行操作。每个步骤可能涉及文件读写、代码分析、脚本执行、API调用等具体操作，引擎通过工具集成层调度相应的工具完成。执行过程中，引擎根据中间结果动态调整后续步骤，处理条件分支和循环逻辑，确保执行流程的适应性。

步骤四：资源调用与结果整合

在执行过程中，技能可调用scripts目录下的可执行脚本完成确定性操作，使用assets目录下的资源文件作为输出模板或素材。各步骤的执行结果逐步累积，引擎整合所有中间结果，按照技能定义的输出规范生成最终结果。结果可能包括生成的代码、文档、报告、配置文件等具体产出物。

步骤五：结果返回与资源释放

执行完成后，引擎将最终结果返回给用户或智能体，同时在聊天界面展示执行过程和关键信息。技能加载的参考文档、中间状态等资源从上下文中释放，避免占用过多空间。执行日志和状态信息记录到后台，便于后续追溯和优化。

 

 

技能（Skill）是由指令、脚本或资源封装而成的可复用能力模块。规则（Rule）是自定义约束配置，用于规范智能体行为，使其更准确地理解并严格遵循相关规范。两者的共同点都是华为云码道CodeArts代码智能体用于增强智能体能力的机制，通过赋能与约束规范AI行为，优化输出效果，助力提升开发效率。

表1 技能与规则的对比

对比维度	技能（Skill）	规则（Rule）
定义	用于描述如何完成特定任务。	用于约束智能体的行为方式。
加载方式	按需加载，减少上下文占用。	在对话开始时加载到上下文中，持续参与推理。
使用场景	封装测试流程、开发任务、复杂业务逻辑等。 例如：执行UI自动化测试。	定义代码规范、输出格式、团队协作约定等。 例如：代码必须符合PEP8规范。
关键区别	解决“如何完成任务”，是流程指导。	控制智能体“应该怎么做”，是行为边界。

  

华为云码道CodeArts代码智能体的技能按创建方式可分为本地与云端，按作用范围可分为企业级、团队级、项目级和个人级。用户可根据具体开发场景与协作需求，选择最适合的技能进行设置，实现灵活高效的代码管理。

若存在名称相同的技能，智能体调用技能的优先级为：云端企业级 > 云端团队级 > 本地项目级 > 本地个人级 > 云端个人级 > 系统内置。

表2 技能分类

创建方式	作用范围	说明
本地	项目级	仅针对当前项目生效，存储在本地。 存储路径：项目根目录的“./.codeartsdoer/skills/”
	个人级	针对当前用户下的所有项目生效，存储在本地。 存储路径：本地“%USERPROFILE%/.codeartsdoer/skills”
云端	企业级	企业统一的技能，整个企业所有成员都可用，由企业管理员创建，存储在云端。
	团队级	团队统一的技能，指定的团队可用。由企业管理员或团队管理员创建，存储在云端。
	个人级	仅成员本人可用，存储在云端。

 

华为云推出华为云码道CodeArts代码智能体，配套完善的技能全生命周期管理体系，覆盖技能创建、管理和使用能力；同时支持本地和云端两种技能形态，划分企业级、团队级、项目级和个人级四种作用范围，满足不同场景的专业能力封装需求。用户可结合自身业务场景，实现对既有技能的精细化管控与持续优化。

华为云码道CodeArts代码智能体内置多个系统技能，开箱即用，可快速提升开发效率。提供多种途径添加技能，灵活高效拓展开发能力，更多信息请参见技能。

基于华为云码道代码智能体的技能，开发者能够快速获得专业领域的最佳实践，无需从零学习和环境配置，显著缩短上手时间。企业可通过企业级技能统一推广开发规范和最佳实践，保障代码质量和团队一致性。团队和项目可通过团队级、项目级技能封装特定工作流，减少重复劳动，提升协作效率。开发者可通过个人级技能自定义专属开发配置，打造个性化研发环境。智能体可按需动态加载技能，从而提升特定任务的执行能力与执行效率。

技能快速体验入门指引：

• 如需了解技能封装方法，更多信息请参见如何写好一个Skill。

• 使用技能市场中提供的技能创建器（skill‑creator），快速生成专属的PDF拆分Skill，更多信息请参见使用技能创建器生成PDF按章节拆分Skill。