# SKILL.md 标准化模板 v2.0

> 所有新建/重写的 SKILL 必须按此模板。参考范例：金仓/磁盘清理、水桥/飞书管理。

---

## 模板

```markdown
---
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 步）
- [ ] 有输出格式
- [ ] 有安全原则
- [ ] 有版本记录
- [ ] 配套脚本路径正确（如有脚本）