tenngoxars/skill-synergy

スキルシナジー — 調停ルール

複数のスキルが同時に発動したときに、どれが優先されるかを決定する唯一の権威です。現在のタスクに2つ以上のスキルが当てはまりそうな場合に読んでください。

使用上の注意: このスキルは詳細なルールセットです。簡潔な憲章（常時構成におすすめ）はリポジトリルートに AGENTS.md.template としてあります。 AGENTS.md にコピーすると、コアルールが毎セッションで読み込まれます。このスキルはオンデマンドのリファレンスです。

コアルール

ワークフロースキル（何をするか）は、同じタスクにおいてモードスキル（どう話すか/書くか）よりも優先されます。モードスキルは適応します。ワークフロースキルは弱められません。

以下はすべて、このルールの適用例です。特定のケースがリストにない場合は、コアルールを適用してその旨を明示してください。

ワークフロー対ワークフロー調停

2つ以上のワークフロースキルが同じタスクに当てはまる可能性がある場合、以下の優先順位で選択します。

1. 明示的な意図が優先されます。 ユーザーがタスクタイプ（レビュー、テスト、設計、計画など）を明示した場合、そのタイプのスキルが主導します。議論の余地はありません。
2. スコープで決定します。 単一の変更（1つの差分、1つの関数、1つのファイル）にはより軽くコストの低いスキルを、横断的な変更（アーキテクチャ、複数ファイルのリファクタリング、新しいシステム）にはより深いスキルを使用します。
3. ライフサイクル順。 計画 → 構築 → 検証 がデフォルトの順序です。スキルが1つの作業のフェーズ（設計、実装、レビュー）である場合、1つを選ぶ代わりにこの順序で実行します。
4. 選択よりも合成。 2つのスキルが順次フェーズである場合、両方を順序どおりに実行し、その順序を明示します（「まずTDD、次にレビュー」）。
5. それでも曖昧な場合は、尋ねてください。 1行の推奨事項を示し、ユーザーに選択させます。ワークフロースキルを黙って選択しないでください — 間違った選択は1つの返信ではなく、タスク全体を無駄にします。

スキル分類

調停を行う前に、インストールされているすべてのスキルを分類してください。

• ワークフロースキル — 何が行われるか を指示します：レビュー、テスト、設計、調査、作成、リファクタリング、計画。成果物を生成します。
• モードスキル — エージェントの話し方や出力量 を指示します：圧縮、冗長、スタイル、簡潔。それ自体では何も生成しません。
• ルータースキル — どのワークフローを実行するかを選択します（オプション）。モードスキルによって上書きされるべきではありません。

モードスキルがワークフロースキルの成果物（レポート、ドキュメント、コミットメッセージ、PR本文）を変更しようとする場合、モードスキルは譲歩します。ワークフロースキルとモードスキルの両方が発動し、ワークフロースキルの出力が成果物である場合、モードスキルは譲歩します。

この憲章はスキルの自己記述よりも優先されます。 スキルのフロントマターは広範なフレーズでの自動トリガーを主張する場合があります（例：「自動的にレビューでトリガー」）。そのような主張はここで上書きされます：ルーティングはスキル自身のトリガー主張ではなく、この憲章の曖昧性解消に従います。スキルがこの憲章が別の場所に割り当てるトリガーを主張する場合、憲章が優先されます。

優先度マトリクス（ご自身のスキルを記入）

以下のサンプルスキル名を、実際の環境にインストールされているスキルに置き換えてください。行は、実際に競合が発生する頻度の順に並んでいます。

タスク	主導（ワークフロー）	譲歩	動作
UIデザイン / 磨き / ビジュアル批評	例：あなたのデザインスキル	例：あなたの最小コードスキル	デザインが主導。最小コードは弱められた強度で（肥大化はしないが、デザインクラフトに対するYAGNI拒否権はなし）
詳細コードレビュー（標準＋仕様）	例：あなたのフルレビュースキル	例：あなたの圧縮スキル	通常の散文でフルレポート。ユーザーが簡潔なフィードバックを求めない限り、圧縮はオフ
過剰エンジニアリング監査	例：あなたの削除重視レビュースキル	例：あなたのフルレビュースキル	単一軸、削除重視のパス。フルレポートはスキップ
迅速な簡潔PRフィードバック	例：あなたの簡潔コメントスキル	—	ユーザーが明示的に圧縮コメントを要求した場合のみ
計画/アイデアのストレステスト	例：あなたのインタビュー/酷評スキル	例：あなたの圧縮スキル	通常の散文でインタビュー。圧縮された酷評は深みを失う
テスト駆動機能構築	例：あなたのTDDスキル＋あなたの最小コードスキル	—	コンボ：テストは検証であり、決して削らない。レッドグリーンを通過する最小限の実装
モジュール/API設計	例：あなたの設計ドキュメントスキル	例：あなたの最小コードスキル	設計フェーズ：深さが優先。実装フェーズ：最小コードの階層が適用される
文章作成 / 編集 / 教育	例：あなたの作成スキル	例：あなたの圧縮スキル	完全な表現が必要。圧縮はオフ
調査 / ドキュメント収集	例：あなたの調査スキル	例：あなたの圧縮スキル	出力ファイルは成果物。圧縮はチャットのみに影響し、ファイル内容には影響しない
コーディングタスク（他のスキルが発動していない場合）	例：あなたの最小コードスキル	例：あなたの圧縮スキル	最小コードをフル強度で。圧縮はオンデマンドのみ（ターンごとの入力コストがコード主体の作業では節約を上回ることが多い）

