write-a-skill 技能:创建具有专业结构的新技能
定位
创建具有适当结构、渐进式披露和捆绑资源的新技能。
技能结构规范
每个技能至少包含:
skills/
└── [skill-name]/
└── SKILL.md ← 技能主文件
├── README.md ← 可选,给人类阅读的说明
├── resources/ ← 可选,捆绑的资源文件
└── scripts/ ← 可选,自动化脚本
渐进式披露原则
SKILL.md 的内容按信息密度递增排列:
- 触发词 — 什么情况下使用此技能
- 一句话定位 — 此技能解决什么问题
- 核心流程 — 步骤化的操作流程
- 详细说明 — 每个步骤的具体要求和输出
- 示例 — 典型使用场景的输入输出示例
- 资源 — 相关文档、脚本的引用
write-a-skill 产出
创建新技能时,write-a-skill 帮你:
- 定义触发词(trigger phrases)
- 设计工作流(workflow)
- 确定确认门槛(confirmation threshold)
- 安排渐进式披露(progressive disclosure)
- 规划资源引用(references/scripts/assets)
与其他技能的关系
write-a-skill 是技能生产技能,所有其他技能的创建都依赖它。
参见
- GitHub: mattpocock/skills
- 同系列:grill-me、caveman