200-agents-md について
Java リポジトリ向けの AGENTS.md を作成・更新する対話型スキルです。段階的な進行で、コマンドやワークフロー、作業範囲など、リポジトリ固有の指針をまとめます。
主な機能
- 01対話形式でのリポジトリ確認
- 02エージェントの役割と専門性
- 03技術スタックとファイル構成
- 04ビルド・テスト・Git コマンド
- 05コントリビューターの作業範囲
活用シーン
- 01Java リポジトリ用 AGENTS.md の作成
- 02既存のエージェント指示の更新
- 03リポジトリのコマンドと規約の記録
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ jabrena/ plinth --skill 200-agents-mdインストール後、Claude Code で/200-agents-mdを入力して読み込まれたか確認します。
同梱ファイルreferences/200-agents-md.md
詳細
Java リポジトリ向け AGENTS.md ジェネレーター
モジュール式の段階的な対話プロセスを通じて、役割の定義、技術スタック、ファイル構成、コマンド、Git ワークフロー、貢献者の境界を網羅した包括的な AGENTS.md ファイルを Java リポジトリ向けに生成します。これは対話型の SKILL です。
この Skill で扱う内容
- あらゆる複雑さの Java リポジトリ向け AGENTS.md の生成
- AI エージェントと貢献者の役割および専門知識の定義
- 技術スタックのドキュメント化:言語、ビルドツール、フレームワーク、パイプライン
- 読み取り/書き込みの境界を含むファイル構成のマッピング
- ビルド/テスト/デプロイ/実行のワークフローに対応するコマンド一覧
- Git ワークフローの規約:ブランチ戦略、コミットメッセージの形式
- ✅ 常に実施 / ⚠ 事前に確認 / 🚫 絶対に実施しない、の形式による貢献者の境界
制約
AGENTS.md の生成前に Maven による検証を行う必要はありません。正確な回答を Step 1 で提示できるよう、開始前にプロジェクトの構成と既存のドキュメントを確認してください。
- 開始前:Step 1 で正確な回答を提示できるよう、プロジェクトの構成と既存のドキュメントを確認してください
- 適用前:AGENTS.md の各生成パターンに関する詳細な良い例/悪い例、制約、安全対策を確認してください
- エッジケース:ユーザーの目的が曖昧な場合は、ファイルを編集したりプロジェクト全体に関わるコマンドを実行したりする前に中断し、確認の質問をしてください
- エッジケース:必要なコンテキスト、ファイル、認証情報、ツールが不足している場合は、障害となっている事項を明確に報告し、セットアップを進めるか、代替のガイダンスを利用するか確認してください
- エッジケース:依頼された変更がプロジェクトの制約や安全上の境界と矛盾する場合は、その矛盾を説明し、どのトレードオフを優先するかユーザーに確認してください
このスキルを使う場面
- AGENTS.md を作成する
- AGENTS.md ファイルを更新する
- エージェント向けの指示を追加する
- Java エージェント向けの貢献者ガイドを生成する
- AGENTS.md にリポジトリの規約を記載する
ワークフロー
- 下書きの作成前にリポジトリのコンテキストを確認する
プロジェクトの構成と既存のドキュメントを確認し、AGENTS.md の要件確認フェーズで正確な回答を提示できるようにします。
- AGENTS 生成リファレンスを読む
references/200-agents-md.md を読み、そこに記載された生成パターンと安全対策に従います。
- 要件を対話形式で収集する
段階的なモジュール式の対話を通じて、役割、技術スタック、コマンド、ワークフロー、境界を収集します。
- AGENTS.md 成果物を生成する
✅ 常に実施 / ⚠ 事前に確認 / 🚫 絶対に実施しない、の境界と、リポジトリ固有の規約を含む AGENTS.md を作成します。
リファレンス
詳細なガイダンス、例、制約については、references/200-agents-md.md を参照してください。
コメント
Markdown 対応