install-rules

スキル：ルールのインストール

目的

ルールソースのルール（AI の動作に対する受動的な制約）を、エディターのルール用の保存先にインストールします。主なソースは、このプロジェクトの「rules/」ディレクトリ、またはユーザーが指定した Git リポジトリです。対応するインストール先は Cursor (.cursor/rules/) と Trae IDE (.trae/project_rules.md / .trae/user_rules.md) です。

---

主な目的

最優先の目的：ユーザーによる明示的な確認と競合の検出を経て、ソースリポジトリのルールを Cursor または Trae IDE にインストールします。

成功基準（すべて満たす必要があります）：

1. ✅ ソースの解析：ルールソース（このリポジトリの「rules/」または指定された Git リポジトリ）を読み取り、「INDEX.md」またはディレクトリ一覧からルール一覧を作成します
2. ✅ インストール先の分析：書き込み前に既存のインストール先ファイルをスキャンし、競合や重複を特定します
3. ✅ インストール計画の提示：各ルールの操作（「作成／スキップ／競合／更新」）とインストール先のパスを明示した計画をユーザーに提示します
4. ✅ ユーザーによる確認：ファイルを作成または変更する前に、ユーザーが計画を明示的に承認します
5. ✅ ルールのインストール：選択したルールを、適切な形式（Cursor の「.mdc」ファイルまたは Trae の管理ブロック）でインストール先に書き込みます
6. ✅ 結果の報告：インストール後の要約に、実行した操作、インストール先のパス、変換に関する注記や失敗を含めます

受け入れテスト：ユーザーは、どのルールがどこにインストールされたか、また競合が検出されたかを確認できますか？

---

対象範囲の境界

このスキルの担当範囲：

• ルールソース（このリポジトリまたは Git リポジトリ）を解析する
• ソースで利用可能なルールを一覧表示する
• インストール先の状態（既存ファイル／競合）を分析する
• インストール計画を作成して提示する
• ルールを Cursor（.mdc 形式）または Trae（管理ブロック）にインストールする
• インストール結果を報告する

このスキルの担当範囲外：

• 利用可能なスキルを見つける（「discover-skills」を使用）
• 新しいルールを作成または記述する（対象範囲外）
• ルールの内容を変更する（ソースの内容をそのまま保持）
• スキルをインストールする（ルールのみ）

引き継ぎのタイミング：ルールをインストールして報告した時点で、このスキルは完了です。ユーザーがスキルの発見を希望する場合は、「スキルの発見」に引き継ぎます。

---

使用例

• このプロジェクト：現在のリポジトリの rules/ にあるすべてのルール、または選択したルールを、現在のプロジェクトの Cursor または Trae のルールにインストールします。
• 別の Git リポジトリ：ユーザーが owner/repo（および任意でブランチ／参照先とサブパス）を指定します。そのリポジトリのルールを一覧表示し、選択したルールを Cursor または Trae にインストールします。
• 初期設定：ai-cortex またはルールを提供する別のリポジトリをクローンした後、そのルールをインストールし、ユーザーのワークスペースでエージェントがルールを守るようにします。

---

動作

1. ソースを解決する：

   • このプロジェクト：リポジトリの rules/ ディレクトリを使用します。rules/INDEX.md を正式な一覧として扱い、存在する場合はレジストリを解析してルール名とファイルパスを取得します。存在しない場合は、rules/ 以下のすべての *.md ファイルを一覧表示します（INDEX.md を除く）。
   • 指定された Git リポジトリ：ユーザーが「所有者／リポジトリ」または完全なクローン URL を指定し、ブランチ／参照先とサブパス（例：「rules」または「docs/rules」）を任意で指定します。次の方法でルールを検出します：(a) サブパス内で「INDEX.md」（または同等のファイル）を探してレジストリを解析する、または (b) そのディレクトリ内の「*.md」ファイルを一覧表示する。リポジトリまたはパスが存在しない場合や、ルールが含まれていない場合は、その旨を明確に報告し、ファイルには書き込みません。

