需要编写可复用的 Agent Skill 时…

为新建 Agent Skill 提供一份标准化骨架，使技能具备明确触发关键词、典型场景、输入/输出契约、工作流步骤与失败降级策略。

适用场景

解决思路

1. 在 frontmatter 中填写 name 与 description：name 用技能名，description 说明该技能的触发条件、工作流和输入/输出契约，便于被检索和匹配。
2. 用 H1 写上技能名，并紧跟一行说明该技能解决什么问题。
3. 在标题下方提供多语言链接（如 [简体中文](./SKILL.zh-CN.md) | English），保证文档可双语查阅。
4. 编写 Triggers 段：列出 2 条以上触发关键词，让 Agent 能判定何时该调用该技能。
5. 编写 Use Cases 段：列出 3 条左右的典型使用场景，界定技能覆盖面。
6. 编写 Inputs 段：必填输入（如 `field_a`、`field_b`）逐项给出说明，可选输入（如 `field_c`）单独列出并说明。
7. 编写 Outputs 段：分别给出成功输出格式示例与失败输出格式示例。
8. 编写 Workflow 段，按 5 步可执行流程组织：1) 校验输入完整性；2) 构造请求参数；3) 执行核心动作；4) 格式化输出；5) 失败时提供重试或降级（fallback）策略。
9. 编写 Limitations 段：明确技能的能力边界，并说明常见失败原因。
10. 编写 Examples 段：给出输入示例（`...`）与对应的输出示例（`...`）。

适用边界 · 注意事项

• 技能无法用固定的输入/输出契约和确定性步骤描述（如高度开放式交互）时不适用。
• 只做一次性脚本或纯说明文档、不需要被 Agent 按触发词自动调用时不适用。