技能

华为云码道支持通过npx命令安装个人级或项目级技能。

1. 参考官方文档，安装Node.js、npm。
   安装完成后，在终端中执行如下命令，验证Node.js、npm是否安装成功。

   npx -v

   回显信息中显示版本号，表示已成功安装Node.js和npm。

   图1 安装成功的回显信息

   

2. 执行如下命令，安装技能。
   本步骤以安装个人级的vercel-react-best-practices技能为例进行介绍。

   npx skills add https://github.com/vercel-labs/agent-skills --skill vercel-react-best-practices -a codearts-agent

   其中，https://github.com/vercel-labs/agent-skills为待安装技能包所在的地址，vercel-react-best-practices为待安装技能的名称。

3. 选择技能的作用范围（Project为项目级技能，Global为个人级技能），此处以个人级技能为例。
   图2 选择技能的作用范围

   

4. 根据提示，选择Yes并继续回车，等待技能安装完成。
   提示“Installed 1 skill”回显信息时，说明技能安装成功。

   图3 安装成功的回显

   

5. 查看已安装的技能。
   • 进入本地“%USERPROFILE%/.codeartsdoer/skills”目录下，可查看到目标技能vercel-react-best-practices。
     图4 检查技能是否存在
     
   • 在华为云码道IDE设置页面的“技能与规则 > 个人级”页签中，可查看到目标技能vercel-react-best-practices，且状态为已开启。
     图5 在IDE中确认技能已启用

     

6. 使用技能。
   在华为云码道聊天窗口的输入框中，输入以下内容，单击发送图标 。

   使用vercel-react-best-practices技能重构代码

   返回如下信息，说明技能已被成功调用，AI将通过此技能重构该项目下的React和Next.js代码。

   图6 使用技能重构代码

   

市场上已上线多款开箱即用的技能，可帮助您快速提升开发效率。以下将介绍如何查找并添加这些技能。

1. 参考快速启动操作，登录华为云码道。
2. 单击华为云码道IDE右上角的设置图标 ，进入华为云码道IDE全局设置页面。
3. 在左侧导航栏中单击“技能与规则”，进入“全部已安装”页面。
4. 在“市场”页签中，查找技能。

   表4 查找技能

   查找方式	具体步骤
   来源	市场中的技能主要来源于官方和优选。 官方：华为云码道提供的技能。 优选：经筛选的第三方技能。 在页面顶部的“全部来源”下拉框中，选择技能的来源，查看对应来源的技能列表。您还可以在搜索框中输入技能名称或者关键字快速查找技能。
   名称	在页面右上角单击“按名称”后的排序图标，按名称排序查找技能。
   更新时间	在页面右上角单击“最近更新”后的排序图标，按更新时间排序查找技能。

5. 添加技能。
   1. 通过以下任一方式，弹出选择技能安装位置对话框。
      • 在指定技能后，单击添加图标 。
      • 单击指定技能的名称，进入技能详情页面。在技能详情页右上角，单击“添加”。

      若已创建/导入的技能名称和市场中已有技能重名，该技能在市场中将显示为“已安装”。

   2. 选择该技能的安装位置（项目级或个人级），单击“确定”。

      安装成功后，该技能后的 变为“已安装”。

6. （可选）根据实际场景，执行更新技能、修改技能安装位置和卸载技能的操作。

   表5 管理技能

   操作	具体步骤
   更新技能	若已创建/导入的技能名称和市场中已有技能重名，且二者版本不同，该技能在市场中将显示为“已安装”且“待更新”。若执行更新操作，会以市场中技能的内容覆盖原先的内容。 通过以下任一方式，更新技能。 将鼠标悬浮在待更新技能上，单击更新图标 。更新成功后，该技能右上角的“待更新”标识将自动消失。 单击待更新技能的名称，进入技能详情页面。在右上角单击“更新”。更新成功后，该技能右上角的“待更新”标识将自动消失。
   修改技能安装位置	单击待修改安装位置的技能名称，进入技能详情页面。 在右上角单击技能安装位置（项目级/个人级），在弹出对话框中选择目标安装位置。 当技能安装位置由原先位置变为修改后的位置时，表示修改成功。
   卸载技能	通过以下任一方式，卸载技能。 将鼠标悬浮在待卸载技能上，单击卸载图标 。卸载成功后， 变为 。 单击待卸载技能的名称，进入技能详情页面。在右上角单击“卸载”。卸载成功后，右上角“卸载”和“项目级”/“个人级”按钮变为“添加”。

