2026-02-15 10:44:56 +08:00
|
|
|
|
# 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 | 说明 |
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-03-04 22:03:06 +08:00
|
|
|
|
## 书写与术语
|
|
|
|
|
|
|
|
|
|
|
|
- **常见词不翻译**：产品名/品牌名/工具名（如 Cursor、Synology、Duet、v0、GitHub、Gitea、MongoDB）一律保留英文原文，不译成中文。详见 `.cursor/rules/karuo-ai.mdc`「常见词与专有名词（不翻译）」及 `BOOTSTRAP.md` 全局规则。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-02-15 10:44:56 +08:00
|
|
|
|
## 安全原则
|
|
|
|
|
|
|
|
|
|
|
|
- 风险操作前先确认
|
|
|
|
|
|
- 重要数据先备份
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 版本记录
|
|
|
|
|
|
|
|
|
|
|
|
| 日期 | 版本 | 变更 |
|
|
|
|
|
|
|:---|:---|:---|
|
|
|
|
|
|
| YYYY-MM-DD | 1.0 | 初始版本 |
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 质量检查清单
|
|
|
|
|
|
|
|
|
|
|
|
- [ ] 有 frontmatter（name/version/owner/triggers/updated）
|
|
|
|
|
|
- [ ] 有一句话说明
|
|
|
|
|
|
- [ ] 有触发条件
|
|
|
|
|
|
- [ ] 有执行步骤（至少 3 步）
|
|
|
|
|
|
- [ ] 有输出格式
|
|
|
|
|
|
- [ ] 有安全原则
|
|
|
|
|
|
- [ ] 有版本记录
|
|
|
|
|
|
- [ ] 配套脚本路径正确（如有脚本）
|
