Qiuner/birdview

解決的問題

Birdview 解決了 AI 編碼代理的「黑箱」問題。在這種問題中，開發者通常只能看到最終的程式碼差異，而無法理解 AI 的推理過程或其變更對架構的影響。它透過強制代理在開始實施之前映射專案並聲明哪些模組和檔案將受到影響，從而防止範圍錯誤。

運作原理

Birdview 作為 AI 代理的一項技能發揮作用。該過程分為兩個階段：

1. 映射：代理分析原始碼以建立 architecture.json 檔案，描述模組、其職責以及它們之間的連接方式。
2. 執行：在任務期間，代理在 activity.jsonl 檔案中記錄其計畫範圍和進度。

這些檔案隨後經過驗證並渲染為獨立的互動式 HTML 頁面。該頁面允許開發者視覺化系統地圖、代理打算修改的具體檔案、支持這些聲明的原始碼證據，以及代理執行的驗證檢查。

適用對象

它專為使用 AI 編碼代理（如 Claude Code、Codex 或 DeepSeek Harness）並希望對其程式碼庫中 AI 引入的變更擁有更高透明度和架構控制權的開發者設計。

亮點

• 視覺化架構映射：將專案結構轉換為模組和關係的互動式地圖。
• $’$Architecture-as-Code’$ 方法：使用 JSON 模式確保代理對系統的理解是結構化且一致的。
• 實施前驗證：允許使用者在 AI 完成程式碼編輯之前發現範圍錯誤。
• 零基礎設施檢視器：生成獨立的 HTML 檔案，可在任何瀏覽器中開啟，無需部署伺服器。