mcpField
S
setup-rules

setup-rules

github.com/jinsyinエージェントワークフロー142 回インストール1 週間前に更新
リポジトリ

setup-rules について

setup-rulesは、Agent向けのプロジェクトルールを設定するスキルです。対話で選択内容を集め、規定順にルールを組み立て、選択したアダプターやサブエージェント、機密ファイル制限を導入します。既存項目を更新するモードもあります。

主な機能

  1. 01ルールや項目の選択を対話で収集
  2. 02規定順でルールファイルを組み立て
  3. 03選択したAgent・エディターアダプターを導入
  4. 04機密ファイルのアクセス制限を統合
  5. 05未対応セクションを保持して導入済み項目を更新

活用シーン

  1. 01プロジェクトのAgentルールを初期設定
  2. 02CursorまたはAntigravityアダプターを選択して設定
  3. 03指定した機密ファイルへのAgentアクセスを制限
  4. 04既存のルール設定を現行アセットで更新

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jinsyin/skills --skill setup-rules

インストール後、Claude Code で/setup-rulesを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

assets/
skillsw
assets/adapters/antigravity/
gemini.md
assets/adapters/claude/agents/
superpowers-final-reviewer.md
superpowers-fixer.md
superpowers-implementer.md
superpowers-re-reviewer.md
superpowers-task-reviewer.md
assets/adapters/codex/agents/
superpowers-final-review.toml
superpowers-fixer.toml
superpowers-implementer.toml
superpowers-re-reviewer.toml
superpowers-task-reviewer.toml
assets/adapters/cursor/
hooks.json
assets/adapters/cursor/agents/
general-purpose.md
superpowers-final-reviewer.md
superpowers-fixer.md
superpowers-implementer.md
superpowers-re-reviewer.md
superpowers-task-reviewer.md
assets/adapters/cursor/hooks/
enforce-subagent-model.sh
assets/adapters/cursor/rules/
subagent-model-policy.mdc
assets/conventions/
core.md
design.md
gsd.md
karpathy.md
matt.md
ponytail.md
superpowers.md
vibecoding.md
assets/templates/prototype/
AGENTS.md

詳細

setup-rules

作成せず、組み立てます。規約は assets/conventions/ にそのまま保存されているため、選択したファイルを固定順でバイト単位のまま連結します。機密ファイルへのアクセス制限は、無関係な設定を置き換えずに、ネイティブの Agent 設定へ統合します。

モード:setup-rules → Workflow、setup-rules update → Update。

Workflow では対話形式のヒアリングが必要です。質問し、回答を待ち、不明点を確認し、書き込み前に最終マニフェストを確認してください。プロジェクトの情報やデフォルトから、任意の選択項目を推測してはいけません。1 回の質問ラウンドで尋ねる質問は、焦点を絞ったものを 4 つまでとし、曖昧な項目は保留にします。

