eve-skill-distillation

Eve 技能提炼

使用此工作流，将重复出现的模式转化为可复用的技能。

何时提炼

• 某个工作流已在两个或更多任务中重复出现。
• 其他在同一项目中工作的 Agent 也能从这些知识中受益。
• 某种故障模式反复出现，应将其解决方法编码下来。

工作流：协调，不要串行处理

如果提炼涉及多项技能（创建多项技能、批量更新，或两者兼有），请采用协调者模式，而不是把所有工作按顺序逐一完成。这样既能保护上下文预算，也能并行处理互不依赖的工作。

步骤 1：捕捉模式（协调者）

找出近期工作中所有值得提炼的模式。针对每种模式：

• 列出重复出现的步骤、命令或故障模式。
• 决定：更新现有技能，还是创建新技能？
• 首先选择目标代码库/技能包——可能是：
  • ./private-skills/ 或类似目录，用于特定于代码库、不会导入其他项目的开发工作流（私有）
  • ./private-eve-dev-skills/，用于在 eve-horizon 代码库中工作，且技能涉及平台本身的内部开发（私有）
  • ../eve-skillpacks/eve-se/，用于 Eve 平台相关工作（部署、身份验证、清单、流水线）
  • ../eve-skillpacks/eve-work/，用于通用知识工作（文档、协调、提炼）
  • ../eve-skillpacks/eve-design/，用于架构与设计思考

步骤 2：规划工作项（协调者）

为每项要创建或更新的技能创建一个可跟踪的工作项。每个工作项的描述都必须自包含——即使工作者没有先前上下文，也能执行。

在每个工作项中包括：

• 目标文件路径（例如，eve-se/eve-auth-and-secrets/SKILL.md）
• 这是创建还是更新
• 要捕捉的模式：该技能应教授什么
• 工作人员应阅读的任何材料（现有技能、参考文档、对话历史）
• 编写规则（见下方“技能编写规则”）

如果有整理类更新（README、ARCHITECTURE.md），请将其作为最后一个工作项，并设为在所有技能工作项完成之前不可开始。

步骤 3：分派工作者（并行）

为每个技能工作项启动一个工作者，并一次性全部启动。

每个工作者的提示词都必须自包含。工作者无法访问协调者的对话。请包括：

• 要创建或编辑的目标文件路径
• 对要捕捉的模式进行充分说明，以便据此编写
• 下方的编写规则
• 更新时需要保留的现有文件内容

步骤 4：收集并完成（协调者）

等待所有工作者完成。然后：

• 如果新增或移除了技能，请更新技能包 README 和 ARCHITECTURE.md 中的条目。
• 验证每项新建或更新的技能都符合编写规则。

单项技能快捷方式

如果只需提炼一项技能，请跳过协调者模式，直接完成。为单个工作者分派任务所带来的开销并不值得。

技能编写规则

每位工作者（或直接撰写者）都必须遵守以下规则：

• Frontmatter：仅包含 name 和 description 的 YAML。
• 语气：全文使用祈使句。（“运行该命令”，而不是“你应该运行该命令”。）
• 简洁：将 SKILL.md 控制在 5,000 词以内。较长的细节移至 references/。
• 教会思考，而不只是步骤：技能应帮助 Agent 理解为什么，而不只是做什么。说明工作流背后的理由，以便 Agent 能在条件变化时灵活调整。
• 便于浏览的结构：使用标题、短段落和代码块。Agent 会先浏览，再细读。
• 与 Agent 无关的表述：描述要做什么，而不是调用哪个工具。说“编辑文件”，而不是“使用 Edit 工具”。说“启动一个后台工作者”，而不是“启动一个 Task 子 Agent”。

递归提炼

• 每次完成重要任务后，都重复这个循环。
• 合并重叠的技能，而不是重复创建。
• 随着平台行为的演变，及时更新技能。
• 当技能的说明不再符合实际情况时，请更新或弃用该技能。