Add generic Claw skill-template (manifest, CLI, docs, optional snippets)
Made-with: Cursor
This commit is contained in:
56
SKILL.md
Normal file
56
SKILL.md
Normal file
@@ -0,0 +1,56 @@
|
||||
---
|
||||
# ---------------------------------------------------------------------------
|
||||
# 技能清单(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/` 下;不得将用户数据提交到版本库。
|
||||
Reference in New Issue
Block a user