用途
Explain Codebase 是一个用于生成代码库全面概览的技能，主要服务于以下场景：
- 新成员入职（onboarding）
- 知识传递（knowledge transfer）
- 架构理解（architecture understanding）
当用户表达“解释这个代码库”之类的需求时，该技能会启动一套结构化的解释流程，目标是让读者获得理解项目并自信开始贡献所需的信息。
主要能力
该技能按以下结构化流程组织输出：
-
发现（Discovery）：在解释之前先收集信息，包括项目身份（读取 README、package.json、pyproject.toml、Cargo.toml、go.mod、pom.xml、Gemfile、composer.json 等）、目录结构、技术栈检测（按文件类型统计语言、检测框架、数据库、基础设施）、代码库规模（文件数、代码行数、测试文件数）。
-
30 秒概览：用简洁摘要说明项目名称、应用类型、用途、目标用户、主要技术栈、关键能力、代码库规模。
-
架构概览：提供 ASCII 系统图展示主要组件，并给出目录映射，解释每个顶层目录的内容及组织原因。
-
关键概念与领域模型：解释核心业务领域，包括领域实体及其关系、关键业务规则、项目术语表。
-
关键路径：追踪最重要的用户流程在代码中的走向，如认证、核心功能、支付流程、数据摄取、通知流程。
-
数据流与状态管理：说明数据存放位置、数据如何流动、前端状态管理方案。
-
外部依赖与集成：列出第三方服务、内部服务及其通信方式。
-
配置与环境：说明环境变量、不同环境之间的差异。
-
开发工作流：提供入门步骤、常见任务命令、Git 工作流说明。
-
已知陷阱与团队知识：列出代码中不明显的注意事项、历史背景、技术债务区域。
-
快速参考：针对常见任务给出“去哪里找”的对照表。
使用方式
该技能以结构化流程执行，先扫描项目收集事实，再按上述章节组织解释。输出格式建议为：30 秒概览、架构图、目录映射、领域模型、关键路径、数据流、外部依赖、入门指南、陷阱、快速参考。
技能还包含适配规则：
- 小型项目（少于 50 个文件）：跳过第 6-8 节，保持简短
- 单体仓库（monorepo）：分别解释每个包/应用，再说明它们如何连接
- 微服务：从服务地图开始，再深入请求的服务
- 纯前端：聚焦组件层级、状态管理和路由
- 纯后端：聚焦 API 结构、数据库模式和任务处理
- 新贡献者：强调入门、目录映射和“去哪里找”
- 架构评审：强调设计决策、权衡和技术债务
每次解释结束时建议包含：快速启动命令、第一个要读的文件、关键文件（5-10 个）、建议的第一个任务、可咨询的联系人或团队频道。
适用场景
- 新成员入职时快速理解项目
- 团队内部知识传递
- 架构评审前的背景梳理
- 接手陌生代码库时的探索
限制
该技能的具体实现细节、安装方式、收费模式、支持平台等信息暂未提供。