用 Birdview 来改变开发的流程!真正地从关注代码到关注架构!解决 AI coding 的黑盒!
古法编程最后的优势是感知架构——Birdview 彻底终结了这个理由。
编程的未来只剩两件事:约束与架构。
快速开始 · 工作原理 · 交互演示 · 项目介绍页 · English
Birdview 是一个安装给 AI 编程 Agent 的 Skill,把**架构与约束**放到同一个可审阅的视图中。它帮助你了解项目如何组织、哪些规则适用,以及 AI 准备修改什么。有编码任务时,Agent 先展示地图和修改计划,等待你确认,再实施并记录验证结果。输出为独立、可交互的 HTML 页面,浏览器直接打开即可,无需部署服务。 **[项目介绍页](https://qiuner.github.io/birdview/):** [qiuner.github.io/birdview](https://qiuner.github.io/birdview/) · **[主题](https://github.com/Qiuner/birdview#readme):** `agent-tools` `architecture-as-code` `code-visualization` `coding-agents` `developer-tools` `software-architecture` 例如,你调用 Birdview,让 AI“给登录接口增加限流”: - 普通流程:AI 直接搜索和修改代码,你最后从 diff 中判断它是否漏改或误改。 - Birdview 流程:AI 展示登录模块、适用的接口和安全规则、拟修改文件及判断依据。等待你确认范围后,再实施并记录实际运行的检查。 Birdview 不会自动监听 Agent 的每一步,也不会替代 Git diff、测试或代码审查。它把 Agent 对项目的理解和它声明的修改范围放到同一张架构图上,让你更早发现范围错误,而不是等代码写完再猜。
QQ 群:627760389
也可以直接在 GitHub [分享使用反馈](https://github.com/Qiuner/birdview/issues/new?template=usage_feedback.yml):成功使用、遗漏模块、错误关系或安装问题都可以。不需要提供私有源码,截图和脱敏示例选填。 ## 查看器指引 打开集成页面后,可以切换**架构**和**约束**。架构包含项目全图;提供活动记录时,还可查看更改和并排对照。点击模块查看职责、所属文件和源码依据,活动历史记录 Agent 声明的计划、进度与检查结果。 约束页可**按主题**理解规则,或**按目录**追溯文件。双击节点查看具体解释或来源原文,通过**阅读范围**检查审查覆盖和缺口。角色颜色与架构图一致,不代表合规结果。 第一次打开时可跟随**使用指引**浏览,也可以随时跳过或按 Escape 退出。之后仍可从工具栏重新打开指引。 ## 显式调用 无论哪种模式,激活后都会先展示地图和拟修改范围,等待你确认后再改代码。同一已确认范围内不重复询问,范围发生实质变化时再确认。仅看图的请求在交付后结束。这是 Agent 执行规则,不是 HTML 页面的强制写入锁。 Birdview **默认按需调用**。普通编码、小修复和功能规划默认不触发,可主动开启项目自动模式。 - **Codex:** 输入 `/skills` 选择 Birdview,或输入 `$birdview`。 - **Claude Code:** 使用 `/birdview` 调用已安装技能。 - **DeepSeek Harness 等宿主:** 使用宿主的技能选择器,或明确要求使用 Birdview;斜杠命令支持取决于宿主。 例如:“使用 Birdview 展示这个项目的架构和约束,不修改代码。”调用只作用于当前任务,不延伸到未来修改。技能在开始流程前检查项目模式;宿主调用配置允许项目主动启用自动模式。 自动模式为可选项:开启后,每次改代码(含小改动)及明确分析涉及模块的规划前都会触发。新项目默认按需;`AGENTS.md` 或 `CLAUDE.md` 中已有的 `Birdview mode: auto` 继续有效。选择或查询项目模式: ```sh node