49 lines
2.0 KiB
Markdown
49 lines
2.0 KiB
Markdown
---
|
||
name: 技能开发模板（复制后请修改）
|
||
description: "这是 OpenClaw 技能开发模板仓库，不直接作为业务技能发布。复制为新技能仓库后，按本模板替换 slug、名称、说明、CLI 子命令与 service 实现。"
|
||
version: 1.0.13
|
||
author: 深圳匠厂科技有限公司
|
||
metadata:
|
||
openclaw:
|
||
slug: your-skill-slug
|
||
emoji: "📦"
|
||
category: "通用"
|
||
developer_ids:
|
||
- 1032
|
||
- 12428
|
||
allowed-tools:
|
||
- bash
|
||
---
|
||
|
||
# 技能开发模板（skill-template）
|
||
|
||
这是一个**用于复制的新技能模板**，不是业务技能本身。新建技能时，应复制本仓库结构，再把占位内容替换成你的真实业务实现。
|
||
|
||
## 模板使用方式
|
||
|
||
1. 复制目录为你的新 skill 仓库。
|
||
2. 全局替换 `your-skill-slug`、`技能开发模板（复制后请修改）` 等占位词。
|
||
3. 按 `references/CLI.md`、`scripts/` 分层与 `README.md` 的说明补业务逻辑。
|
||
|
||
## 目录约定
|
||
|
||
- 根目录结构参考现有规范技能：`assets/`、`references/`、`scripts/`、`tests/`、`evals/`。
|
||
- CLI 入口固定为 `scripts/main.py`。
|
||
- 业务逻辑按 `cli / db / service / util / jiangchang_skill_core` 分层。
|
||
|
||
## 最小命令
|
||
|
||
```bash
|
||
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/` 结构。
|