Birdview

它做什么

• 动手前的架构地图：模块与其职责、agent 计划触碰的文件、每条判断背后的源码证据，同页呈现
• 独立可交互 HTML——明暗主题、关系过滤、模块详情、双语控件；双击即开，无需任何服务
• 验证记录与计划并列：agent 实际跑过的检查、通过与否，一目了然
• 页面生成前对架构数据与活动记录做结构与一致性校验

什么时候用

审查 AI 改动、希望在实施完成前就拦住范围错误的人——尤其在大型代码库里，「这次到底会动哪些文件」正是第一个该问的问题。

如何上手

# 第三方 skills CLI：
npx skills add Qiuner/birdview --skill birdview

# 然后发起任务，例如：
#   用 Birdview 展示本项目的架构；不要改代码。
# 预期产出 .birdview/architecture.json + 一张可在浏览器打开的 HTML 架构图

注意事项

MIT，v0.2.1。Birdview 不会自动监听 agent 的每个动作，也不替代 Git diff、测试与 code review——地图的边界就是 agent 自己声明的计划。README 中的截图来自仓库自带的虚构 agent harness，并非真实生产环境的活动记录。Node 18+；安装指南覆盖 Codex、Claude Code 与 DeepSeek Harness。