怎么写 Skill

这里给一个可落地的写作流程，默认面向开发者和产品经理协作场景。

Step 1：定义任务边界

先写清楚这 4 件事：

• 解决什么问题。
• 不解决什么问题。
• 成功判定标准。
• 失败时怎么处理。

Step 2：拆执行链路

推荐按 4 段写：

1. Gather：收集上下文与输入。
2. Decide：做路径判断。
3. Execute：执行动作。
4. Verify：验证结果。

Step 3：添加最小资产

• 至少 1 个模板。
• 至少 1 个例子。
• 至少 1 个校验脚本或检查清单。

Step 4：定义质量门禁

至少包含：

• 输出格式是否合规。
• 关键事实是否可追溯。
• 安全与合规是否满足最小要求。

Step 5：做灰度发布

• 先让少数任务使用新 Skill。
• 记录失败样本。
• 再逐步扩大覆盖范围。

简版模板

# SKILL.md

## name

release-readiness-check

## description

用于发布前检查评测、监控、回滚配置是否齐备。

## workflow

1. 读取变更与评测报告
2. 检查门禁阈值
3. 生成风险分级
4. 给出上线建议

## output

- risk_level
- blocking_issues
- launch_recommendation