既存の Skill をインポートする¶
目的: 他の場所で定義された Skill（プロンプト、小さなスクリプト、別の agent フレームワークのスペック）を Reyn の DSL に取り込む。
使うべき状況¶
- 別のツールで動作するプロンプトやワークフローがあり、その動作を保ちながら Reyn の構造（検証、Events、リプレイ）を活用したい。
- ワンショットプロンプトを複数 Phase の Reyn Skill として再構築しているが、出発点となるドラフトが欲しい。
skill_importer stdlib Skill を使う¶
skill_importer は入力を読み取り、Phase グラフを推測して、ドラフトの Skill を reyn/local/<name>/ に書き込みます。成功を宣言する前に lint Control IR op を使って出力を検証します。
ワークフロー¶
- ペーストまたは説明。
skill_importerに生のプロンプトテキストまたは Skill が何をすべきかの説明を与えます。 - ドラフトをレビューする。 インポーターは
reyn/local/<name>/配下にskill.md、phases/*.md、artifacts/*.yamlを書き込みます。 - リント。
reyn lint <name>がクリーンになるべきです。そうでない場合、インポーターはランの終わりに問題を報告します。 - 実行。
reyn run <name> "<サンプル入力>"。出力が正しくなければ Phase の指示をイテレートします。 - プロモート。 満足したら、
reyn/local/からreyn/project/に移動してチェックインします。
インポーターのマッピング¶
| ソースのコンセプト | Reyn の相当物 |
|---|---|
| 単一プロンプト | 1 Phase + Skill グラフ entry → end |
| 「ステップ 1、次にステップ 2」 | 線形に接続された複数 Phase |
| 「X なら Y、でなければ Z」 | 分岐 Phase（triage → [branchA, branchB]） |
| ツール呼び出し（ファイル読み取り、検索） | Control IR op |
| 繰り返しの構造化出力 | artifact スキーマ |
インポーターは常に最もクリーンな分解を選ぶとは限りません。インポート後は skill_improver で改善してください:
プロモーションチェックリスト¶
reyn/project/ に移動する前に:
- [ ]
reyn lint <name>がクリーン。 - [ ] 少なくとも 1 つのハッピーパス eval ケースが通過。
- [ ]
final_outputartifact が呼び出し元が実際に必要とするものと一致している。 - [ ] Phase の指示が P8 に従っている（スキーマの列挙なし、Control IR 構文なし）。