name: create-hat-collection
description: 通过引导式对话生成新的 Ralph 帽子集合预设。会询问澄清性问题，根据模式约束进行验证，并输出可用于生产环境的 YAML 文件。

创建帽子集合

概述

本技能通过引导式、对话式的工作流来生成 Ralph 帽子集合预设。它会询问关于您工作流的澄清性问题，根据模式约束验证配置，并生成一个可用于生产环境的 YAML 预设文件。

输出： 位于 presets/ 目录下的完整 .yml 预设文件。

使用时机

• 从零开始创建一个新的多智能体工作流
• 将工作流想法转化为结构化的预设
• 需要关于帽子设计模式和事件路由的指导

不适用于： 修改现有预设（请使用 /creating-hat-collections 参考文档）

工作流程

阶段 1：理解工作流

通过提问来澄清以下内容：

1. 目的： 此工作流解决什么问题？
2. 模式： 哪种架构模式最合适？
   • 流水线： A→B→C 线性流程（例如：分析→总结）
   • 评论者-执行者： 一个提出方案，另一个进行评论（例如：代码审查）
   • 监督者-工作者： 协调者将任务委派给专家
   • 科学方法： 观察→假设→测试→修复（例如：调试）
3. 角色： 需要哪些不同的智能体角色？
4. 交接： 每个角色应在何时交接给下一个？
5. 完成： 什么信号表示工作流已完成？

阶段 2：设计事件流

将工作流映射为事件链：

task.start → [角色 A] → event.a → [角色 B] → event.b → [角色 C] → LOOP_COMPLETE
                                                    ↓
                                         event.rejected → [角色 A]

需要验证的约束：
- 每个触发器必须精确映射到一个帽子（无歧义路由）
- task.start 和 task.resume 是保留事件（切勿用作触发器）
- 每个帽子必须至少发布一个事件
- 事件链最终必须能到达 LOOP_COMPLETE

阶段 3：生成预设

创建包含以下部分的 YAML 文件：

# <预设名称>
# 模式：<架构模式>
# <单行描述>
#
# 用法：
#   ralph run --config presets/<名称>.yml --prompt "<示例提示>"

event_loop:
  starting_event: "<首个事件>"  # Ralph 发布此事件

hats:
  帽子键名:
    name: "<表情符号> 显示名称"
    description: "<帽子用途的简短描述>"
    triggers: ["触发此帽子的事件"]
    publishes: ["此帽子发布的事件", "备用事件"]
    default_publishes: "此帽子发布的事件"
    instructions: |
      ## <帽子名称> 模式

      <清晰的角色定义 - 此帽子的职责>

      ### 流程
      1. <第一步>
      2. <第二步>
      3. 发布适当的事件

      ### 事件格式
      ```
      <event topic="事件名称">
      键: 值
      </event>
      ```

      ### 禁止事项
      - <需要避免的常见错误>
      - <另一个错误>

模式参考

必需的顶级字段

帽子定义字段

不存在的字段

切勿使用以下字段——它们不在模式中：
- emoji（将表情符号放在 name 中）
- system_prompt（使用 instructions）
- subscriptions / publications（使用 triggers / publishes）

事件命名约定

<阶段>.ready / <阶段>.done      # 阶段转换
<事物>.approved / <事物>.rejected  # 审查关卡
<名词>.found / <名词>.missing     # 发现事件
<动作>.request / <动作>.complete # 请求-响应

示例： analysis.complete, review.approved, build.blocked, spec.rejected

验证清单

在最终确定预设之前，请验证：

• [ ] 每个触发器精确映射到一个帽子
• [ ] 没有帽子使用 task.start 或 task.resume 作为触发器
• [ ] 每个帽子都有 name、description、triggers、publishes 和 instructions
• [ ] 对于有多个发布选项的帽子，设置了 default_publishes
• [ ] 事件链能够到达 LOOP_COMPLETE
• [ ] 没有永远不会被处理的孤立事件（仅警告）
• [ ] 指令包含角色定义、流程步骤、事件格式和禁止事项

输出位置

将生成的预设保存到：presets/<名称>.yml

对于最小化/嵌入式预设：presets/minimal/<名称>.yml

测试预设

生成后，使用以下命令测试：

# 干运行以验证配置解析
cargo run --bin ralph -- run -c presets/<名称>.yml -p "测试提示" --dry-run

# 运行冒烟测试
cargo test -p ralph-core smoke_runner

使用 /evaluate-presets 进行全面的验证。

示例对话

用户： 我想要一个用于进行代码审查的预设，重点是安全性。

助手： 我将帮助创建一个以安全为重点的代码审查预设。让我问几个问题：

1. 审查深度： 应该是快速扫描还是彻底分析？
2. 所需角色： 我考虑：
   • 安全分析师（查找漏洞）
   • 代码审查员（检查逻辑/风格）
   • 总结器（创建最终报告）
     这能满足您的需求吗？还是需要添加/移除角色？
3. 迭代： 如果发现问题，是应该修复代码，还是仅报告问题？

用户： 彻底分析，这些角色可以，只报告问题不修复。

助手： 这是我设计的事件流：

task.start → [安全分析师] → security.complete
                                        ↓
          → [代码审查员] → review.complete
                                        ↓
          → [总结器] → LOOP_COMPLETE

让我生成预设...

[生成遵循模式、包含三个帽子的 YAML]

常见模式参考

流水线（顺序）

A → B → C → 完成

适用于：分析工作流、文档处理

评论者-执行者（审查循环）

执行者 → 评论者 → 批准/拒绝
                    ↓
         拒绝 → 执行者（重试）

适用于：代码审查、质量关卡

监督者-工作者

监督者 → worker.task → 工作者 → work.done → 监督者

适用于：复杂任务分解

科学方法

观察 → 假设 → 测试 → 确认/拒绝
                                    ↓
                         拒绝 → 观察

适用于：调试、调查