57 lines
1.8 KiB
Markdown
57 lines
1.8 KiB
Markdown
---
|
||
# ---------------------------------------------------------------------------
|
||
# 技能清单（Skill Manifest）
|
||
# 行业常见做法：YAML 头描述元数据，正文 Markdown 描述「何时用、怎么调」。
|
||
# 不同 Claw 宿主解析字段可能略有差异；可移植标识请使用 metadata.skill.slug。
|
||
# ---------------------------------------------------------------------------
|
||
name: 您的技能显示名称
|
||
description: 一句话说明技能做什么（给编排层与人类阅读，不写实现细节）。
|
||
version: 1.0.0
|
||
author: 深圳匠厂科技有限公司
|
||
metadata:
|
||
skill:
|
||
# 机器可读、稳定标识：小写字母、数字、短横线；与数据子目录名一致。
|
||
slug: your-skill-slug
|
||
emoji: "📦"
|
||
category: "通用"
|
||
# 宿主若限制可调用的工具类型，在此列出（按宿主文档填写）。
|
||
allowed-tools:
|
||
- bash
|
||
---
|
||
|
||
# Your Skill Display Name
|
||
|
||
## 使用时机
|
||
|
||
<!-- 由技能作者填写：用户在自然语言里怎样表达时应触发本技能。 -->
|
||
|
||
- 示例：用户说「检查技能是否可用」「运行某某任务」
|
||
|
||
## 执行步骤
|
||
|
||
<!-- 将 {baseDir} 替换为宿主提供的技能根目录；若宿主使用其它占位符，以宿主文档为准。 -->
|
||
|
||
### 健康检查（推荐自动化先跑）
|
||
|
||
```bash
|
||
python3 {baseDir}/scripts/skill_main.py health
|
||
```
|
||
|
||
### 查看版本
|
||
|
||
```bash
|
||
python3 {baseDir}/scripts/skill_main.py version
|
||
```
|
||
|
||
### 扩展子命令
|
||
|
||
在 `scripts/skill_main.py` 中增加新的子命令分支，并在此处追加对应示例命令与参数说明。
|
||
|
||
## 环境依赖
|
||
|
||
详见本仓库 `docs/RUNTIME.md`（`CLAW_DATA_ROOT`、`CLAW_USER_ID` 等）。
|
||
|
||
## 数据与隐私
|
||
|
||
本技能若产生持久化数据，应仅写入 `{CLAW_DATA_ROOT}/{CLAW_USER_ID}/your-skill-slug/` 下；不得将用户数据提交到版本库。
|