Codebase Pattern Analyzer 是一个用于系统分析参考代码库并提取可复用架构模式的技能。它把分析结果整理为结构化模式描述,作为后续 skill-template-generator 技能生成独立 SKILL.md 的输入素材。
用途
当需要在复刻前理解大型代码库的结构、从参考项目中提取特定模式(组件架构、服务层、API 代理等),或让新项目沿用既有项目约定时使用。
分析流程
Step 1 映射目录结构:读取项目根目录与 src 等顶层目录,将各目录归类为组件、服务、配置、样式、工具、API 层、入口点等角色。
Step 2 识别组件模式:定位被最多引用的基础组件类,提取构造选项接口、DOM 结构、生命周期方法、状态管理(加载/错误/内容态与请求防护)和数据绑定方式,记录为基础类、选项、DOM 树、状态、生命周期和关键方法。
Step 3 识别服务层模式:查看 2-3 个服务文件,归纳熔断与重试、接口类型定义、请求方式(直接 fetch、代理或批处理)、缓存策略(TTL、stale-while-revalidate、内存缓存)、错误处理与默认返回值、导出形式。
Step 4 识别 API 代理模式:读取服务端代理层,提取每端点一文件结构、CORS 处理(来源白名单、预检响应)、API 密钥隔离(process.env,不暴露给前端)、缓存响应头、结构化错误包装和查询参数校验。
Step 5 识别样式系统:读取主 CSS 文件前段,提取 CSS 自定义属性(颜色、字体、间距)、明暗主题切换机制、网格布局参数、组件基础样式、语义色彩与排版规则。
Step 6 识别调度/刷新模式:查看刷新调度文件,提取面板刷新函数注册方式、可配置间隔、标签页隐藏时暂停并在返回时补刷、并发刷新防护和恢复时的错峰逻辑。
Step 7 综合输出:每个模式输出为包含名称、来源文件、类别、结构、关键代码(20-40 行代表性片段)、命名与文件组织约定、依赖关系和适配说明的描述列表。
使用建议
先广泛浏览目录再深入读文件;顺着 import 关系继续追踪;统计同一基类的继承实例数量以辨别核心模式;注意项目中未使用的技术(如无 React/Vue 框架、无 ORM)以理解实现风格;对比 2-3 个同类实例,区分通用模板与实例特有部分。
适用场景
复刻或迁移大型代码库前的结构梳理、从参考项目抽取特定架构模式、为新项目建立与既有项目一致的约定。
限制
该技能依赖对目标代码库的目录列举与文件读取操作,分析质量取决于代码库可访问性与代表性;具体运行环境、安装方式与集成细节暂未提供。