Files
skill-template/SKILL.md
2026-04-19 18:19:51 +08:00

2.0 KiB
Raw Blame History

name, description, version, author, metadata, allowed-tools
name description version author metadata allowed-tools
技能开发模板(复制后请修改) 这是 OpenClaw 技能开发模板仓库,不直接作为业务技能发布。复制为新技能仓库后,按本模板替换 slug、名称、说明、CLI 子命令与 service 实现。 1.0.13 深圳匠厂科技有限公司
openclaw
slug emoji category developer_ids
your-skill-slug 📦 通用
10032
12428
bash

技能开发模板skill-template

这是一个用于复制的新技能模板,不是业务技能本身。新建技能时,应复制本仓库结构,再把占位内容替换成你的真实业务实现。

模板使用方式

  1. 复制目录为你的新 skill 仓库。
  2. 全局替换 your-skill-slug技能开发模板(复制后请修改) 等占位词。
  3. references/CLI.mdscripts/ 分层与 README.md 的说明补业务逻辑。

目录约定

  • 根目录结构参考现有规范技能:assets/references/scripts/tests/evals/
  • CLI 入口固定为 scripts/main.py
  • 业务逻辑按 cli / db / service / util / jiangchang_skill_core 分层。

最小命令

python {baseDir}/scripts/main.py health
python {baseDir}/scripts/main.py version

重要说明

  • 复制后请同步修改 scripts/util/constants.py 中的 SKILL_SLUG / SKILL_VERSION
  • 如技能无需持久化,可保留 db/ 目录但不主动调用。
  • metadata.openclaw.developer_ids 用于声明技能发布后的默认开发者可见用户 ID 列表。
  • 当技能在平台中 access_scope = 0(不公开)时,发布流程会把 developer_ids 中的用户自动补写到 skill_user_access,使这些开发者仍可在技能市场中查看该技能。
  • developer_ids 建议写为正整数数组;第一个 ID 会作为主开发者同步到 skills.developer_id
  • 面向用户与编排的文档写在 references/,不要再新增旧式 docs/ / optional/ 结构。