2. ルールを一覧表示する：インストール可能なルールの一覧（名前、簡単な説明または適用範囲）を出力します。ユーザーに、すべてのルールまたは名前を指定した一部のルールを選んでもらいます。

3. インストール先の状態を分析する（必須）：

   • Cursor：既存の ./.cursor/rules/*.mdc（プロジェクトレベル）またはユーザーレベルのルールディレクトリ（選択されている場合）を一覧表示します。既存のファイル名を特定します。
   • Trae：選択したインストール先ファイル（./.trae/project_rules.md または ./.trae/user_rules.md、もしくはユーザーレベルのグローバルパス（選択されている場合））を読み取ります（存在する場合）。管理ブロックがすでに存在するかを検出します（手順 6 を参照）。

4. インストール計画を作成する（必須）：

   • 選択した各ルールについて、「作成」、「スキップ（同一）」、「競合（異なる）」または「更新（明示的に承認された上書き）」のいずれかを決定します。
   • 既定では保守的な処理を行います：
     • 既存のインストール先の内容が異なる場合、ユーザーが上書きを明示的に承認するまでは「競合」とします。
     • 既存のインストール先の内容が同一の場合は「スキップ」とします。
   • 書き込み前に、想定されるインストール先のパスと各ルールの操作を含む計画を出力します。

5. 書き込み前に確認する：

   • ユーザーが計画を明示的に確認するまでは、.cursor/rules/、.trae/ またはその他のインストール先パスにあるファイルを作成、変更、上書きしないでください。
   • 上書きが含まれる場合は、上書き対象となるルールのインストール先を列挙し、明示的な確認を得る必要があります。

6. Cursor にインストールする：

   • インストール先のパス：プロジェクトレベルでは ./.cursor/rules/（repo root からの相対パス）を使用します。ユーザーレベルでは、プラットフォームに応じたパス（該当する場合は「~/.cursor/rules/」など）を使用します。ユーザーからユーザーレベルを指定されない限り、プロジェクトレベルを優先します。ディレクトリが存在しない場合は作成します。
   • 形式：ルールごとに 1 つの「.mdc」ファイルに書き込みます。ソースルールのメタデータを front-matter（「description」、任意の「globs」、任意の「alwaysApply」）に対応付け、ルール本文を保持します。
   • 冪等性：書き込み前に内容を正規化し、既存のインストール先の内容（ある場合）と比較します。同一の場合は「スキップ」します。
   • 競合：インストール先が存在し、内容が異なる場合は、計画に「更新」が含まれ、ユーザーが上書きを明示的に確認しない限り、上書きしないでください。

7. Trae にインストールする（管理ブロック）：

   • インストール先のパス：プロジェクトレベルでは ./.trae/project_rules.md、ユーザーレベルでは「./.trae/user_rules.md」（プロジェクトスコープ）またはグローバルなユーザーレベルのパス（Trae が対応している場合）を使用します。ユーザーからユーザーレベルを指定されない限り、プロジェクトレベルを優先します。.trae/ ディレクトリが存在しない場合は作成します。
   • 管理ブロック（必須）：
     • ユーザーが記述したルールを変更しないよう、管理ブロック内にのみ書き込みます。
     • ブロックの前後に「」や「」などのマーカーを使用します。
     • 管理ブロックが存在する場合は、ブロック全体の内容を置き換えます。存在しない場合は、ブロックを挿入します（通常はファイル末尾に追加します）。
   • ブロックの内容：
     • ブロック内では、各ルールを「## Rule: 」という見出しでセクションにし、順序を安定させます（利用可能な場合は「rules/INDEX.md」のレジストリ順を優先します）。
     • 各ルールの本文（ソース見出しより後のすべての内容）を保持します。
     • 管理ブロック内では、ルール名で重複を排除します（1 つの名前につき 1 つのセクション）。
   • 冪等性：再生成した管理ブロックが現在の管理ブロックと同一であれば「スキップ」とし、ファイルを書き換えません。

8. 出力：インストール後、計画、実行した操作、インストール先のパス、変換に関する注記や失敗を報告します。

---

入力と出力

入力

• ソース：既定では「このプロジェクト」（現在のリポジトリの「rules/」）。または Git リポジトリ owner/repo か URL。ブランチ／参照先とサブパス（例：rules、docs/rules）は任意で指定できます。
• インストール先：Cursor、Trae、またはその両方。
• スコープ："All" ルール、または一部のルール（ルール名のリスト）。
• 保存先：プロジェクトレベルまたはユーザーレベル。既定ではプロジェクトレベルです。
• 競合ポリシー：既定では保守的に処理します（上書きしません）。上書きには明示的な確認が必要です。

出力

• インストール前：ルール一覧、インストール先の分析の要約、インストール先のパスを含むインストール計画（作成/スキップ/競合/更新）。
• インストール後：実行した操作、インストール先のパス、エラーや変換に関する注記。

---

制限

厳守すべき境界

• 確認なしの書き込み禁止：ユーザーが計画を明示的に確認するまでは、.cursor/rules/、.trae/ またはその他のインストール先パスにファイルを作成または変更しないでください。
• 確認なしの上書き禁止：インストール先がすでに存在し、内容が異なる場合は、ユーザーが明示的に同意し、計画にそのインストール先の「更新」が含まれていない限り、上書きしないでください。

スキルの境界（重複を避ける）

次の作業は行わないでください（他のスキルが担当できます）：

• スキルの発見 → 発見技能
• ルールの内容の作成または編集 → 対象範囲外
• スキル（SKILL.md）のインストール → 対象範囲外

---

セルフチェック

主な成功基準（すべて満たす必要があります）

• ソースの解析：「INDEX.md」またはディレクトリ一覧から、ルールソースを読み取り、ルール一覧を作成した
• インストール先の分析：書き込み前に既存のインストール先ファイルをスキャンし、競合や重複を特定した
• インストール計画の提示：各ルールの操作とインストール先のパスをユーザーに提示した
• ユーザーによる確認：ファイルを作成または変更する前に、ユーザーが計画を明示的に承認した
• ルールのインストール：選択したルールを、適切な形式でインストール先に書き込んだ
• 結果の報告：インストール後の要約に、実行した操作、インストール先のパス、変換に関する注記や失敗を含めた

---

例

示例 1：将此项目中的所有规则安装到 Cursor

• 阅读 rules/INDEX.md 并构建规则列表。
• 分析 .cursor/rules/ 并制定保守的计划。
• 提出计划，获得确认，执行“创建”/“更新”操作，然后报告。

示例 2：将规则从另一个 Git 存储库安装到 Trae

• 解析owner/repo和子路径。
• 发现规则，为 Trae 托管块构建计划，确认，然后写入托管块。
• 报告已安装的规则和目标文件路径。

---

附录：输出合约 (Appendix: Output Contract)

当此技能运行完毕后，必须生成如下格式的安装后摘要报告（Side-effect report），以便代理或后续步骤能解析安装的规则以及是否有跳过/冲突：

字段	类型	描述
rule_name	String	安装或处理的规则名称
action	String	执行的操作 (created | skipped | conflict | updated)
target_path	String	规则写入的目标路径 (如 .cursor/rules/xxx.mdc 或 .trae/project_rules.md)
status	String	最终状态 (success | failed | pending_confirmation)

---

附录：输出合约 (Appendix: Output Contract)

当此技能运行完毕后，必须生成如下格式的安装后摘要报告（Side-effect report），以便代理链能解析安装的规则以及是否有跳过/冲突：

字段	类型	描述
rule_name	String	安装或处理的规则名称
action	String	执行的操作 (created | skipped | conflict | updated)
target_path	String	规则写入的目标路径 (如 .cursor/rules/xxx.mdc)
status	String	最终状态 (success | failed | pending_confirmation)