mcpField
A
agent-rules

agent-rules

github.com/netresearchエージェントワークフロー88819 回インストール3 日前に更新
リポジトリ

agent-rules について

AIエージェント向けのAGENTS.mdを生成、保守するスキルです。リポジトリを調査して確認済みの規約を記録し、内容の正確性や鮮度を検証するスクリプトを備え、記載された複数の言語・フレームワークに対応します。

主な機能

  1. 01ルートとスコープ別のAGENTS.md生成
  2. 02技術スタックと対象範囲の検出
  3. 03コマンドとリポジトリ規則の抽出
  4. 04記載内容とコマンドの検証
  5. 05鮮度確認と品質評価

活用シーン

  1. 01新規リポジトリへのエージェント指針の導入
  2. 02複数リポジトリのエージェント文書の標準化
  3. 03コード変更後の指針更新
  4. 04エージェントの未知のコードベースへの導入

インストール

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

$npx skills add https://github.com/netresearch/agent-rules-skill --skill agent-rules

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

同梱ファイル

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

AGENTS.md
checkpoints.yaml
assets/
root-thin.md
root-verbose.md
assets/example-workflows/
validate-agents.yml
assets/scoped/
backend-go.md
backend-php.md
backend-python.md
backend-typescript.md
claude-code-skill.md
cli.md
concourse.md
ddev.md
docker.md
documentation.md
examples.md
frontend-typescript.md
github-actions.md
gitlab-ci.md
oro-bundle.md
oro-project.md
python-modern.md
resources.md
skill-repo.md
symfony.md
testing.md
typo3-docs.md
typo3-extension.md
typo3-project.md
typo3-testing.md

詳細

AGENTS.md 生成スキル

agents.md の規約に従って、AGENTS.md ファイルを生成・管理します。AGENTS.md は人間ではなく、エージェント向けのファイルです。

使用するタイミング

  • 新規または既存のプロジェクトで AGENTS.md を作成・更新するとき
  • 新しいリポジトリをスキャフォールディングするとき — 最初のコミットとともに AGENTS.md を含めてください。後から追加する場合は、全項目を再検証する必要があります
  • リポジトリ間でエージェント向けドキュメントを標準化するとき
  • コード変更後に AGENTS.md の最新性を確認するとき
  • 不慣れなコードベースに AI エージェントをオンボーディングするとき

スクリプト

すべてのスクリプトはフルパスで呼び出してください：bash ${CLAUDE_SKILL_DIR}/scripts/<name> PATH。作業ディレクトリからの相対パスで呼び出す方法は frontmatter ルールの対象外であり、呼び出すたびに権限の確認が求められます。

スクリプト目的
generate-agents.sh PATHAGENTS.md ファイルを生成
validate-structure.sh PATH構造への準拠を検証
check-freshness.sh PATHファイルが古くなっていないか確認
verify-content.sh PATHドキュメントに記載されたファイル／コマンドがコードベースと一致するか検証
verify-commands.sh PATHドキュメントに記載されたコマンドが実行できるか検証
score-agents.sh PATHAGENTS.md の品質を評価（スコアの低い順）
detect-project.sh PATH言語、バージョン、ビルドツールを検出
detect-scopes.sh PATHスコープ別ファイルが必要なディレクトリを特定
extract-commands.sh PATHビルド設定からコマンドを抽出
extract-ci-rules.sh PATHCI の品質ゲートとバージョンマトリックスを抽出
extract-architecture-rules.sh PATHモジュールの境界を抽出
extract-adrs.sh PATHアーキテクチャ決定記録を抽出
extract-github-rulesets.sh PATHGitHub のルールセットとマージルールを抽出

すべてのオプションについては references/scripts-guide.md を参照してください。

ワークフロー

  1. 検出：detect-project.sh + detect-scopes.sh — 技術スタックとサブシステム
  2. 抽出：extract-commands.sh、extract-ci-rules.sh — 事実情報を収集
  3. 生成：generate-agents.sh --style=thin（デフォルト）または --verbose
  4. 検証：verify-content.sh + verify-commands.sh — 完了前に必ず実行してください
  5. 行数制限：ルートの AGENTS.md を編集してコミットする前に、wc -l AGENTS.md が 150 未満であることを確認してください（ハーネス AH-02）。リポジトリに verify-harness.sh がある場合は実行してください。実行しないと CI のハーネスチェックに失敗します

--update は `` マーカーの外側にある、整理済みのコンテンツを保持します。

基本原則

  • 文章より構造化 — 段落よりも表のほうが素早く解析できます
  • 捏造しない — 実在するものだけを記載し、すべてのコマンドとパスを検証します
  • ポインターの原則 — コンテンツを複製せず、ファイルを参照します
  • シンボリックリンクを自動作成 — デフォルトでは CLAUDE.md/GEMINI.md を作成します（ai-tool-compatibility.md）

参考資料

ファイル内容
verification-guide.md検証手順、肥大化防止、保持チェック
fleet-sync-sweep.md全リポジトリを対象とした AGENTS.md の一斉確認
scripts-guide.mdスクリプトのオプション、検証チェックリスト
quality-rubric.md評価基準
ai-tool-compatibility.md16 エージェントの互換性マトリックス
output-structure.mdルート／スコープ別のセクション
git-hooks-setup.mdフックフレームワークのセットアップ
examples/完全な例
ai-contribution-guidelines.mdAI 貢献の「3 Cs」フレームワーク
directory-coverage.mdスコープ別ファイルでカバーする理由
feedback-memory-schema.md承認済み学習ファイルの形式

テンプレート

ルート：assets/root-thin.md（デフォルト）または root-verbose.md。スコープ別：assets/scoped/ に、技術スタックごとに 1 つ用意されています（Go/PHP/Python/TYPO3/Symfony/Oro/CLI/TS/skill-repo）。

Supported Projects

Go, PHP (Composer/Laravel/Symfony/TYPO3/Oro), TypeScript (React/Next/Vue/Node), Python (pip/poetry/ruff/mypy), skill repos, hybrid.

See Also

コメント

Markdown 対応