技能（Skills）配置
============

#### 功能介绍

在日常工作中，我们经常需要处理重复性任务，如调整文档结构、撰写周报告等，每次都需要输入格式要求、偏好、操作流程，这种模式不仅耗时，也容易遗漏关键细节。Skills是一份标准化的教程，会指导CodeGenie面对任务时如何思考、遵循什么步骤、输出什么格式、注意事项是什么。开发者只需要定义一次，CodeGenie便能在后续的每次对话中自动识别并应用，实现“一次定义，长期稳定复用”效果。

Skills实际是一个包含SKILL.md文件（区分大小写）的文件夹，在SKILL.md文件中以自然语言描述技能的名称、触发条件和执行步骤，让开发者能快速定义自动化工作流。SKILL.md文件写作时，严格遵循业界YAML Frontmatter（元数据） + Markdown Body（正文） 的统一规范，以及要确保内容结构清晰、触发词准确、没有错误处理，提升Skill可维护和可复用性，使Agent能够稳定执行。

从DevEco Studio 6.1.0 Release（6.1.0.830）版本开始，CodeGenie支持导入Global Skills（全局技能）和Project Skills（项目技能）两种。其中，Global Skills支持当前用户在本地所有项目中使用，不可跨设备同步；Project Skills适用于当前项目。开发者根据业务需要导入对应的Skills。

#### \[h2\]使用约束

*   当前自定义Agent和HarmonyOS Act智能体支持使用Skills。
*   SKILL.md中name的要求：长度不超过64个字符，由小写字母，数字、中划线组成，不能以-开头或结尾，不能包含连续的-，与所在文件夹命名一致。
*   SKILL.md中description的要求：长度不超过1024个字符。
*   SKILL.md中正文指令的要求：长度不超过32768个字符。
*   SKILL.md所在文件夹的要求：大小不超过100MB。

#### 操作步骤

1.  点击界面右上方![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/10/v3/3fTFu9LLTiOeo94zFutOuw/zh-cn_image_0000002594475042.png?HW-CC-KV=V1&HW-CC-Date=20260612T073831Z&HW-CC-Expire=86400&HW-CC-Sign=D2641D7C27313E44F36F05F2014FC93D8B63EE88CE6A36B493364FE94C24936C "点击放大")按钮，或者点击界面右上方**Settings**![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a0/v3/D3xlRT8EQDGSl2TZ1S4GIw/zh-cn_image_0000002594475038.png?HW-CC-KV=V1&HW-CC-Date=20260612T073831Z&HW-CC-Expire=86400&HW-CC-Sign=9D890AA292296ACFAD73F27951DB817F64451C4F8AB3A3BAA940A40618B33A0F)按钮，选择**Skills**，进入配置页面。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/af/v3/04dhnrPpSkmBa1rAeh_MKQ/zh-cn_image_0000002625074541.png?HW-CC-KV=V1&HW-CC-Date=20260612T073831Z&HW-CC-Expire=86400&HW-CC-Sign=FFE2E912DB8E82F281E94F3C24D699306E974CD4EB0988D1D0FEF59F0C721AE4 "点击放大")
    
2.  在**Global Skills**或**Project Skills**下，首次导入时，点击**Import**导入技能文件；若已存在技能文件，点击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c2/v3/F6ZK98PORz6Tgss6kz-NsQ/zh-cn_image_0000002624994399.png?HW-CC-KV=V1&HW-CC-Date=20260612T073831Z&HW-CC-Expire=86400&HW-CC-Sign=775B406925D5B88F4B3D360474C18FC631C7264BB4952E02BBFA56A8704A6EA0 "点击放大")按钮进行导入。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/65/v3/UBhEO7m-Tm2RC093MjNFsQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073831Z&HW-CC-Expire=86400&HW-CC-Sign=C4C20C5C4F52635954FEA722DD19F0247D39A782085C799A585355B71EA461B8)
    
    *   若选择的文件夹中存在SKILL.md，则作为单个skill导入。
    *   若选择的文件夹中不存在SKILL.md，则遍历下一级文件夹，检查下一级文件夹中是否包含SKILL.md，遍历到的SKILL.md将作为skill导入。若下一级文件夹遍历出多个SKILL.md，将批量导入。仅支持遍历所选择文件夹的下一级，不支持更深层级的遍历。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/44/v3/8f1D7WsWT2qGLXKOQ8fP-w/zh-cn_image_0000002624994403.png?HW-CC-KV=V1&HW-CC-Date=20260612T073831Z&HW-CC-Expire=86400&HW-CC-Sign=5818A9FAC4DD2D8C925454E44D0F82DDD21DAE916B4CD52239EAEE2A7E572CB6 "点击放大")
    
3.  在**Global Skills**和**Project Skills**列表中，显示已导入的技能信息，包括技能名称（如openharmony-build）、描述信息、启用状态。同时，将鼠标悬浮在技能信息上会显示编辑和删除的操作按钮，点击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ce/v3/1ZfPmS5OTW2HYq7gNlyf2A/zh-cn_image_0000002594634962.png?HW-CC-KV=V1&HW-CC-Date=20260612T073831Z&HW-CC-Expire=86400&HW-CC-Sign=FEF8C4768566C9AA80E3ED83B7F1255EBEDDF174745555A8E5AA51B363476DCA)可在代码编辑区打开SKILL.md文件。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/da/v3/LjBMF1G5QWOWLhX4qHRCgQ/zh-cn_image_0000002625074537.png?HW-CC-KV=V1&HW-CC-Date=20260612T073831Z&HW-CC-Expire=86400&HW-CC-Sign=5D62601C9B447147FDC6713F87278525B3228B357597CB65C1EA66ACEAD703E0 "点击放大")
    
4.  返回CodeGenie对话框调用Skills，在对话框输入时需要带有技能的name（如openharmony-build）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c7/v3/RkEREvl-QwirERave4ITCg/zh-cn_image_0000002594475040.png?HW-CC-KV=V1&HW-CC-Date=20260612T073831Z&HW-CC-Expire=86400&HW-CC-Sign=C78FABFFB360989BE9376F52CFD5F9471EA0DA79354536996F9EB32583872381)