67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
---
|
|
name: skill-name
|
|
description: >-
|
|
显式调用门槛：仅在用户显式调用 `/<skill-name>` 或 `$<skill-name>`，或由已显式调用的上游
|
|
skill 明确委派时加载；不自动触发。简要描述 skill 做什么，以及显式调用后的使用范围。
|
|
---
|
|
|
|
# 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 的执行结果正确
|