为当前项目定制的技能，随代码库一并分发。本地项目级技能创建后立刻生效，何时使用由智能体决定。

1. 参考快速启动操作，登录华为云码道。
2. 单击华为云码道IDE右上角的设置图标 ，进入华为云码道IDE全局设置页面。
3. 在左侧导航栏选择“技能与规则”，进入“全部已安装”页面。
4. 在“项目级”页签中，单击技能后的 ，进入创建技能页面。
5. 参考表6设置本地项目级技能参数。

   表6 本地项目级技能参数说明

   参数	说明
   Skill名称	新建项目级技能的名称，例如data-cleaner-skill。 命名规则：由小写字母、数字和连字符（-）组成，开头和结尾不能是连字符，且连字符不可连续使用，长度1~64字符。
   Skill描述	技能的描述信息，长度不超过1024字符。
   指令	技能的指令，用于详细说明技能的使用方法、参数、示例和依赖等。长度不超过50000字符。

6. 单击“确定”，完成技能的创建。

   在“项目级”页签中，可以查看到新创建的本地项目级技能。技能创建完成后默认处于开启状态，其文件存储于项目根目录的“./.codeartsdoer/skills”。

根据您的使用习惯和偏好设定个人级技能，华为云码道将始终遵循这些技能，在所有项目中为您提供更贴合个人风格的输出。本地个人级技能创建后立刻生效，何时使用由智能体决定。

1. 参考快速启动操作，登录华为云码道。
2. 单击华为云码道IDE工具右上角的设置图标 ，进入华为云码道IDE全局设置页面。
3. 在左侧导航栏选择“技能与规则”，进入“全部已安装”页面。
4. 在“个人级”页签中，单击技能后的 ，进入创建技能页面。
5. 参考表7设置本地个人级技能参数。

   表7 本地个人级技能参数说明

   参数	说明
   Skill名称	新建个人级技能的名称，例如data-validator-skill。 命名规则：由小写字母、数字和连字符（-）组成，开头和结尾不能是连字符，且连字符不可连续使用，长度1~64字符。
   Skill描述	技能的描述信息，长度不超过1024字符。
   指令	技能的指令，用于详细说明技能的使用方法、参数、示例和依赖等。长度不超过50000字符。

6. 单击“确定”，完成技能的创建。

   在“个人级”页签中，可以查看到新创建的本地个人级技能。技能创建完成后默认处于开启状态，其文件存储于本地的“%USERPROFILE%/.codeartsdoer/skills”。

将已获取的本地技能包导入到本地华为云码道中，即可便捷地调用和使用相关功能。

导入前，请对照技能的目录结构及编写SKILL.md中内容，验证技能包是否符合标准。例如，每个技能文件夹的根目录均须包含对应的SKILL.md文件，此文件中须包含YAML格式的技能名称与描述等。如果技能包不符合规范，请调整后再导入，否则可能会导入失败。

1. 参考快速启动操作，登录华为云码道。
2. 单击华为云码道IDE右上角的设置图标 ，进入华为云码道IDE全局设置页面。
3. 在左侧导航栏单击“技能与规则”，进入“全部已安装”页面。
4. 在“项目级”或“个人级”页签中，单击技能后的“ > 导入”。
5. 在“上传”对话框中，选择本地的技能zip包，单击“确定”。
   

   每次仅支持上传一个zip包，包内可存放多个技能文件夹，且包的总大小不能超过5M。

   导入成功后，技能名称将显示在技能列表中。

   例如：如需一次性导入“docx”和“pptx”两类技能至华为云码道，可将两类技能文件夹放入同一个zip包中，再上传该zip包，即可实现批量上传功能。

   图7 批量上传多个技能
   

仅创建者可编辑、删除、启用及禁用技能。