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 文件，可在任何浏览器中打开，无需部署服务器。