SuperAPI AI 工具集

architecture-navigator

通用与其它

查看项目

更新于 10-15 19:57

技能介绍

用途:为 DevPrep AI 代码库提供架构智能,生成实时架构图,回答新功能应放置位置的问题,并根据 7 文件夹结构校验代码组织;避免每次对话手动阅读架构文档。

主要能力:

  1. 架构扫描:运行 bash ./.claude/skills/architecture-navigator/scripts/scan_architecture.sh,输出 7 文件夹结构(modules/、shared/、lib/、store/、types/、styles/、app/)、模块列表、关键位置(API 层、状态管理、UI 组件)和文件数等统计,约 50-100 行 markdown。
  2. 放置查询:按决策树回答,如路由/页面放 app/、功能专属放 modules/{feature}/、可复用 UI/逻辑放 shared/、外部集成放 lib/、全局状态放 store/、共享类型放 types/、纯样式放 styles/;详细规则见 references/architecture-rules.md。
  3. 模块发现:用 ls -1 frontend/src/modules/ 或 find 命令列出模块及文件数。
  4. 架构校验:检查 app/ 是否最小化、业务逻辑是否在 modules/、跨模块导入是否违规等,可用 grep 检查。

使用方式:对话开始时主动扫描;被问“放哪里”时给出具体路径并解释理由;创建新模块时确认是功能域专属,并按 components/、hooks/、utils/、types.ts 结构建议;可在检测到“where should”“architecture”“folder structure”等词时自动触发,或用 /architecture 手动调用。

适用场景:代码组织、模块定位、新功能放置、架构合规检查、导入方向解释。

限制:仅面向 DevPrep AI 特定代码库;具体模块名与数量需扫描后确定;其余环境要求、收费信息暂未提供。