agent-sh/agnix

解決的問題

agnix 防止 AI 代理設定靜默失敗。許多 AI 工具（如 Claude Code、Cursor 和 Copilot）依賴特定的設定檔（例如 CLAUDE.md、.cursorrules）來定義技能與指令。如果這些檔案包含語法錯誤或不良模式，AI 代理可能會完全忽略這些指令，或產生次優結果，而不會通知使用者。

工作原理

它作為代理設定的 linter，使用從官方規格與研究中提取的 455 條規則。它掃描各種 AI 工具堆疊中的特定設定檔，並標記錯誤或警告。該工具提供自動修復功能，可自動修正常見錯誤，並透過 CLI、GitHub Actions 和編輯器擴充直接整合到開發工作流程中。

適用對象

使用 AI 編碼助手與代理（如 Claude Code、Cursor、Copilot、Cline 或 Gemini CLI）的開發者，希望確保其自訂指令與技能定義正確實作並處於啟用狀態。

主要亮點

• 廣泛工具支援：驗證 Claude Code、Cursor、GitHub Copilot、MCP、Gemini CLI 等多種工具的設定。
• 自動修復功能：可自動套用安全或不安全的修復來修正損壞的設定。
• 多平台整合：提供 CLI（npm、Homebrew、pip、Cargo）、GitHub Action 以及 VS Code、JetBrains、Neovim 和 Zed 的擴充。
• 豐富的規則集：包含 455 條規則，可檢測從無效命名慣例到通用且無效的指令等各類問題。