setup-sakana-skills

Sakana Skills のセットアップ

インストール済みの利用者が直接参照できる規約を整えます。ユーザーがこのスキルを呼び出した場合にのみ実行します。既存のガイダンスを再利用してください。十分な設定があれば、セットアップは不要です。セットアップの対象は設定であり、実行時のスケジュール管理、スキルのインストール、記録の移行ではありません。

1. 有効なガイダンスを確認する

該当するユーザーレベルおよびプロジェクトの AGENTS.md、CLAUDE.md と、それらが参照するファイルを確認します。docs/agents/ がある場合は、そこも確認してください。選択したクライアントで実際に使用される指示ファイルの場所を確認し、ネイティブ設定キーを推測で作らないでください。リポジトリの識別情報と、インストール済みの利用者の要件を確認します。作業記録と、正規のイシュー、評価用フィクスチャ、非公開の変更履歴を区別してください。

設定は、現在の明示的な指示、次にプロジェクトの上書き設定、最後にグローバルのデフォルトの順で解決します。有効な各値の情報源を記録してください。既存のユーザー指定の記録先とコミット権限は、指定された範囲内で引き続き有効です。編集前に、ガイダンスの競合、重複した参照、共有ファイルやシンボリックリンクされたファイルを検出してください。

完了条件： 必須の設定すべてについて、有効な値、未決の選択肢、または具体的な競合が特定されていること。未決の選択肢や変更の要望がなければ、セットアップは不要であると報告してください。

2. 未決の選択肢だけを解決する

すでに決定済みの内容は引き継ぎます。サポート対象のクライアントと、要求された範囲のみを設定します。

• 範囲とクライアント： グローバルのデフォルト、プロジェクトの上書き設定、またはその両方。Claude Code、Codex、または両方。プロジェクトで値を継承または上書きする方法を示してください。一般的な規約を継承する場合でも、プロジェクトのトラッカー識別情報はプロジェクト固有のままです。
• 作業記録： 正確なルート、確認済みのプロジェクト／上流／フォークの識別情報、既存のインデックスと個別記録のレイアウト、およびユーザーの PR を特定するために有用な作成者の識別情報または明示的な出所情報。観察事項と改善案には共通の形式を使用し、既存の履歴は移動せずに再利用してください。
• 記録の権限： 通常の保存と実質的な更新を許可する記録の種類、および各新規記録と実質的な更新についてローカルコミットを作成するかどうかを個別に設定します。ユーザーが選択した場合、このポリシーは観察事項、改善案、評価、実装の進捗に適用できます。修正とプッシュには別途指示が必要です。Explore のみを対象とするルールから、より広い権限を推測しないでください。
• 正規のトラッカー： 確立済みの Tracker Guidance を再利用します。必要な場合にガイダンスがなければ、GitHub プロジェクトであることが確認済みの場合は GitHub Issues を提案し、それ以外ではユーザーが選択したローカルの Markdown ディレクトリを提案します。別のトラッカーがすでに定められている場合は、それを維持してください。正確な保存先とツールを確認します。補足的なリモート情報によって、正規の保存先が二つになることはありません。

記録を設定する場合は、作業記録のガイダンステンプレートを読みます。この共通仕様は Assess に由来します。これを使用するクライアントには、その依存関係を宣言してください。トラッカーを設定する場合に限り、既存の GitHub または ローカルトラッカー のテンプレートを読みます。

完了条件： 必須の選択肢について、既存またはユーザーが選択した正確な値が定まっていること。アクセス権がない場合は明示的な制限として扱い、接続が成功したものとして扱わないでください。

3. 具体的な設定を提示する

ガイダンスのトピックごとに、正本となるドキュメントを1つだけ維持します。既存の配置場所を再利用します。新しいプロジェクトガイダンスには、docs/agents/working-records.md と docs/agents/issue-tracker.md が適しています。グローバルなデフォルト設定には、選択したクライアントの検証済みグローバル指示から参照できる、ユーザーレベルの具体的なドキュメントとポインターを提案します。ここでいうグローバル設定は、エージェントが読み取るガイダンスであり、新しいアプリケーション設定ではありません。

書き込む前に、正確なテキスト、パス、適用範囲、およびその結果として有効になる値を提示します。エージェントのエントリーポイントには、簡潔で条件付きのポインターを記載します。記録へのポインターは通常のチャットにも適用される必要があります。つまり、実装または PR に着手する前に関連する記録と主張を読み、作業の完了後にリンクを整合させ、設定された権限の範囲内で進捗を更新します。独立監査の履歴に関するゲートは維持してください。エントリーポイントにスキル本文をコピーしたり、実行時のルーターをインストールしたりしないでください。

無関係なドメイン、ラベル、プロジェクトのルールを維持します。両方のクライアントから同じガイダンスを参照してもかまいません。シンボリックリンクは一度だけ解決します。ユーザーがプライベートなローカル保存先を選択した場合に限り、範囲を限定した除外ルールを含めます。記録リポジトリがプライベートだと決めつけないでください。保存先の作成や既存の記録の変更は、その場所を記載することとは別の作業です。

完了条件： ユーザーが設定変更の正確な内容を承認していること。同じテキストと適用範囲について以前に得た承認は引き続き有効です。再利用可能なスキルの設計に対する承認は、ユーザーのグローバル設定を編集する承認ではありません。

4. 適用して検証する

承認された設定のみを適用します。選択した各エントリーポイントからポインターを確認し、有効な設定の優先順位、プロジェクトの識別情報、記録とトラッカーの権限の違い、および無関係な内容が維持されていることを検証します。許可されたディレクトリの作成を確認し、アクセスできないパスは別途報告します。

結果を、2回目のセットアップとして再度読み直します。変更されていないガイダンスには、追加の編集が不要であることを確認します。変更したファイル、グローバルとプロジェクトのどちらに適用されるか、利用者、およびアクセスを検証できていない箇所を報告します。セットアップの一環として、調査結果の作成、Issue の公開、履歴の移行、同期のスケジュール設定は行わないでください。

完了条件： 承認済みのガイダンスを読み取ることができ、有効な選択肢に曖昧さがなく、2回目の確認で重複や必要な書き直しが見つからないこと。