skill-template

技能名称

清晰、简洁地描述此技能涵盖的内容以及何时使用。此描述会显示在技能发现中，帮助 Agent（和人类）判断此技能何时相关。

重要：为获得最佳性能，请将 SKILL.md 正文控制在 500 行以内。将详细的参考资料移至单独的 references/ 目录中的文件。

每个技能正文都必须明确说明其职责边界。描述和“何时激活”部分应说明此技能负责什么，以及哪些相邻技能负责相关工作。这可以防止宽泛的技能抢占更具体技能的激活机会。

何时激活

描述此技能应激活的具体情境、任务或场景。既要包括直接触发条件（特定关键词或任务类型），也要包括间接信号（表明技能相关的更广泛模式）。

使用第三人称。描述会被注入系统提示词，视角不一致可能导致发现问题。

• 推荐：“处理 Excel 文件并生成报告”
• 避免：“我可以帮你处理 Excel 文件”

添加简短的“不要激活”区块，说明相邻技能的适用情形。例如：

• 不要用于项目级流水线结构：project-development。
• 不要用于单个工具的架构设计：tool-design。

核心概念

解释此技能涵盖的基本概念。这些是技能要教授的思维模型、原则或框架。

默认假设：Claude 已经非常聪明。只补充 Claude 尚不了解的背景信息。逐条审视每项信息：

• “Claude 真的需要这个解释吗？”
• “能否假设 Claude 已经知道这点？”
• “这段内容是否值得占用相应的 Token？”

优先介绍能改变行为的机制，而非泛泛的背景知识。如果某个概念需要在整个语料库中复用，请在 researcher/mechanisms/registry.jsonl 中添加或更新一条记录。

详细主题

主题 1

详细说明第一个主要主题。包括具体技巧、模式或方法，并用示例阐释概念。

主题 2

继续详细说明第二个主要主题。根据需要添加其他主题。

对于较长的主题，可考虑将内容移至 references/ 并添加链接：

• 完整实现请参阅详细参考资料

实用指南

提供应用此技能的可操作指导。包括常见模式、应避免的反模式，以及用于选择不同方法的决策框架。

具体程度应与任务的脆弱性相匹配：

• 自由度高：存在多种有效方法，具体选择取决于上下文
• 自由度中等：有推荐模式，可接受一定程度的变化
• 自由度低：操作容易出错，必须遵循特定顺序

实用指南应能由 Agent 执行：可以是工作流、检查清单、决策表或具体操作规则。如果某个部分只是在解释历史或动机，请将其移至 references/。

示例

提供具体示例，展示如何应用此技能。示例应包含前后对比、演示正确用法，或说明如何处理边缘情况。

使用输入／输出对以便理解：

示例：

Input: [describe input]
Output: [show expected output]

指南

列出应用此技能时应遵循的具体指南。这些指南应是可执行且可核查的规则。

1. 提供具体、可验证标准的指南
2. 提供明确成功条件的指南
3. 根据需要继续添加

注意事项

列出根据实际经验总结出的失败模式、常见错误和反直觉行为。这是任何技能中信号价值最高的内容。每项注意事项都应具体、可操作，并且不与技能正文中已有的指导重复。使用编号格式：

1. 简短的描述性标题：用一到两句话说明会出现什么问题，以及如何避免。
2. 另一个注意事项标题：说明失败模式以及应采取的做法。

集成

说明此技能如何与集合中的其他技能集成。将相关技能列为纯文本（不要使用链接），以避免跨目录引用问题：

• skill-name-one - 简要说明关联
• skill-name-two - 简要说明关联

参考资料

内部参考（使用相对于技能自身参考文件的路径）：

• 参考名称 - 说明

此集合中的相关技能：

• skill-name - 关系说明

外部资源：

• 研究论文、文档或指南

涉及数值、基准、时效性或厂商性能的主张，需要附带行内 claim-* ID，并由 researcher/claims/index.jsonl 提供依据；否则，应弱化表述并移至注明日期的参考资料。

---

技能元数据

创建时间：[Date] 最后更新：[Date] 作者：[Author or Attribution] 版本：[Version number]