agent-instruction

agent-instruction

開発セッション中に、モノレポ内の AI 指示ファイルを管理します。このスキルは、開発中に見つけたベストプラクティスを、永続的な指示としてまとめる作業を支援します。

agent-instruction CLI を使用して、ルールの追加、指示ファイルのビルド、既存ルールの一覧表示を行います。

必要条件： agent-instruction CLI がインストールされ、PATH に設定されていること（go install github.com/validkeys/agent-instruction@latest）

コマンド

add_rule

ルールファイルに新しい指示ルールを追加します。

agent-instruction add "[rule content]" --title "[title]" --rule="[rule-file]"

• content（必須）：指示ルールのテキスト
• --title（任意）：ルールのセクション見出し
• --rule（任意）：対象のルールファイル名（省略すると対話形式で入力を求められます）

例：

agent-instruction add "Always use table-driven tests in Go" --title="Testing Standards" --rule="testing"
agent-instruction add "Never use global variables" --title="Code Standards"
agent-instruction add "Validate all user input before database queries" --rule="security"

build

すべてのルール設定から指示ファイル（CLAUDE.md、AGENTS.md）を生成または更新します。

agent-instruction build

list

利用可能なすべてのルールファイルとその内容を表示します。

agent-instruction list [--verbose]

• --verbose（任意）：書式を含むルールの全文を表示します

ベストプラクティス

• 追加する前に確認する： 重複を避けるため、ルールを追加する前に agent-instruction list --verbose を実行します。
• 変更後にビルドする： 複数のルールを追加した後、agent-instruction build を実行して、変更を CLAUDE.md と AGENTS.md に反映します。
• 内容が分かるタイトルを付ける： 明確で具体的なタイトルを付けると、後からルールを見つけやすくなります。
• 関連するルールをまとめる： カテゴリ名を付けたルールファイルを使用します（例：testing.json、security.json、golang.json、global.json）。
• ルールを追加するタイミング： ユーザーから「次回のためにこれを覚えておいて」と言われたとき、繰り返し発生するミスが見つかったとき、または新しい標準が確立されたときです。

注意事項

このスキルを利用するには、agent-instruction CLI がインストールされ、PATH から利用できる必要があります。CLI は .agent-instruction/ ディレクトリ内のルールファイルを管理し、リポジトリのルートに指示ファイルをビルドします。