1.7 KiB
1.7 KiB
SKILL.md 标准化模板 v2.0
所有新建/重写的 SKILL 必须按此模板。参考范例:金仓/磁盘清理、水桥/飞书管理。
模板
---
name: 技能名称
version: "1.0"
owner: 成员名
triggers: [触发词1, 触发词2, 触发词3]
updated: "YYYY-MM-DD"
---
# 技能名称
> 一句话说明:用最简练的语言描述这个技能做什么。
---
## 触发条件
用户说以下关键词时自动激活:
- 触发词1
- 触发词2
- 触发词3
---
## 执行步骤
### 1. 环境检查
- 前置条件检查
### 2. 核心执行
- 步骤 1
- 步骤 2
- 步骤 3
### 3. 一键命令(如有)
\```bash
# 快速执行命令
command here
\```
---
## 输出格式
执行完成后,以以下格式输出结果:
\```
[技能名] 执行完成
├─ 结果1:xxx
├─ 结果2:xxx
└─ 耗时:x 秒
\```
---
## 配套脚本(如有)
| 脚本 | 用途 |
|:---|:---|
| scripts/xxx.py | 说明 |
| scripts/xxx.sh | 说明 |
---
## 书写与术语
- **常见词不翻译**:产品名/品牌名/工具名(如 Cursor、Synology、Duet、v0、GitHub、Gitea、MongoDB)一律保留英文原文,不译成中文。详见 `.cursor/rules/karuo-ai.mdc`「常见词与专有名词(不翻译)」及 `BOOTSTRAP.md` 全局规则。
---
## 安全原则
- 风险操作前先确认
- 重要数据先备份
---
## 版本记录
| 日期 | 版本 | 变更 |
|:---|:---|:---|
| YYYY-MM-DD | 1.0 | 初始版本 |
质量检查清单
- 有 frontmatter(name/version/owner/triggers/updated)
- 有一句话说明
- 有触发条件
- 有执行步骤(至少 3 步)
- 有输出格式
- 有安全原则
- 有版本记录
- 配套脚本路径正确(如有脚本)