トリガーの曖昧性解消

複数のスキルが同じトリガーワードを共有する場合、どのスキルが最初に一致したかではなく、意図によってルーティングします。

• 「これをレビューして」 → デフォルトではフルレビュー。削除重視レビューは、ユーザーが「過剰エンジニアリング」/「コードが多すぎる」と言った場合のみ。簡潔コメントレビューは、ユーザーが圧縮フィードバックを要求した場合のみ。
• 「酷評して」/「私にインタビューして」 → コードベースが存在する場合は状態を持つバリアント（ドキュメントのトレイルを残す）、スタンドアロンの場合は状態を持たないバリアント、ユーザーが一度にすべての質問を望む場合はバッチバリアント。
• 「ハンドオフ」 → デフォルトではドキュメント作成バリアント。ユーザーが即座にバックグラウンドエージェントを望む場合のみ、バックグラウンドエージェント生成バリアント。
• 「計画/仕様/チケットを作成」 → 成果物のタイプでルーティング：仕様、チケット、PRD、課題、アンケート。

モードスキルの規律

1. モードスキルは、ワークフロースキルの成果物を決して黙らせません。 チャットの散文のみを圧縮できます。ワークフロースキルが作成したレポート、ファイル、コミットメッセージ、PR本文は完全なままです。
2. 最小コードスキルの検証ラインには3つの階層があります。 (1) 実際の検証は残す：入力検証、外部依存関係のエラーハンドリング、セキュリティ、アクセシビリティ — 決して削らない。 (2) 投機的な防御は対象範囲内：発動しないチェック、「もしものための」防御ラッパー — それらは削除します。それが最小コードスキルの仕事です。 (3) テストとタスクドキュメントはユーザーの明示的な要件に従います：最小コードスキルはYAGNIを使ってユーザーが要求したテストやドキュメントを決して削りません — ただし、テスト内の冗長性、過剰なモック、ドキュメントの肥大化は依然として対象範囲内です。
3. 2つのモードスキルが同時に発動した場合（圧縮＋最小コード）：最小コードはコードを統制し、圧縮はチャットを統制します — ただし、セッションが散文主体の場合のみ。コード主体のセッションでは、圧縮はオフにするか弱い強度にすべきです（そうしないと正味トークン損失になります）。
4. サブエージェントは調停を継承します。 レビューや調査タスクのためにサブエージェントを生成する場合、タスク内でモードを明示します：「通常の散文」または「圧縮出力」。暗黙のままにしないでください。

報われる組み合わせ

• TDDスキル＋最小コードスキル — テストファースト、最小実装。
• フルレビュー、次に同じ差分に対して削除重視レビュー — フルパス、その後削除パス。
• インタビュースキル＋メモリ圧縮スキル — インタビュー後に蓄積されたセッションノートを圧縮。
• 任意のワークフロースキル完了後の簡潔コミットメッセージスキル — 常に安全。
• フロールーティング用ルータースキル、モード調停用このスキル — ルーターが道路を選び、シナジーがギアを選びます。

カスタマイズ

このスキルはフレームワークであり、設定ではありません。自分用にするには：

1. 優先度マトリクスの「例：あなたのXスキル」をすべて、実際の環境のスキル名に置き換えてください。一般的な公開スキルを使用した記入済みのリファレンスは examples/example-config.md にあります — テンプレートを最初から埋めるのではなく、それをコピーして自分の名前を代入してください。
2. 自分が決して使用しないタスクタイプの行を削除します。
3. 環境にグローバルルールファイル（AGENTS.md または同等のもの）がある場合、コアルールをそこにコピーして、すべての環境で読み込まれるようにします。
4. カバーされていない新しい競合が現れた場合、両方のスキルを分類し（ワークフローかモードか）、コアルールを適用して、行を追加します。