目录

配置Skill

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

DevEco Code支持导入Global Skills和Project Skills两种。其中,Global Skills支持当前用户在本地所有项目中使用,不可跨设备同步;Project Skills仅适用于当前项目。开发者根据业务需要选择导入对应的Skills。

Skill的结构

Skill实际是一个包含SKILL.md文件的文件夹,在SKILL.md文件中以自然语言描述技能的名称、触发条件和执行步骤,定义自动化工作流。

SKILL.md文件写作时,严格遵循业界YAML Frontmatter(元数据) + Markdown Body(正文) 的统一规范,以及要确保内容结构清晰、触发词准确、没有错误处理,提升Skill可维护性和可复用性,使Agent能够稳定执行。

Skill目录结构

一个Skill中须包含SKILL.md文件,还可以根据实际需求添加其他文件,例如开发指南和API参考资料、可执行代码等。

<name>/                              # 技能根目录
│
├── SKILL.md                         # 【必填】技能的唯一入口文件
├── references/                      # 【可选】开发指南和API参考资料,帮助工具生成精准内容
│   ├── ref1.md
│   └── ref2.md
├── scripts/                         # 【可选】用于确定性、可靠性要求高或被反复重写的任务的可执行代码
│   └── helper.sh
├── assets/                          # 【可选】生成输出时的引用文件,如PPT模板
│   └── template.txt
└── 其他文件/文件夹                    # 【可选】其他更多文件/文件夹

SKILL.md文件格式

---
name:必填,技能名称
description:必填,简要描述这个技能的功能和使用场景
when_to_use:选填
license:选填
metadata:选填
---

# 技能名称

正文指令内容...              

操作步骤

  1. 点击DevEco Code界面Menu中的Skill卡片,或点击菜单栏File > Settings > AI > Skills,进入配置页面。

  2. 在Global Skills或Project Skills下,点击导入Skill文件夹或文件夹的压缩包(.zip格式),点击删除。SKILL.md的父目录为技能根目录。

  3. 在Global Skills和Project Skills列表中,显示已导入的技能信息,包括启用状态、技能名称、描述信息(最多显示60字符)。

  4. 返回DevEco Code,在输入框输入"/"可以查看所有的Skills,选择对应Skill后进行问答。