agnix
ワークフローが壊れる前にエージェント設定を lint します。Claude Code、Cursor、GitHub Copilot、Codex CLI 向けの Skills、Hooks、MCP、Memory、Plugins を検証します。
使用タイミング
ユーザーが次のように依頼したときに呼び出します：
- 「エージェント設定を lint して」
- 「スキルを検証して」
- 「CLAUDE.md をチェックして」
- 「フックを検証して」
- 「MCP 設定を lint して」
- 「エージェント設定の問題を修正して」
対応ファイル
| ファイルタイプ | 例 |
|---|---|
| Skills | SKILL.md |
| Memory | CLAUDE.md, AGENTS.md |
| Hooks | .claude/settings.json |
| MCP | *.mcp.json |
| Cursor | .cursor/rules/*.mdc |
| Copilot | .github/copilot-instructions.md |
実行手順
1. agnix がインストールされているか確認
agnix --version
見つからない場合はインストール：
cargo install agnix-cli
2. 検証
agnix .
3. 問題が見つかり --fix が要求された場合
agnix --fix .
4. 再検証して確認
agnix .
CLI リファレンス
| コマンド | 説明 |
|---|---|
agnix . | カレントプロジェクトを検証 |
agnix --fix . | 問題を自動修正 |
agnix --strict . | 警告をエラーとして扱う |
agnix --target claude-code . | Claude Code ルールのみ |
agnix --target cursor . | Cursor ルールのみ |
agnix --watch . | ウォッチモード |
agnix --format json . | JSON 形式で出力 |
出力形式
CLAUDE.md:15:1 warning: 汎用指示「役に立つように振る舞って」[修正可能]
help: 汎用指示を削除してください。Claude はすでにこれを認識しています。
skills/review/SKILL.md:3:1 error: 無効な名前 [修正可能]
help: 小文字とハイフンのみを使用してください
Found 1 error, 1 warning (2 fixable)
よくある問題と修正
| 問題 | 解決策 |
|---|---|
| 無効なスキル名 | 小文字とハイフンを使用：my-skill |
| 汎用的な指示 | 「役に立つように振る舞って」「正確に振る舞って」を削除 |
| トリガーフレーズの欠落 | 説明に「Use when...」を追加 |
| ディレクトリ名と名前の不一致 | ディレクトリ名を name: フィールドに合わせる |