senior-fullstack

全栈开发专家

全栈开发技能，可搭建适用于生产环境的项目结构（Next.js、FastAPI+React、MERN、Django+React），并针对安全性、复杂度、依赖健康状况、测试覆盖率和文档开展静态代码质量分析；同时提供有关架构模式、开发工作流和技术栈选择的参考指南。

核心能力

• 项目搭建 — 生成完整的 Next.js、FastAPI+React、MERN 或 Django+React 项目结构，包含 TypeScript、Docker/docker-compose、环境变量模板和包配置。
• 代码质量分析 — 静态扫描安全问题、圈复杂度、依赖项 CVE、测试覆盖率估算和文档评分，并给出总分/等级以及按优先级排列的 P0/P1/P2 建议。
• 技术栈选择 — 根据使用场景（MVP、SaaS、Enterprise），提供框架、数据库、ORM、身份验证和部署平台的决策矩阵及权衡指南。
• 架构模式 — 前端组件设计、后端整洁架构、API 设计（REST/GraphQL）、缓存和身份验证。
• 生命周期工作流 — 本地设置、git、CI/CD、测试、代码审查、部署和可观测性。

适用场景

遇到以下需求时使用此技能：

• “搭建一个新项目” / “设置一个全栈项目” / “生成项目样板”
• “创建一个 Next.js 应用” / “设置 FastAPI 和 React”
• “分析代码质量” / “检查代码库是否存在安全问题”
• “我应该使用什么技术栈”

先行确认

开始搭建前，请确认以下信息。如果有任何一项未知或含糊不清，请先询问，不要自行假设：

• 技术栈 — Next.js / FastAPI+React / MERN / Django+React（决定搭建模板和完整文件树）
• 应用名称和输出路径 — 项目写入的位置（project_scaffolder 的位置参数）
• 任务 — 搭建新项目，还是分析现有代码库的质量（决定使用 project_scaffolder 还是 code_quality_analyzer）

停止规则：只询问对输出影响最大的 2-3 项。如果用户说“直接起草”，则继续执行，并在产物顶部列出你的假设。

工具

工具	用途	命令
project_scaffolder.py	搭建包含样板代码、Docker 和环境配置的全栈项目结构	python scripts/project_scaffolder.py nextjs my-app --output ./projects
code_quality_analyzer.py	静态分析代码库的安全性、复杂度、依赖项、覆盖率和文档	python scripts/code_quality_analyzer.py . --verbose --json --output audit.json

参考资料

根据任务加载相应的参考资料 — 保持此文件精简，按需查阅详细信息：

• references/tooling-workflows-and-quality.md — 完整的工具文档（模板、标志、输出示例、输出格式）、三个端到端工作流、技术栈决策矩阵/常见问题、故障排除表和成功标准。深入运行工具或发布前检查生成内容时阅读。
• references/architecture_patterns.md — 前端组件架构、后端整洁架构/仓储模式、REST 和 GraphQL API 设计、数据库模式、缓存策略和身份验证架构。设计或审查系统结构时阅读。
• references/development_workflows.md — 本地开发设置、git 工作流、CI/CD 流水线、测试策略、代码审查流程、部署策略和可观测性。搭建开发生命周期时阅读。
• references/tech_stack_guide.md — 前后端框架对比、数据库选择、ORM、身份验证方案、部署平台及按使用场景提供的技术栈建议。选择技术栈时阅读。

范围与限制

此技能涵盖：

• 为 Next.js、FastAPI+React、MERN 和 Django+React 技术栈搭建项目骨架，包含 Docker、TypeScript 和环境配置
• 静态代码质量分析，包括复杂度指标、安全模式检测、依赖漏洞检查、测试覆盖率估算和文档评分
• 通过技术栈决策矩阵和参考指南提供技术栈选择建议
• 全栈架构模式（前端组件设计、后端整洁架构、API 设计、缓存、身份验证）

此技能不涵盖：

• 运行时性能分析、负载测试或 APM 埋点——可参阅 senior-devops 了解可观测性工具
• 基础设施预配、Terraform/Pulumi 或云部署自动化——可参阅 aws-solution-architect 和 senior-devops
• 针对实时漏洞数据库进行全面的 CVE 扫描——请使用 npm audit、pip-audit 或 senior-secops 进行深入安全分析
• 移动应用或原生桌面应用的项目搭建——此技能仅面向基于 Web 的全栈架构

集成点

技能	集成方式	数据流
senior-devops	为搭建好骨架的项目设置 CI/CD 流水线	脚手架生成的输出目录将用于 DevOps 流水线配置和 Docker 部署工作流
senior-secops	初步质量扫描后进行深入安全审计	代码质量分析器发现的 P0/P1 级安全问题将移交 SecOps，以便跟踪修复进度并进行渗透测试
senior-qa	为搭建好骨架的项目制定测试策略	分析器估算的测试覆盖率可帮助 QA 识别测试计划中的缺口；搭建好的测试基础设施则提供测试框架
code-reviewer	自动审查生成的代码和现有代码	质量分析器生成的 JSON 报告可为代码审查清单和 PR 审批标准提供结构化输入
senior-architect	验证技术栈选择的架构合理性	技术栈指南的建议将纳入架构决策记录；复杂度指标可用于验证设计是否合规
aws-solution-architect	将搭建好骨架的应用部署到云端	脚手架生成的 Docker Compose 配置将转换为 ECS/EKS 任务定义和基础设施蓝图