senior-fullstack

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Senior 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:
  • nextjs
    - Next.js 14+ with App Router, TypeScript, Tailwind CSS
  • fastapi-react
    - FastAPI backend + React frontend + PostgreSQL
  • mern
    - MongoDB, Express, React, Node.js with TypeScript
  • django-react
    - Django REST Framework + React frontend
Usage:
bash
undefined
生成带有模板代码的全栈项目结构。
支持的模板:
  • nextjs
    - 带有App Router、TypeScript、Tailwind CSS的Next.js 14+
  • fastapi-react
    - FastAPI后端 + React前端 + PostgreSQL
  • mern
    - 基于TypeScript的MongoDB、Express、React、Node.js
  • django-react
    - Django REST Framework + React前端
使用方式:
bash
undefined

List 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
undefined

Analyze 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 ---
  1. [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
--- 改进建议 ---
  1. [P0] 安全问题 问题:检测到潜在硬编码密钥 处理建议:移除或保护第42行的敏感数据

---

Workflows

工作流

Workflow 1: Start New Project

工作流1:启动新项目

  1. Choose appropriate stack based on requirements
  2. Scaffold project structure
  3. Run initial quality check
  4. Set up development environment
bash
undefined
  1. 根据需求选择合适的技术栈
  2. 搭建项目结构
  3. 运行初始质量检查
  4. 配置开发环境
bash
undefined

1. 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
undefined
npm run dev
undefined

Workflow 2: Audit Existing Codebase

工作流2:审计现有代码库

  1. Run code quality analysis
  2. Review security findings
  3. Address critical issues first
  4. Plan improvements
bash
undefined
  1. 运行代码质量分析
  2. 查看安全问题结果
  3. 优先处理严重问题
  4. 规划改进方案
bash
undefined

1. 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级问题创建任务工单

undefined
undefined

Workflow 3: Stack Selection

工作流3:技术栈选择

Use the tech stack guide to evaluate options:
  1. SEO Required? → Next.js with SSR
  2. API-heavy backend? → Separate FastAPI or NestJS
  3. Real-time features? → Add WebSocket layer
  4. Team expertise → Match stack to team skills
See
references/tech_stack_guide.md
for detailed comparison.

使用技术栈指南评估选项:
  1. 需要SEO支持? → 带SSR的Next.js
  2. 以API为核心的后端? → 独立FastAPI或NestJS
  3. 需要实时功能? → 添加WebSocket层
  4. 团队技术能力 → 选择匹配团队技能的技术栈
详情请查看
references/tech_stack_guide.md
中的详细对比。

Reference Guides

参考指南

Architecture Patterns (
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

  • 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

  • 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

技术栈决策矩阵

RequirementRecommendation
SEO-critical siteNext.js with SSR
Internal dashboardReact + Vite
API-first backendFastAPI or Fastify
Enterprise scaleNestJS + PostgreSQL
Rapid prototypeNext.js API routes
Document-heavy dataMongoDB
Complex queriesPostgreSQL
需求推荐方案
SEO关键站点带SSR的Next.js
内部仪表盘React + Vite
API优先后端FastAPI或Fastify
企业级规模NestJS + PostgreSQL
快速原型开发Next.js API路由
文档型数据MongoDB
复杂查询PostgreSQL

Common Issues

常见问题

IssueSolution
N+1 queriesUse DataLoader or eager loading
Slow buildsCheck bundle size, lazy load
Auth complexityUse Auth.js or Clerk
Type errorsEnable strict mode in tsconfig
CORS issuesConfigure middleware properly
问题解决方案
N+1查询问题使用DataLoader或预加载
构建缓慢检查包体积,启用懒加载
认证复杂度高使用Auth.js或Clerk
类型错误在tsconfig中启用严格模式
CORS问题正确配置中间件