1. DevEco Code 装 Skill 到底卡在哪目录放置与 Prompt 安装的真实场景DevEco Code 是华为面向鸿蒙生态推出的 AI 编程助手它兼容 OpenCode 生态里的 Skill、MCP 和 Plugin 扩展方式。Skill 你可以理解成给 AI 助手加装的“能力包”——装上代码审查 Skill它就多一套审查规则装上文档生成 Skill它就能按模板产出接口说明。适合谁适合已经在用 DevEco Code 写 HarmonyOS 应用、但觉得默认能力不够用的开发者尤其是想让 AI 按团队规范干活的同学。问题出在安装环节。我见过太多人卡在同一个地方Skill 压缩包下载了解压了往目录里一扔重启 DevEco Code输入/skill一看——空的。或者用 SkillHub 复制了安装 Prompt发给 DevEco Code它回你一段“已为你创建文件”结果去~/.config/deveco/skills一看啥也没有。这两个坑的根因不一样。目录放置失败八成是文件结构多套了一层比如解压出来是my-skill/my-skill/SKILL.md而 DevEco Code 只认skills/my-skill/SKILL.md。Prompt 安装失败往往是模型没真正执行写文件操作只是“说”它写了。还有一种情况是npx skills add命令直接报错这个我在 OpenCode 生态里也遇到过跟网络环境和包管理器版本都有关系。所以这篇不绕弯子直接把两种方案拆开讲目录放置怎么放、Prompt 安装怎么发、装完怎么验证、报错怎么查。同时把 TaoToken 统一 Key 通道的配置也带上因为 Skill 调用模型时如果 Key 没配好你会看到一堆 401误以为是 Skill 没装上。先把凭证通道理顺再装 Skill排障会轻松很多。2. TaoToken 统一 Key 通道前置配置Base URL、Key 与 Model ID 三件套在装 Skill 之前先把模型调用通道配好。DevEco Code 兼容 OpenCode 的配置体系模型接入走的是 OpenAI 兼容协议。TaoToken 提供统一的 API 通道你只需要拿到一个 Key就能在多个工具里复用不用每个工具单独申请。先拿 Key。打开 TaoToken 控制台进入 API Keys 页面创建一个新 Key。地址是https://taotoken.net/api-keys创建时给它起个能认出来的名字比如deveco-skill。复制出来的 Key 形如sk-xxxxxxxx只显示一次先存到安全的地方。然后是 Base URL。TaoToken 的 API 入口是https://taotoken.net/api注意这里不加任何查询参数。在 DevEco Code 或 OpenCode 的配置里Base URL 填这个地址不要填带/v1的变体除非文档明确要求。Model ID 这块TaoToken 支持多种模型你在控制台的模型列表里能看到可用型号。填的时候用模型的实际 ID比如claude-sonnet-4-20250514这种格式。三件套凑齐Base URL Key Model ID缺一个都会导致 Skill 调用时静默失败。如果你用的是 Claude Code 类的配置方式配置文件通常在~/.claude/settings.json或项目级的.claude/settings.json。DevEco Code 的配置路径类似在~/.config/deveco/下面。下面给一个可复制的 JSON 片段路径和字段名按你本地实际文件来{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }如果你用的是 OpenCode 的opencode.json或config.toml写法略有不同。TOML 版本大概长这样[provider.taotoken] baseURL https://taotoken.net/api apiKey sk-你的Key model claude-sonnet-4-20250514配完之后先别急着装 Skill。用一条最简单的请求验证通道是否通。在终端里跑curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-20250514,messages:[{role:user,content:ping}]}如果返回里有choices字段和正常内容说明 Key 和 Base URL 没问题。如果返回 401检查 Key 是否复制完整、有没有多余空格。如果返回local proxy failed说明你的请求没走到 TaoToken检查 Base URL 是不是被本地代理拦截了。这一步过了再进 Skill 安装排障范围会小很多。3. 目录放置方案skills 文件夹结构、SKILL.md 与重启验证目录放置是最稳的方式因为整个过程你完全可控。核心就一句话把 Skill 文件夹放到~/.config/deveco/skills/下面确保文件夹里直接就是SKILL.md不要多套层级。先确认目录存在。打开终端ls -la ~/.config/deveco/如果看不到skills文件夹手动建一个mkdir -p ~/.config/deveco/skills然后把你下载的 Skill 压缩包解压。假设压缩包叫code-review-skill.zip解压后得到一个文件夹。关键来了进去看看结构。正确的结构应该是~/.config/deveco/skills/ └── code-review-skill/ ├── SKILL.md ├── prompts/ │ └── review.md └── config.json如果你解压出来是code-review-skill/code-review-skill/SKILL.md那就多了一层需要把内层文件夹移上来mv ~/.config/deveco/skills/code-review-skill/code-review-skill/* ~/.config/deveco/skills/code-review-skill/放好之后退出 DevEco Code重新启动。注意是完全退出不是关窗口。重启后输入/skill如果列表里出现了code-review-skill说明加载成功。再进一步实际调用一次。在对话里输入类似/skill code-review-skill 帮我审查当前文件的错误处理逻辑如果 Skill 正常响应你会看到它按 Skill 定义的规则输出审查结果。如果/skill列表里没有先检查文件夹名和SKILL.md是否存在。如果列表里有但调用没反应检查SKILL.md里的触发条件是否写对了。这里有个细节Skill 的SKILL.md里通常有 frontmatter定义 name、description、trigger 等字段。如果 name 字段和文件夹名不一致某些版本会以 frontmatter 为准。所以改文件夹名的时候顺手把SKILL.md里的 name 也改一致省得后面排查。4. Prompt 安装方案SkillHub 复制、发给 DevEco Code 与目录复查Prompt 安装适合快速试装。你在 SkillHub 上看到某个 Skill不想手动下载解压直接复制它的安装 Prompt发给 DevEco Code让它帮你写文件。第一步在 SkillHub 找到目标 Skill点右侧的“复制 Prompt”按钮。这个 Prompt 通常包含 Skill 的名称、描述和文件内容本质上是让 AI 在本地生成对应的 Skill 目录和SKILL.md。第二步把复制的 Prompt 粘贴到 DevEco Code 的对话框发送。这时候注意观察它的执行过程。如果它说“我将为你创建文件”然后列出文件路径这是好迹象。如果它只是回复一段说明文字没有实际写文件动作那大概率没装上。第三步等它执行完去本地目录复查ls -la ~/.config/deveco/skills/看看有没有新生成的文件夹。如果有进去确认SKILL.md存在且内容完整。如果目录是空的说明 Prompt 安装没生效这时候别反复重试同一个 Prompt直接换目录放置方案把 SkillHub 上的文件手动下载下来放进去。Prompt 安装的稳定性取决于模型是否真的调用了文件写入工具。有些模型在对话模式下只会“描述”操作不会实际执行。如果你用的是 TaoToken 通道可以在配置里确认模型是否支持工具调用。不支持工具调用的模型Prompt 安装基本不会成功。另外npx skills add xxxxxxxx这条命令我也试过在部分环境下会报错错误信息通常是网络超时或包解析失败。如果你遇到不用死磕直接走目录放置。命令行安装依赖 npm 源和网络变量太多不如手动放文件来得直接。5. 常见报错排查401、local proxy failed、reading choices 与 OAuth装 Skill 过程中遇到的报错很多其实不是 Skill 本身的问题而是模型通道没配好。下面按真实报错逐个拆。401 UnauthorizedKey 无效或没带上。检查ANTHROPIC_API_KEY或对应字段是否填了完整的sk-开头字符串。如果 Key 是从控制台复制的注意有没有把前后空格带进去。还有一种情况是配置文件路径不对DevEco Code 读的是另一个文件。用echo $ANTHROPIC_API_KEY确认环境变量是否生效。local proxy failed请求被本地网络层拦截了。检查 Base URL 是否写成https://taotoken.net/api不要写成http://或带端口的本地地址。如果你本地有网络工具在跑确认它没有接管这个域名的流量。这个报错和 Skill 无关通道通了 Skill 才能调模型。reading choices 报错通常是返回体结构不符合预期。比如你用的模型 ID 在 TaoToken 上不存在返回了错误对象而不是正常的choices数组。去控制台核对 Model ID 拼写确认模型可用。另外检查请求头Content-Type是否为application/json。OAuth 相关报错如果你用的是 Claude Code 的 OAuth 登录方式而不是 API Key可能会在 Skill 调用时提示 token 过期。这种情况建议切到 API Key 模式用 TaoToken 的 Key 通道避免 OAuth token 刷新带来的不确定性。配置里把ANTHROPIC_API_KEY填上OAuth 相关字段清掉。排查顺序建议先跑第 2 节的 curl 验证通道通道通了再查 Skill 目录结构目录对了再查SKILL.md内容。这样一层层缩小范围比一上来就怀疑 Skill 文件本身有效得多。6. 统一 Key 通道下的 Skill 接入与验证从模型对话到 Coding PlanSkill 装好之后最终要落到实际使用。TaoToken 的统一 Key 通道在这里的价值是你不需要为 DevEco Code、OpenCode、Claude Code 分别维护不同的 Key 和 Base URL一个 Key 走通所有工具。Skill 调用模型时走的是同一套凭证排障时只需要看一个地方。验证 Skill 是否真正生效除了/skill列表和实际调用还可以看模型返回的元信息。如果 Skill 定义里带了特定的系统提示词模型输出风格会有明显变化。比如一个“严格代码审查”Skill输出会带更多边界条件检查一个“文档生成”Skill输出会按固定模板走。如果输出和没装之前一样说明 Skill 没被加载。对于长期编码和 Agent 场景如果你需要频繁调用模型可以了解 TaoToken 的 Coding Plan地址是https://taotoken.net/coding-plan。它适合需要稳定通道和额度管理的开发者。如果只是验证模型效果用模型对话页面快速测一下就行https://taotoken.net/chat。接入文档在https://taotoken.net/doc里面有各工具的配置示例。最后说一个我踩过的坑Skill 装完后如果你改了SKILL.md的内容一定要重启 DevEco Code。热重载在部分版本里不生效改了不重启等于没改。另外多个 Skill 之间如果有同名触发词可能会冲突建议一次只装一个验证通过再装下一个。先把一个 Skill 跑通后面的就顺了。