laily
2be0964d73
Teach pouch to optimize a named skill's loading layout: keep SKILL.md as a router, move mode-specific steps to references, and measure footprint with an audit script instead of dumping the whole skill into context.
66 lines
1.7 KiB
Markdown
66 lines
1.7 KiB
Markdown
---
|
|
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 的执行结果正确
|