---
name: skill-name
description: >-
  简要描述 skill 做什么、何时触发。写入用户可能使用的触发表达，让 Agent 能自动匹配。
---

# Skill 名称

一句话说明这个 skill 的用途。

---

## 何时使用

- 触发场景 1
- 触发场景 2

## 不适用

- 不应触发的相近场景

---

## 步骤

1. 第一步
2. 第二步
3. 第三步

## 运营类 skill 可选：初始化 / 检查 / 工作

需要项目配置才能工作的 skill（例如构建、部署、协作闭环）增加这三个模式：

- **初始化**（用户点名才跑）：探项目 → 只建本 skill 拥有的安全空结构 → 用仓库
  证据填能填的 → 列出待配置项。不覆盖已有文件，不猜密钥、主机、仓库地址。
- **检查**（只读）：同一套诊断，不写文件。
- **工作**：配置不齐就停，告诉用户先初始化。禁止静默初始化。

报告格式：

```text
## <skill> 初始化：完成 | 部分完成 | 阻塞

已具备: …
待配置: 路径 + 字段 + 可粘贴示例 + 缺了会挡住哪步
工具链: …
下一步: 一句话
```

项目状态放在 skill 真正消费的位置（覆盖层、`makefile.builder`、compose），不要为了对齐
而新建一层没人读的 `.pouch/<skill>/`。`pouch init` 只用于确实有 templates/
覆盖层的 skill。需要 make 目标或发布凭据的 skill 用自己的文件名（如 `makefile.builder`、
`.env.builder`），不要占用用户的 `Makefile` 或 `.env`。

---

## 注意事项

- 约束或边界条件
- `SKILL.md` 只留模式路由、全模式安全边界，以及「若 X 则读 `references/Y.md`」。
  单模式步骤不要写进正文。

## 验证

- 说明如何确认 skill 的执行结果正确