SuperAPI AI 工具集

ralph-hats

办公与效率

查看项目

更新于 10-16 01:15

技能介绍

用途:用于操作用户自建 hat 集合的完整生命周期,覆盖新建、检查、校验、解释与改进 Ralph 工作流。

主要能力:在 .ralph/hats/ 下创建新 hat 集合;读取并解释现有集合的拓扑;校验触发路由、事件流与完成行为;重构 hat 使角色更清晰、路由更安全;为 Ralph 工作流推荐更好的编排模式。

使用方式:若 hats 文件已存在,先读取并解释当前拓扑再提改动;新建工作流写入 .ralph/hats/<name>.yml;hats 文件只保留 hats 数据,运行时限制等核心配置留在主配置文件(ralph.yml 或 -c 来源),用户 hat 用 -H 传入。校验用 ralph hats validate;事件流复杂时用 ralph hats graph 可视化;查看单个 hat 时用 ralph hats show <hat>;需要更高把握时运行 ralph run -c ... -H ... -p "..." 或给出确切测试命令。

限制:hats 文件顶层键仅限 name、description、events、event_loop、hats;其中 event_loop 只用于 starting_event、completion_promise 等 overlay 键。禁止用 task.start 或 task.resume 作为触发,应使用 work.start、review.start、research.start 等语义化委托事件;每个触发只能路由到一个 hat;每个 hat 需填 description;自定义事件名不直观时优先用 events: metadata;不得从本技能把用户工作流写入 presets/。其他细节暂未提供。