SuperAPI AI 工具集

source-code-analysis

编程与开发

查看项目

更新于 10-15 20:04

技能介绍

用途:对软件项目进行由外向内的系统化源码分析,先看元数据与依赖,再看结构,最后深入内部逻辑,并遵循“跟随数据”原则追踪从输入到输出的主数据管线。

模式:Quick Scan约5至10分钟,Phase 1-2,用于了解项目概览;Standard约20至30分钟,Phase 1-5,用于重构或贡献前准备;Full Audit约60分钟以上,Phase 1-7,包含安全与质量审计。未特别指定时默认使用Standard。

七个阶段:1)Surface Scan,读取package.json、tsconfig.json、Cargo.toml、pyproject.toml、go.mod、Dockerfile等,产出项目身份卡;2)Architecture Mapping,扫描目录树、识别模块与分层、检查DI/IoC,生成Mermaid架构图,完成后须停下询问用户聚焦领域;3)Core Pipeline Tracing,追踪主数据流,可用子代理并行分析主路径、辅助路径与错误/回退路径,产出Mermaid数据流图;4)Deep Dive,对核心组件梳理职责、方法签名、状态管理、错误处理与设计模式,产出组件卡;5)Dependencies & Integration,分类外部依赖并给出替代方案;6)Security & Quality,仅Full Audit执行,检查OWASP Top 10、硬编码密钥、注入风险、认证授权与技术债;7)Output Generation,配合note-writer生成学习笔记,存放于00-notes/technology/{project-name}-analysis/,并在references/下拆分详细文档、与既有笔记建立wikilink。

可与其他技能联动:复杂架构分解用decompose-recompose,验证设计假设用first-principles,最终笔记生成用note-writer。各语言与框架的分析启发式见language-patterns.md,各阶段检查清单见phase-checklists.md,笔记结构见output-template.md,这些文件的具体内容暂未提供。