senior-fullstack
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseSenior Fullstack
资深全栈开发工具集
Fullstack development skill with project scaffolding and code quality analysis tools.
具备项目脚手架与代码质量分析工具的全栈开发技能工具集。
Table of Contents
目录
Trigger Phrases
触发场景
Use this skill when you hear:
- "scaffold a new project"
- "create a Next.js app"
- "set up FastAPI with React"
- "analyze code quality"
- "check for security issues in codebase"
- "what stack should I use"
- "set up a fullstack project"
- "generate project boilerplate"
当你听到以下内容时使用本技能:
- "搭建新项目"
- "创建Next.js应用"
- "配置FastAPI与React"
- "分析代码质量"
- "检查代码库中的安全问题"
- "我应该使用什么技术栈"
- "搭建全栈项目"
- "生成项目模板代码"
Tools
工具
Project Scaffolder
项目脚手架工具
Generates fullstack project structures with boilerplate code.
Supported Templates:
- - Next.js 14+ with App Router, TypeScript, Tailwind CSS
nextjs - - FastAPI backend + React frontend + PostgreSQL
fastapi-react - - MongoDB, Express, React, Node.js with TypeScript
mern - - Django REST Framework + React frontend
django-react
Usage:
bash
undefined生成带有模板代码的全栈项目结构。
支持的模板:
- - 带有App Router、TypeScript、Tailwind CSS的Next.js 14+
nextjs - - FastAPI后端 + React前端 + PostgreSQL
fastapi-react - - 基于TypeScript的MongoDB、Express、React、Node.js
mern - - Django REST Framework + React前端
django-react
使用方式:
bash
undefinedList available templates
列出可用模板
python scripts/project_scaffolder.py --list-templates
python scripts/project_scaffolder.py --list-templates
Create Next.js project
创建Next.js项目
python scripts/project_scaffolder.py nextjs my-app
python scripts/project_scaffolder.py nextjs my-app
Create FastAPI + React project
创建FastAPI + React项目
python scripts/project_scaffolder.py fastapi-react my-api
python scripts/project_scaffolder.py fastapi-react my-api
Create MERN stack project
创建MERN栈项目
python scripts/project_scaffolder.py mern my-project
python scripts/project_scaffolder.py mern my-project
Create Django + React project
创建Django + React项目
python scripts/project_scaffolder.py django-react my-app
python scripts/project_scaffolder.py django-react my-app
Specify output directory
指定输出目录
python scripts/project_scaffolder.py nextjs my-app --output ./projects
python scripts/project_scaffolder.py nextjs my-app --output ./projects
JSON output
JSON格式输出
python scripts/project_scaffolder.py nextjs my-app --json
**Parameters:**
| Parameter | Description |
|-----------|-------------|
| `template` | Template name (nextjs, fastapi-react, mern, django-react) |
| `project_name` | Name for the new project directory |
| `--output, -o` | Output directory (default: current directory) |
| `--list-templates, -l` | List all available templates |
| `--json` | Output in JSON format |
**Output includes:**
- Project structure with all necessary files
- Package configurations (package.json, requirements.txt)
- TypeScript configuration
- Docker and docker-compose setup
- Environment file templates
- Next steps for running the project
---python scripts/project_scaffolder.py nextjs my-app --json
**参数说明:**
| 参数 | 描述 |
|-----------|-------------|
| `template` | 模板名称(nextjs, fastapi-react, mern, django-react) |
| `project_name` | 新项目目录名称 |
| `--output, -o` | 输出目录(默认:当前目录) |
| `--list-templates, -l` | 列出所有可用模板 |
| `--json` | 以JSON格式输出 |
**输出内容包括:**
- 包含所有必要文件的项目结构
- 包配置文件(package.json, requirements.txt)
- TypeScript配置
- Docker与docker-compose配置
- 环境文件模板
- 项目运行后续步骤指引
---Code Quality Analyzer
代码质量分析工具
Analyzes fullstack codebases for quality issues.
Analysis Categories:
- Security vulnerabilities (hardcoded secrets, injection risks)
- Code complexity metrics (cyclomatic complexity, nesting depth)
- Dependency health (outdated packages, known CVEs)
- Test coverage estimation
- Documentation quality
Usage:
bash
undefined分析全栈代码库的质量问题。
分析类别:
- 安全漏洞(硬编码密钥、注入风险)
- 代码复杂度指标(圈复杂度、嵌套深度)
- 依赖健康度(过期包、已知CVE漏洞)
- 测试覆盖率估算
- 文档质量
使用方式:
bash
undefinedAnalyze current directory
分析当前目录
python scripts/code_quality_analyzer.py .
python scripts/code_quality_analyzer.py .
Analyze specific project
分析指定项目
python scripts/code_quality_analyzer.py /path/to/project
python scripts/code_quality_analyzer.py /path/to/project
Verbose output with detailed findings
查看详细分析结果
python scripts/code_quality_analyzer.py . --verbose
python scripts/code_quality_analyzer.py . --verbose
JSON output
JSON格式输出
python scripts/code_quality_analyzer.py . --json
python scripts/code_quality_analyzer.py . --json
Save report to file
将报告保存到文件
python scripts/code_quality_analyzer.py . --output report.json
**Parameters:**
| Parameter | Description |
|-----------|-------------|
| `project_path` | Path to project directory (default: current directory) |
| `--verbose, -v` | Show detailed findings |
| `--json` | Output in JSON format |
| `--output, -o` | Write report to file |
**Output includes:**
- Overall score (0-100) with letter grade
- Security issues by severity (critical, high, medium, low)
- High complexity files
- Vulnerable dependencies with CVE references
- Test coverage estimate
- Documentation completeness
- Prioritized recommendations
**Sample Output:**
============================================================ CODE QUALITY ANALYSIS REPORT
Overall Score: 75/100 (Grade: C)
Files Analyzed: 45
Total Lines: 12,500
--- SECURITY ---
Critical: 1
High: 2
Medium: 5
--- COMPLEXITY ---
Average Complexity: 8.5
High Complexity Files: 3
--- RECOMMENDATIONS ---
- [P0] SECURITY Issue: Potential hardcoded secret detected Action: Remove or secure sensitive data at line 42
---python scripts/code_quality_analyzer.py . --output report.json
**参数说明:**
| 参数 | 描述 |
|-----------|-------------|
| `project_path` | 项目目录路径(默认:当前目录) |
| `--verbose, -v` | 显示详细分析结果 |
| `--json` | 以JSON格式输出 |
| `--output, -o` | 将报告写入指定文件 |
**输出内容包括:**
- 整体得分(0-100)及等级
- 按严重程度划分的安全问题( critical、high、medium、low)
- 高复杂度文件
- 存在漏洞的依赖及CVE参考
- 测试覆盖率估算
- 文档完整度
- 优先级排序的改进建议
**示例输出:**
============================================================ 代码质量分析报告
整体得分:75/100(等级:C)
分析文件数:45
总行数:12,500
--- 安全问题 ---
严重:1
高风险:2
中风险:5
--- 复杂度 ---
平均复杂度:8.5
高复杂度文件:3
--- 改进建议 ---
- [P0] 安全问题 问题:检测到潜在硬编码密钥 处理建议:移除或保护第42行的敏感数据
---Workflows
工作流
Workflow 1: Start New Project
工作流1:启动新项目
- Choose appropriate stack based on requirements
- Scaffold project structure
- Run initial quality check
- Set up development environment
bash
undefined- 根据需求选择合适的技术栈
- 搭建项目结构
- 运行初始质量检查
- 配置开发环境
bash
undefined1. Scaffold project
1. 搭建项目
python scripts/project_scaffolder.py nextjs my-saas-app
python scripts/project_scaffolder.py nextjs my-saas-app
2. Navigate and install
2. 进入目录并安装依赖
cd my-saas-app
npm install
cd my-saas-app
npm install
3. Configure environment
3. 配置环境变量
cp .env.example .env.local
cp .env.example .env.local
4. Run quality check
4. 运行质量检查
python ../scripts/code_quality_analyzer.py .
python ../scripts/code_quality_analyzer.py .
5. Start development
5. 启动开发服务
npm run dev
undefinednpm run dev
undefinedWorkflow 2: Audit Existing Codebase
工作流2:审计现有代码库
- Run code quality analysis
- Review security findings
- Address critical issues first
- Plan improvements
bash
undefined- 运行代码质量分析
- 查看安全问题结果
- 优先处理严重问题
- 规划改进方案
bash
undefined1. Full analysis
1. 完整分析
python scripts/code_quality_analyzer.py /path/to/project --verbose
python scripts/code_quality_analyzer.py /path/to/project --verbose
2. Generate detailed report
2. 生成详细报告
python scripts/code_quality_analyzer.py /path/to/project --json --output audit.json
python scripts/code_quality_analyzer.py /path/to/project --json --output audit.json
3. Address P0 issues immediately
3. 立即处理P0级问题
4. Create tickets for P1/P2 issues
4. 为P1/P2级问题创建任务工单
undefinedundefinedWorkflow 3: Stack Selection
工作流3:技术栈选择
Use the tech stack guide to evaluate options:
- SEO Required? → Next.js with SSR
- API-heavy backend? → Separate FastAPI or NestJS
- Real-time features? → Add WebSocket layer
- Team expertise → Match stack to team skills
See for detailed comparison.
references/tech_stack_guide.md使用技术栈指南评估选项:
- 需要SEO支持? → 带SSR的Next.js
- 以API为核心的后端? → 独立FastAPI或NestJS
- 需要实时功能? → 添加WebSocket层
- 团队技术能力 → 选择匹配团队技能的技术栈
详情请查看中的详细对比。
references/tech_stack_guide.mdReference Guides
参考指南
Architecture Patterns (references/architecture_patterns.md
)
references/architecture_patterns.md架构模式(references/architecture_patterns.md
)
references/architecture_patterns.md- Frontend component architecture (Atomic Design, Container/Presentational)
- Backend patterns (Clean Architecture, Repository Pattern)
- API design (REST conventions, GraphQL schema design)
- Database patterns (connection pooling, transactions, read replicas)
- Caching strategies (cache-aside, HTTP cache headers)
- Authentication architecture (JWT + refresh tokens, sessions)
- 前端组件架构(原子设计、容器/展示组件模式)
- 后端模式(整洁架构、仓库模式)
- API设计(REST规范、GraphQL Schema设计)
- 数据库模式(连接池、事务、读副本)
- 缓存策略(旁路缓存、HTTP缓存头)
- 认证架构(JWT+刷新令牌、会话)
Development Workflows (references/development_workflows.md
)
references/development_workflows.md开发工作流(references/development_workflows.md
)
references/development_workflows.md- Local development setup (Docker Compose, environment config)
- Git workflows (trunk-based, conventional commits)
- CI/CD pipelines (GitHub Actions examples)
- Testing strategies (unit, integration, E2E)
- Code review process (PR templates, checklists)
- Deployment strategies (blue-green, canary, feature flags)
- Monitoring and observability (logging, metrics, health checks)
- 本地开发环境配置(Docker Compose、环境变量配置)
- Git工作流(主干开发、规范化提交)
- CI/CD流水线(GitHub Actions示例)
- 测试策略(单元测试、集成测试、端到端测试)
- 代码评审流程(PR模板、检查清单)
- 部署策略(蓝绿部署、金丝雀发布、功能开关)
- 监控与可观测性(日志、指标、健康检查)
Tech Stack Guide (references/tech_stack_guide.md
)
references/tech_stack_guide.md技术栈指南(references/tech_stack_guide.md
)
references/tech_stack_guide.md- Frontend frameworks comparison (Next.js, React+Vite, Vue)
- Backend frameworks (Express, Fastify, NestJS, FastAPI, Django)
- Database selection (PostgreSQL, MongoDB, Redis)
- ORMs (Prisma, Drizzle, SQLAlchemy)
- Authentication solutions (Auth.js, Clerk, custom JWT)
- Deployment platforms (Vercel, Railway, AWS)
- Stack recommendations by use case (MVP, SaaS, Enterprise)
- 前端框架对比(Next.js、React+Vite、Vue)
- 后端框架(Express、Fastify、NestJS、FastAPI、Django)
- 数据库选择(PostgreSQL、MongoDB、Redis)
- ORM工具(Prisma、Drizzle、SQLAlchemy)
- 认证解决方案(Auth.js、Clerk、自定义JWT)
- 部署平台(Vercel、Railway、AWS)
- 按场景推荐技术栈(MVP、SaaS、企业级)
Quick Reference
快速参考
Stack Decision Matrix
技术栈决策矩阵
| Requirement | Recommendation |
|---|---|
| SEO-critical site | Next.js with SSR |
| Internal dashboard | React + Vite |
| API-first backend | FastAPI or Fastify |
| Enterprise scale | NestJS + PostgreSQL |
| Rapid prototype | Next.js API routes |
| Document-heavy data | MongoDB |
| Complex queries | PostgreSQL |
| 需求 | 推荐方案 |
|---|---|
| SEO关键站点 | 带SSR的Next.js |
| 内部仪表盘 | React + Vite |
| API优先后端 | FastAPI或Fastify |
| 企业级规模 | NestJS + PostgreSQL |
| 快速原型开发 | Next.js API路由 |
| 文档型数据 | MongoDB |
| 复杂查询 | PostgreSQL |
Common Issues
常见问题
| Issue | Solution |
|---|---|
| N+1 queries | Use DataLoader or eager loading |
| Slow builds | Check bundle size, lazy load |
| Auth complexity | Use Auth.js or Clerk |
| Type errors | Enable strict mode in tsconfig |
| CORS issues | Configure middleware properly |
| 问题 | 解决方案 |
|---|---|
| N+1查询问题 | 使用DataLoader或预加载 |
| 构建缓慢 | 检查包体积,启用懒加载 |
| 认证复杂度高 | 使用Auth.js或Clerk |
| 类型错误 | 在tsconfig中启用严格模式 |
| CORS问题 | 正确配置中间件 |