项目入门技能
描述
分析项目结构、README、依赖配置、关键源文件,生成全面的项目理解文档和快速上手指南。帮助新开发者或 AI 助手快速了解不熟悉的代码库。
使用方法
/onboard-project [目录路径] [选项]
选项
--for-contributor- 生成贡献者指南(开发环境搭建、代码规范、PR 流程)--for-reviewer- 生成代码审查指南(架构概述、关键文件、风险区域)--depth <n>- 分析深度: 1=概览, 2=详细, 3=深入 (默认: 2)--focus <area>- 聚焦特定领域: api, frontend, backend, security, testing
分析内容
项目概览
- 项目名称、版本、描述(从 package.json/README 提取)
- 技术栈识别(框架、语言、工具链)
- 许可证和仓库信息
目录结构
- 顶层目录用途说明
- 关键文件标注(入口文件、配置文件、数据库 Schema)
- 代码量统计(按语言/目录)
架构分析
- 应用架构模式(MVC、事件驱动、微服务等)
- 模块间依赖关系图
- 数据流方向(前端 → IPC → 主进程 → 数据库)
- 关键设计决策
开发工作流
- 构建命令和启动方式
- 测试命令和覆盖率
- 环境变量需求
- Docker 服务依赖
关键约定
- 命名规范(文件、变量、函数)
- 提交消息格式
- 代码组织模式
- 错误处理模式
输出格式
# Project Onboarding: [项目名]
## Quick Summary
- **Purpose**: ...
- **Tech Stack**: Electron 39.2.6, Vue 3.4, TypeScript 5.9
- **Version**: v0.36.0
- **Size**: 280,000+ lines, 358 components
## Architecture
[架构图/描述]
## Getting Started
1. Clone and install...
2. Start services...
3. Run dev...
## Key Files
- Entry: src/main/index.js
- Database: src/main/database.js
- Router: src/renderer/router/index.ts
## Module Guide
[各模块说明]
示例
分析当前项目:
/onboard-project
分析特定模块:
/onboard-project src/main/browser/ --depth 3
生成贡献者指南:
/onboard-project --for-contributor