目录

常用配置

DevEco Code支持在deveco.jsonc文件中配置绿灯模式、Skill、MCP的相关能力。

deveco.jsonc文件在项目和用户目录下各有一份，若不存在需新建该文件，优先级如下：

新增/修改Skill、MCP配置后，需关闭并重启DevEco Code。

配置绿灯模式

启用绿灯模式后，所有工具调用将自动执行，无需逐次确认。默认关闭。

在本地查找和编辑deveco.jsonc文件，若不存在需新建。

{
  "$schema": "https://opencode.ai/config.json",
  "permission": "allow"
}

配置MCP

模型上下文协议（Model Context Protocol，简称MCP）可用于连接浏览器、数据库等第三方服务。

在本地查找和编辑deveco.jsonc文件配置MCP，若不存在需新建。

示例：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "playwright": {
      "type": "local",
      "command": ["npx", "@playwright/mcp@latest"],
      "enabled": true
    }
  }
}

配置Skill

在DevEco Code对话框输入/skills可查看所有Skill。DevEco Code已内置部分Skill，最新版本内置Skill如下。同时，也支持自定义创建Skill。

内置Skill名称

描述

hmos-design-to-arkts

将Pixso设计稿转换为ArkTS页面代码，自动完成设计稿解析、工程理解、方案设计、页面实现、交互补全、HDS（HarmonyOS Design System）组件适配、质量审计与多轮视觉校准。

hmos-dfx-analyzer

DFX故障分析。

hmos-arkui-develop-skill

编写、审查或改进ArkUI代码，遵循状态管理(V1/V2)、组件结构、布局选择、性能优化的最佳实践。

deveco-cli

在HarmonyOS应用开发中使用devecocli命令。语言描述中出现HarmonyOS、UI测试、组件调试等场景时，支持调用devecocli命令。

customize-deveco

编辑、创建DevEco Code的配置文件或权限规则等，如deveco.jsonc。

[h2]创建自定义Skill

编写frontmatter

Skill文件命名固定为SKILL.md，每个SKILL.md必须以YAML frontmatter开头。

frontmatter通过如下字段进行识别，超出字段会被忽略。

SKILL.md中正文指令长度不超过32768个字符。

放置文件

创建一个与name同名的文件夹，将SKILL.md放到指定路径，DevEco Code启动时会自动扫描并解析 。

DevEco Code扫描以下位置的Skill：

  • 以上用户级配置以Windows为例，如果是macOS/鸿蒙电脑环境，需要把路径中的C:/Users/用户名替换为~。
  • SKILL.md所在文件夹大小不超过100MB。

示例：

创建.deveco/skills/release/SKILL.md，内容如下。

---
name: release
description: Create consistent releases and changelogs
license: MIT
compatibility: deveco
metadata:
  audience: maintainers
  workflow: github
---

## What I do

- Draft release notes from merged PRs
- Propose a version bump
- Provide a copy-pasteable `gh release create` command

## When to use me

Use this when you are preparing a tagged release.
Ask clarifying questions if the target versioning scheme is unclear.

[h2]配置访问Skill权限

在deveco.jsonc文件中使用权限来控制Agent可以访问哪些Skill。

配置时支持通配符，如internal-*可匹配internal-docs、internal-tools等。

{
  "permission": {
    "skill": {
      "*": "allow",
      "pr-review": "allow",
      "internal-*": "deny",
      "experimental-*": "ask"
    }
  }
}

权限

行为

allow

Skill立即加载

deny

对Agent隐藏Skill，拒绝访问

ask

加载前提示用户确认

[h2]按Agent覆盖权限

在deveco.jsonc文件中为Agent授予与全局默认值不同的权限。

{
  "agent": {
    "plan": {
      "permission": {
        "skill": {
          "internal-*": "allow"
        }
      }
    }
  }
}

[h2]禁用Skill工具

在deveco.jsonc中为Agent添加禁用Skill功能。

{
  "agent": {
    "plan": {
      "tools": {
        "skill": false
      }
    }
  }
}

查看Skill时，如果某个Skill没有显示，可以从如下方面排查：

  • 确认SKILL.md文件名是否为全大写字母。
  • 检查frontmatter是否包含name和description。
  • Skill名称在所有路径中是否唯一。
  • 检查权限设置是否设置为deny。