SuperAPI AI 工具集

nan-codebase-architecture-atlas

编程与开发

查看项目

更新于 10-16 01:34

技能介绍

用途:把代码库转为本体(实体/关系/数据流/设计原则),再生成可下钻的交互式架构网页。交付物为 designs/<slug>-architecture-atlas/ 下的多文件工程(<Name> Atlas.html + data.js + app.js)及单文件离线版 HTML,含 L1 全景、L2 模块拓扑、L3 模块内部、L4 数据流时序图与设计原则页,支持单击详情抽屉、双击下钻、⌘K 搜索、平移缩放、URL hash 定位与主题切换。

工作流分五阶段:0 主题(可选,写入 meta.theme);1 并行勘探,按仓库/高内聚模块/跨边界接口切分 4–8 个单元,每单元要求实体≥15、关系≥12、数据流≥3,返回六段式报告,≥5 单元时落盘 exploration/*.md;2 本体建模,先跑 bash <skill>/scripts/preflight.sh <dir> 预检,复制模板并备份 data.js,从勘探推导 kinds/relKinds 词表再填 entities/relations/views/flows/principles;3 视图布局,每视图≤22 节点,手工排坐标;4 验证,依次运行 node <skill>/scripts/validate_atlas_data.js <dir>/data.js、node <skill>/scripts/lint_atlas_layout.js <dir>/data.js、bash <skill>/scripts/shoot_atlas.sh <dir> 4311 overview,endpoint,srv 并逐张目检;5 交付,用 python3 <skill>/scripts/build_standalone.py <dir> "<入口文件名>.html" 生成单文件版。

限制与规则:先勘探后建模,实体/关系须有代码证据,禁止虚构;词表须由本项目推导;id 作对象键必须加引号,优先用 _;每次改动后立即 validate,改动前备份;模板平铺时禁止 mv 覆盖同名文件;单文件版只由脚本生成、不手改;无视觉环境需声明未经人眼目检。