ldomaradzki/xcsift

解決的問題

xcsift 解決了 Xcode 建構與 Swift Package Manager (SPM) 輸出過於冗長且以人類為中心的問題。雖然像 xcbeautify 之類的工具讓日誌對人類更易讀，但並未針對大型語言模型（LLMs）或程式碼代理進行最佳化，這些模型在處理原始建構日誌時容易被雜訊干擾，並消耗過多的 token。

工作原理

它作為命令列管道運作，接收 xcodebuild 或 swift build 的輸出。解析原始日誌並轉換為結構化、機器可讀的格式。它提供一種專為減少 30–60% token 使用量而設計的「TOON」格式，相比標準 JSON 更適合 LLM 處理。

適用對象

此工具主要針對使用 AI 程式碼助手（如 Claude Code、Cursor 或 Codex）的開發者，以及需要結構化建構資料進行自動化分析的 CI/CD 流水線工程師。

主要特色

• LLM 最佳化格式：提供 JSON 與高密度 TOON 格式，以最小化 token 成本並最大化代理效率。
• 結構化錯誤報告：精確提取錯誤、警告與連結器失敗，並包含檔案與行號位置。
• 自動覆蓋轉換：將 .profraw 與 .xcresult 檔案自動轉換為 JSON 格式。
• 代理整合：內建支援 Claude Code 與 Cursor 等流行程式碼助手的安裝程式。
• CI 就緒：支援 GitHub Actions 集成，可於 PR 中產生內嵌評論，並提供將警告視為錯誤的模式。