HarmonyOS 鸿蒙Next中skill文件导入不进去

HarmonyOS 鸿蒙Next中skill文件导入不进去 【问题描述】:在deveco studio中配置智能体导入skill.md文件时一直导入不进去,并且报skill.md文件不存在或格式错误,这个是什么原因,应该怎么解决???

cke_305.png

cke_717.png


更多关于HarmonyOS 鸿蒙Next中skill文件导入不进去的实战教程也可以访问 https://www.itying.com/category-93-b0.html

3 回复

首先检查开发者的导入路径确认没问题,随后索要开发者的skill文件夹,检查skill.md文件格式,发现文件开头有一个 BOM(字节顺序标记)\ufeff,导致 YAML frontmatter 解析失败。用文本编辑器打开文件后选择utf-8无bom编码格式后重新保存,就可以导入了

更多关于HarmonyOS 鸿蒙Next中skill文件导入不进去的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


HarmonyOS Next 中 skill 文件导入失败,常见原因包括:文件路径错误(需置于 resources/base/profile/ 下)、文件名与 module.json5 中声明的名称不匹配、XML 格式不符合 Stage 模型规范(如缺少 typeuri 字段)、或同模块内存在重复 skill 配置。请核对目录结构与 schema 定义。

导入 .skill.md 文件时报“文件不存在或格式错误”,通常是文件路径或内容格式不符合智能体规范。

常见原因与解决:

  1. 文件位置错误
    必须把 skill.md 放在当前模块的 src/main/ets/resources/rawfile/ 目录下(没有则新建)。导入时直接选择该目录下的 skill.md

  2. 文件名不一致
    确保文件完整名就是 skill.md(区分大小写),不要命名为 skill.md.txt 或误加扩展名。

  3. 文件内容格式不符合规范
    内容必须以 YAML 前置数据(front matter) 开头,用 --- 包裹必需的元信息,之后才是 Markdown 描述。示例结构:

    ---
    name: 示例技能
    description: 技能说明
    ---
    # 具体 Prompt
    你是……助手,请完成……
    

    缺少 namedescription、未正确使用 ---、键名错误都会导致格式报错。

  4. 文件编码异常
    保存为 UTF-8 无 BOM,避免隐藏字符导致解析失败。

如果以上仍无效,重新创建一个新 skill.md 粘贴合规内容后重试即可。

回到顶部