20 Skills Cookbook（技能资产化）

1) 技能最小规范

每个技能文件至少包含：

• 适用场景
• 输入约束
• 固定步骤
• 禁止事项
• 成功判定

2) 团队推荐技能包

• skill-triage：快速分诊（配置/权限/模型/终端）
• skill-release-note：发布说明生成
• skill-pr-review：PR 风险审阅
• skill-security-scan：安全巡检
• skill-doc-maintain：文档更新与链接检查

3) 技能与命令的配合

• 命令 = 入口（/xxx）
• 技能 = 方法（怎么做）
• agent = 执行角色（权限与模型）

4) 版本策略

• 语义版本（MAJOR.MINOR.PATCH）
• 变更日志必须记录“为何变更 + 影响范围”
• 重大变更提供迁移指引

5) 质量门禁

• 每个技能至少有 1 个真实案例验证。
• 禁止“只有理论没有执行路径”的技能。
• 对外部工具依赖必须注明版本与替代方案。

6) 技能评审模板（建议）

• 目标是否单一且清晰？
• 输入契约是否完整？
• 是否定义了失败处理与回滚？
• 是否有安全与权限边界？
• 是否有可验证结果？