ralph-hats

Ralph ハット

ユーザーが作成したハットコレクションのライフサイクル全体を管理するには、このスキルを使用します。

このスキルを使用する場面

• .ralph/hats/ に新しいハットコレクションを作成する
• 既存のハットコレクションを調べ、その構成を説明する
• トリガーのルーティング、イベントフロー、完了動作を検証する
• 役割がより明確で、安全にルーティングできるようハットを改善またはリファクタリングする
• Ralph ワークフローに適したオーケストレーションパターンを提案する

基本的な前提

• コアランタイム設定は、すでに ralph.yml または別の -c で指定するソースに記述されています。
• ユーザーが作成したハットは別に保存され、-H で渡されます。
• このスキルは公開されているハットコレクションを対象とし、Ralph に組み込まれたプリセットは対象としません。

ワークフロー

1. ハットファイルがすでに存在する場合は、まずそれを読み込み、変更を提案する前に現在の構成を説明します。
2. 新しいワークフローを作成する場合は、.ralph/hats/<name>.yml に記述します。
3. ハットファイルにはハット関連のデータのみを記述します。ランタイムの制限やその他のコア設定は、メインの設定ファイルに残します。
4. ralph hats validate で検証します。
5. イベントフローが単純でない場合は、ralph hats graph で構成を可視化します。
6. 特定のハットの有効な設定を調べる必要がある場合は、ralph hats show <hat> を使用します。
7. ユーザーがより確実な確認を求める場合は、対象を絞った ralph run -c ... -H ... -p "..." のテストを実行するか、正確なテストコマンドを提示します。

ガードレール

• ハットファイルのトップレベルキーには、現在 Ralph が受け付ける次のキーのみを使用します。 name、description、events、event_loop、hats。
• ハットファイルでは、event_loop は starting_event や completion_promise など、ハットのオーバーレイキーにのみ使用します。
• ハットのトリガーに task.start や task.resume を使用しないでください。Ralph はこれらを調整用に予約しています。work.start、review.start、research.start など、意味が明確な委譲イベントを使用します。
• 各トリガーのルーティング先は、必ず1つのハットだけにします。
• すべてのハットに description を設定します。
• カスタムイベント名だけでは意味が分かりにくくなる場合は、events: メタデータの使用を推奨します。
• このスキルで作成するユーザーワークフローを presets/ に記述しないでください。

出力の期待事項

• ハットを編集または作成する場合は、ファイルの変更内容と検証結果を提示します。
• 調査のみの場合は、簡潔な構成の要約、主なリスク、具体的な改善案を提示します。

必要に応じて参照するドキュメント

• 現行のハットスキーマと対応フィールド：references/schema.md
• コマンド例と検証ワークフロー：references/commands.md
• パターンとファイルの例：references/examples.md