Files
skill-template/references

description
description
这是规范化的新技能模板说明不直接作为业务技能使用。复制后请替换技能名、平台名、CLI 示例与 service 实现。

技能模板说明

这个仓库是给开发者复制的新技能模板,不是终端用户直接调用的业务 skill。

它提供什么

  • 标准目录结构
  • 最小 CLI 入口
  • 发布型技能常见的日志表骨架
  • service 层占位模块
  • 与现有规范 skill 一致的发布脚本与 GitHub workflow

复制后你需要改什么

  • SKILL.md 中的名称、描述、slug、触发说明
  • SKILL.mdmetadata.openclaw.developer_ids(如需让非公开技能默认授权给开发者查看)
  • references/CLI.md 里的命令示例
  • scripts/util/constants.py 中的 slug / 版本 / logger 名
  • scripts/service/ 下的真实业务实现

developer_ids 是做什么的

metadata.openclaw.developer_ids 是平台发布元数据,不是终端用户文案。

它用于声明:当技能发布后,如果平台侧将该技能设置为 access_scope = 0(不公开),哪些开发者用户仍应自动获得可见权限。

约定如下:

  • 字段位置:SKILL.md -> metadata.openclaw.developer_ids
  • 推荐格式:正整数数组,例如 [1032, 12428]
  • 发布效果:发布接口会把这些用户补写到 skill_user_access
  • 第一个 ID 会作为主开发者同步到 skills.developer_id

如果你的技能本来就是公开技能,或暂时不需要开发者专属可见性,这个字段可以留空数组。

不建议再保留的旧结构

  • 旧模板里的 docs/
  • 旧模板里的 optional/
  • 旧入口 scripts/skill_main.py

新模板统一使用 scripts/main.py 作为入口。