カテゴリソース配置先条件
規約assets/conventions/*.mdCLAUDE.local.mdcore は必須。その他は個別に選択可能
サブエージェントassets/adapters/<tool>/agents/.<tool>/agents/ツール/ワークフローごと
Cursor アダプターassets/adapters/cursor/rules/、assets/adapters/cursor/hooks/、assets/adapters/cursor/hooks.json.cursor/rules/、.cursor/hooks/、.cursor/hooks.json個別に選択可能
Antigravity アダプターassets/adapters/antigravity/gemini.mdGEMINI.md個別に選択可能
skillswassets/skillswskillsw(プロジェクトルート、実行可能)個別に選択可能
機密ファイルへのアクセス制限references/sensitive-file-access.mdネイティブの Agent 設定デフォルトセットに任意の追加項目を加える

規約の順序は固定です:core → design → vibecoding → ponytail → karpathy → gsd → matt → superpowers。選択されていないファイルはスキップします。

規約ファイル:

  • assets/conventions/core.md
  • assets/conventions/design.md
  • assets/conventions/vibecoding.md
  • assets/conventions/ponytail.md
  • assets/conventions/karpathy.md
  • assets/conventions/gsd.md
  • assets/conventions/matt.md
  • assets/conventions/superpowers.md

サブエージェントのバンドル:

エージェントバンドルソースプロジェクト内の配置先条件
Cursor 汎用assets/adapters/cursor/agents/general-purpose.md.cursor/agents/general-purpose.md個別に選択可能
Superpowers エージェントassets/adapters/<tool>/agents/superpowers-*.<tool>/agents/Superpowers が選択されている場合のみ

Cursor アダプターの対応関係:

アダプターファイルプロジェクト内の配置先
assets/adapters/cursor/rules/subagent-model-policy.mdc.cursor/rules/subagent-model-policy.mdc
assets/adapters/cursor/hooks/enforce-subagent-model.sh.cursor/hooks/enforce-subagent-model.sh
assets/adapters/cursor/hooks.json.cursor/hooks.json に統合

Cursor アダプターが制約するのは、Cursor サブエージェントの model と effort のみです。Superpowers 専用ではありません。SDD は Cursor サブエージェントを作成する可能性のあるワークフローの 1 つにすぎません。このアダプターの選択は、assets/adapters/cursor/agents/ 配下のエージェント定義とは独立しています。Superpowers 専用のモデルルール、コマンド、ラッパー、モデルプロファイルディレクトリを作成してはいけません。

Antigravity アダプターは、assets/adapters/antigravity/gemini.md をプロジェクトルートの GEMINI.md にコピーします。このファイルには、汎用的で組み合わせ可能なルールが含まれています。

skillsw は npx skills をラップします:./skillsw clean install は古いスキルを削除し、skills-lock.json から復元します。clean/install はいずれかの処理を単独で実行し、その他の引数はそのまま渡します。

Workflow

1. プロジェクトルートを特定します。 Git ルートがあればそれを使用し、なければ作業ディレクトリを使用します。ユーザーが指定したパスがあれば、それを優先します。

2. Core からヒアリングを開始します。 assets/conventions/core.md を全文表示します。任意の規約(Design、Vibecoding、Ponytail、Karpathy、GSD、Matt、Superpowers)を含めるか尋ね、それぞれを簡潔に説明します。GSD/Superpowers は、使用する場合にのみ選択肢として提示します。回答を待ちます。

3. Cursor 汎用について尋ねます。 assets/adapters/cursor/agents/general-purpose.md を .cursor/agents/general-purpose.md にインストールするか、個別に尋ねます。

4. Superpowers が選択された場合は、そのサブエージェントについて尋ねます。 assets/adapters/<tool>/agents/ 配下にファイルがあるバンドルのみ提示し、任意の組み合わせを選べるようにします。一致した各バンドルを .<tool>/agents/ にコピーします。 5. インタビューで Cursor のサブエージェントが対象となる場合は、Cursor アダプターについて確認します。 すべての Cursor サブエージェントにモデル/労力ルールとフェイルクローズフックをインストールすることを説明します。

6. Antigravity アダプターについて確認します。 assets/adapters/antigravity/gemini.md をプロジェクトルートの GEMINI.md としてインストールするか尋ねます。

7. skillsw について確認します。 assets/skillsw をプロジェクトルートの skillsw としてインストールするか、別途尋ねます。

8. 機密ファイルを収集します。 .env、.env.dev、.env.test、または .env.prod という名前のプロジェクトファイルをすべて事前選択します。追加するプロジェクト相対のファイルまたはディレクトリがあるか尋ねます。空欄の場合はこのセットのみを対象とします。明示的にオプトアウトされない限り、削除しません。このセットを超えて推測したり、保護対象の内容を読んだりしてはいけません。機密ファイルへのアクセス制御に従います。

9. Git の追跡について確認します。 対象となる各 .<tool>/、.agent/(Antigravity)、.agents/ について、デフォルトでは skills/ サブツリー以外をすべて追跡し、その正確なディレクトリを .gitignore に追加して、追跡中のファイルを追跡解除します。尋ねるのは、デフォルトを維持するか、ディレクトリごとにカスタム設定にするかのみです。ユーザーから要望があった場合に限り、カスタム設定を使用します。skills-lock.json が存在し、スキルが最終的に無視される場合は、次の skills-lock エントリーも計画します。

  • skills-lock.json の追跡を維持し、git add します。復元時に、そこからスキルが再構築されます。

  • このブロックを .worktreeinclude に追加し、新しい worktree に Claude Code/Codex のスキルがコピーされるようにします。.claude/skills/ もコピーすると、Claude Code がメインのチェックアウトを読めなくなります。エントリーがコメントなしで存在する場合は、コメントを追加します。

    # Copy installed skills to new worktrees; omit .claude/skills/ so Claude Code reads the main checkout's
    /.agents/skills/
    
  • .cursor/ が対象の場合は、.cursor/worktrees.json の setup-worktree-unix に mkdir -p .agents && cp -R "$ROOT_WORKTREE_PATH/.agents/skills" .agents/ を追加します。

10. マニフェストを確認します。 出力先、機密ファイルの対象、外部設定、ディレクトリごとの Git の選択、正確な無視エントリー、追跡解除するファイル、ステップ 9 の skills-lock エントリーを一覧表示します。書き込み前に確認を取ります。

11. CLAUDE.local.md を組み立てて書き込みます。 選択したファイルを固定順序で使って、必ず置き換えます。古いファイルを読んだり、内容を保持したりしてはいけません。末尾に空行を追加し、結果が選択した内容を連結したものと一致することを検証します。

12. 選択されたサブエージェント、アダプター、ルールをインストールします。 選択されたエージェントファイルと正確なアダプター対応付けのみをコピーします。assets/adapters/<tool>/ ディレクトリを再帰的にコピーしてはいけません。必要に応じて対象ディレクトリを作成し、ファイルをバイト単位でそのままコピーします。Antigravity アダプターでは、assets/adapters/antigravity/gemini.md をプロジェクトルートの GEMINI.md にコピーします。skillsw では、assets/skillsw をプロジェクトルートの skillsw にコピーし、chmod +x を実行します。選択された Cursor フックは、既存の .cursor/hooks.json に、関係のないフックを削除せずにマージします。既存ファイルを別の内容で置き換える前に、競合を提示して確認を取ります。アクティブな編集を黙って上書きしたり、関係のないファイルを削除したりしてはいけません。

13. Git の選択を適用します。 確認済みの無視エントリーを追加し、追跡解除を選択されたファイルに対して git rm -r --cached を実行します。ローカルファイルと関係のないルールは保持します。ステップ 9 の skills-lock エントリーを適用し、既存の .worktreeinclude/.cursor/worktrees.json に、行やコマンドを削除せずにマージします。管理対象外のアクティブなファイルがあれば停止します。履歴の書き換え、worktree ファイルの削除、許可なしでのコミット/プッシュを行ってはいけません。

14. 機密ファイルの制限をインストールします。 参照に従い、確認済みの拒否設定をマージします。関係のない設定や、より厳格な設定を保持します。ポリシーに互換性がない場合は停止します。強制されない Antigravity UI と Cursor のターミナル/MCP 経由のアクセス経路を報告します。

15. CLAUDE.md と AGENTS.md を確保します。 既存ファイルは変更せずに残します。それ以外の場合は、CLAUDE.md を # Project Conventions のみで作成し、AGENTS.md を次の内容のみで作成します。

@CLAUDE.local.md
@CLAUDE.md

16. 検証して報告します。 変更された JSON/TOML を解析し、利用可能なオフラインの設定読み込みチェックを実行し、シークレットを読み取らずに ignore のマッチングをテストします。選択内容、変更内容、保護対象のパス、制限事項、Git の判断、競合を報告します。スキルが ignore されている場合は、新規クローン用の Core の ### Skills 復元コマンドを案内します。

Update

確認を求めず、現在のアセットからインストール済みの項目のみを更新します。update の実行により、すべての上書きが事前承認されたことになり、Workflow とリファレンスに記載された確認、承認、または確認を求めて停止する手順はすべて無効になります。新たに選択する項目には、完全な setup-rules が必要です。Workflow の手順 2~10、13、15 はスキップします。

1. Root. Workflow 1 と同様です。CLAUDE.local.md が存在しない場合は停止します。

2. Detect. CLAUDE.local.md の H2 を、規約の最初の H2 と照合します。既存のターゲットはインストール済みのサブエージェント/アダプター/skillsw を示し、既存の deny は機密ターゲットを示します。一致しない H2 セクションはすべて、ユーザーコンテンツが失われないよう、元の順序を保ったまま末尾に追加します。

3. Write. ターゲットとアセットを比較し、同一のものはスキップします。CLAUDE.local.md を固定順と保持したセクションで再構築します。エージェント/アダプター/skillsw はバイト単位でそのままコピーし、skillsw の実行可能属性を維持します。.cursor/hooks.json ではこのスキルのフックのみを置き換え、既存の機密ターゲットは再マージします。解析できない設定や互換性のないポリシーがある場合は、そのターゲットをスキップして報告します。

4. Report. Workflow 16 と同様に、上書きされたファイル、保持した不一致セクション、スキップしたターゲットも報告します。

コメント