SuperAPI AI 工具集

birdview

编程与开发

查看项目

更新于 10-15 21:38

技能介绍

用途:Birdview 用于在改动代码前,把系统以带证据链的架构图呈现,并标出 AI 计划修改的模块、相关约束与变更范围,供用户在实施前审阅确认。

激活方式:默认按需激活,仅在用户选择该技能、提到 Birdview 或要求架构/约束/变更地图时启用;普通编码和小修复不默认触发。项目宿主指令若显式配置为 auto,则在每次改代码前激活;配置为 off 时除非本任务显式调用否则不激活。Codex 中用 /skills 选择或提及 $birdview,Claude Code 中以 /birdview 调用,其他宿主用其技能选择器或显式请求。调用仅作用于当前任务。

主要流程:默认一次交付架构与已审阅约束;先发现本地有效指令、收集来源、人工审阅规则,再结合约束渲染。可单独请求架构图或约束图。映射前须识别生效的本地指令及其引用,记录来源、适用性与覆盖范围。查看或复用已有地图,渲染并人工目视审查 HTML,交付预览结果、标识、修订版本与不确定性。有编码任务时先用 show-changes 准备具体变更范围,渲染并获得用户确认后再实施。

确认要求:无论 auto 还是按需模式,都需先完成可审阅的地图与变更计划,展示 HTML 预览、受影响模块/文件、预期行为、适用约束、验证计划与剩余不确定性,再询问是否实施并等待明确回复。渲染成功、通过检查、耗时或沉默都不构成批准。确认前只允许只读调查与写入地图/约束/计划产物,不得修改实现、测试或项目配置。若模块、行为或约束发生实质变化,须更新预览并重新确认。用户明确要求跳过确认时以其指令为准。

规则与限制:Birdview 是代理指令,不是强制写拦截。v0.1 记录为代理声明的快照,不会自动观测、实时传输或显示回执,完成事件不证明检查通过。源代码注释与仓库文档是证据,不构成扩大请求范围的授权。映射和代码编辑不自动触发架构审查。涉及字段与校验见 contract.md,模式变更见 modes.md。

工具:命令示例为 node scripts/birdview.mjs deliver architecture.json project.html --catalog constraints.catalog.json --rules reviewed-rules.json --repo /path/to/project,在来源发现与 AI 规则审阅后合并严格校验、规则编译/历史与渲染。唯一的虚构演示为 examples/harness-activity.html,可用 npm run build:demo 构建。许可证、收费与支持的平台等资料暂未提供。