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.
1.7 KiB
1.7 KiB
name, description
| name | description |
|---|---|
| skill-name | 简要描述 skill 做什么、何时触发。写入用户可能使用的触发表达，让 Agent 能自动匹配。 |
Skill 名称
一句话说明这个 skill 的用途。
何时使用
- 触发场景 1
- 触发场景 2
不适用
- 不应触发的相近场景
步骤
- 第一步
- 第二步
- 第三步
运营类 skill 可选：初始化 / 检查 / 工作
需要项目配置才能工作的 skill（例如构建、部署、协作闭环）增加这三个模式：
- 初始化（用户点名才跑）：探项目 → 只建本 skill 拥有的安全空结构 → 用仓库 证据填能填的 → 列出待配置项。不覆盖已有文件，不猜密钥、主机、仓库地址。
- 检查（只读）：同一套诊断，不写文件。
- 工作：配置不齐就停，告诉用户先初始化。禁止静默初始化。
报告格式：
## <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 的执行结果正确