with-context-agent

Agnix 是一款專門的診斷與自動化工具，旨在確保 AI 代理設定檔的完整性。隨著 AI 驅動的開發流程越來越依賴特定的清單格式與配置結構，錯誤的配置往往導致靜默失敗、工具失效或代理行為異常。Agnix 提供了一個全面的檢查引擎，可針對 Claude Code、Cursor 規則 (.mdc)、GitHub Copilot 指令與模型上下文協議 (MCP) 等多種框架，驗證其語法、結構與語義規則。透過在配置到達執行層之前識別問題，開發人員可以確保其代理指令與技能定義已準備好投入生產。

此工具專為管理多種工具堆疊的開發人員與 AI 工程師設計，提供統一的配置管理方案。無論您是在處理本地技能定義還是複雜的全局上下文檔案（如 CLAUDE.md 或 AGENTS.md），Agnix 皆能確保每個欄位與指令均符合最佳實作。它透過 GitHub Actions、CLI CI/CD 整合以及 IDE 擴充功能的實時回饋，提供即時分析與可執行的建議，協助恢復代理功能。

• 支援多種格式，包括 YAML、JSON、TOML 與 Markdown 前言格式。

• 涵蓋 Claude Code、Codex CLI、Cursor、Copilot 與 MCP 配置的 400 多條驗證規則。

• 具備分級信賴度的自動修復引擎 (--fix-safe, --fix-unsafe)。

• 透過語言伺服器協議 (LSP) 整合提供實時診斷回饋。

• 具備跨檔案驗證能力，檢查整個專案的一致性與參考關聯。

• 透過 SARIF 格式輸出，適用於自動化 CI/CD 構建流程。

• 包含針對指令清晰度與預防常見提示工程陷阱的特殊規則。

• 使用 CLI 工具 (agnix .) 進行專案級審核。

• 使用 --fix 旗標自動解決常見語法問題與過時欄位。

• 透過 LSP 整合將其連接至 VS Code、JetBrains、Neovim 或 Zed，實現編寫時的即時檢查。

• 使用線上遊樂場 (playground) 進行片段測試，無需本地安裝。

• 輸入：包含 .md, .json, .yaml 的清單檔案；輸出：診斷日誌、SARIF 報告與自動修復後的檔案。

• 限制：安裝需 node/npm 或 cargo 環境；依賴於特定代理平台的一致性架構強制執行。