agnix
在工作流程中斷之前，先對代理設定進行 lint 檢查。驗證 Skills、Hooks、MCP、Memory、Plugins 在 Claude Code、Cursor、GitHub Copilot 和 Codex CLI 中的正確性。
使用時機
當使用者要求以下事項時啟用：
- 「檢查我的代理設定」
- 「驗證我的技能」
- 「檢查我的 CLAUDE.md」
- 「驗證 hooks」
- 「檢查 MCP 設定」
- 「修復代理設定問題」
支援的檔案
| 檔案類型 | 範例 |
|---|---|
| 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. 若發現問題並要求修復
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: Generic instruction 'Be helpful' [fixable]
help: Remove generic instructions. Claude already knows this.
skills/review/SKILL.md:3:1 error: Invalid name [fixable]
help: Use lowercase letters and hyphens only
Found 1 error, 1 warning (2 fixable)
常見問題與解決方案
| 問題 | 解決方案 |
|---|---|
| 無效的技能名稱 | 使用小寫字母與連字號：my-skill |
| 通用指令 | 移除「保持友善」、「保持準確」等 |
| 缺少觸發詞 | 在描述中加入「Use when...」 |
| 目錄與名稱不符 | 將目錄重新命名以符合 name: 欄位 |