SuperAPI AI 工具集

project-blueprint

编程与开发

查看项目

更新于 10-15 17:32

技能介绍

用途:以描述性方式映射代码库,发现“切片”(新增同类工作时反复出现的目录/文件结构模板),输出可提交的架构参考文档。

主要能力:检测单体仓库与单项目;识别技术栈与分层;检测实体、值对象、仓储、领域服务、应用服务、领域事件、驱动/被驱动适配器、端口、配置类等构建块;按文件名模式聚类发现切片(N≥2 为候选,N=1 需人工分类);识别维度(渠道、租户、模块);记录横切约定与不对称;单体仓库生成系统地图。

输出:单项目 docs/architecture/BLUEPRINT.md;多项目 docs/architecture/SYSTEM_MAP.md 加各项目 BLUEPRINT.md。UNIVERSAL_NOTES.md 默认不生成,仅在用户明确要求通用扫描时输出到对话。

使用方式:按工作流执行,含 5 个必须暂停询问的检查点(项目清单、规范样本平局、维度标签、N=1 分类、写入前确认)。检测清单文件使用 find 命令(保留原样):find . -maxdepth 3 -type f ( -name '.csproj' -o -name '.sln' -o -name 'package.json' -o -name 'pyproject.toml' -o -name 'requirements.txt' -o -name 'setup.py' -o -name 'Pipfile' -o -name 'go.mod' -o -name 'Cargo.toml' -o -name 'pom.xml' -o -name 'build.gradle' -o -name 'build.gradle.kts' -o -name 'composer.json' -o -name 'Gemfile' -o -name 'mix.exs' ) -not -path '/node_modules/' -not -path '/.venv/'。写入使用 assets/blueprint-template.md 与 assets/system-map-template.md,未经明确同意不提交。

适用场景:需要为团队沉淀代码库真实结构参考、帮助新成员理解约定与切片模板时。

限制:不做反模式审计持久文件、不建议重构、不对比 PR、不替团队做架构决策;每条结论需有路径/文件/行证据,否则标记 ⚠️ 或列入开放问题;尊重 CLAUDE.md 或决策文档中已记录的刻意选择。