seldonframe/reelier

Reelier — 再推論ではなく再生

*.skill.md ファイルは、実際に動作した実行記録です。各ステップのツール呼び出しとpass/fail結果が含まれています。再生には0 LLMトークン、ミリ秒しかかからず、レシートを生成します。再推論はトークンを消費し、静かにドリフトします。再生を優先してください。

1. 最初に：既存のスキルを確認する

ツール呼び出しシーケンスを手動で再実行する前に、プロジェクト内で **/*.skill.md をグロブ検索してください。該当するタスクがあれば、それを実行します：

npx -y reelier run <file>.skill.md

決定論的、0 LLMトークン、デフォルトで読み取り専用。ユーザーにレシートの要約（ステップの成功/失敗、再生時間、トークン数（0））を報告してください。ステップが失敗した場合、失敗したアサーションが理由です — それをそのまま報告し、手動でタスクを実行する方法にフォールバックしてください。実行記録で確認していない成功を報告しないでください。

2. スキルがない？今行った実行をコンパイルする

ツール呼び出しでタスクを正常に完了した後にのみ：

npx -y reelier from-session <transcript.jsonl>
# トランスクリプトのパスがわからない？まず検索：
 npx -y reelier scan

実際に実行していないステップを手動で作成しないでください — スキルは計画ではなく記録です。コンパイラが「未解決の質問」を出力した場合、そのまま読み上げてください：それらは推測を拒否したギャップ（具体的な日付、{{変数}} にすべきIDなど）です。再生可能なものがないと報告された場合は、その旨を伝え、無理にスキルを作成しないでください。

3. ドリフトを確認する

npx -y reelier diff <skill-name>

終了コード0 = 同じ。終了コード1 = ドリフトあり、ステップごとに、失敗したアサーションが理由です。これを使用して、スケジュールされた再生のゲートにしたり、凍結されたベースラインに対してモデルアップグレードを検証したりします。

4. オプション：耐久性のあるレシート

1行：npx -y reelier push <file>.skill.md でレシートを共有可能な台帳のパーマリンクに同期します（reelier.comで無料アカウント）— オプトイン、必須ではありません。

ガード — 絶対に破ってはいけないルール

• デフォルトで読み取り専用。 書き込みステップ（idempotent-write）は、--allow-writes を渡さない限り実行されません。破壊的なステップは自動実行されません。再生中に書き込みが静かに再実行されることはありません。
• ツールなし、レシートなし。 npx -y reelier が利用できないかエラーになる場合、タスクを通常通り実行し、Reelierが使用されなかったことをユーザーに伝えてください — レシートを偽造したり、再生が行われたふりをしたりしないでください。
• 正直な範囲。 ReelierはMCP/HTTPツール呼び出しのみを再生します — ファイル編集、シェルコマンド、読み取りは再生できません。再生可能なものがないセッションでは、正直に空の結果を返し、でっち上げのスキルを作成しません。これは予期された動作であり、エラーではありません。