全栈开发实践指南v1.0.0

免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。

概述

本 Skill 面向需要从零搭建或重构全栈应用的开发者，覆盖后端服务脚手架、前后端联调、生产环境加固的完整链路。触发后先通过五步强制工作流澄清技术栈与架构决策，再按特征优先（feature-first）目录结构生成代码，落实三层架构分层、环境变量集中校验、类型化错误体系、结构化日志等 7 条核心原则。最终交付包含构建检查、冒烟测试、集成验证的可用项目，并附上手交接清单说明关键文件与后续步骤。

技能包含

• SKILL.md（本文件）：技能主说明，含强制工作流、7 条铁律、13 个专题模式与快速导航
• references/api-design.md：API 端点设计规范与最佳实践
• references/auth-flow.md：JWT / Session / OAuth / Next.js SSR / RBAC 认证流程详解
• references/django-best-practices.md：Django 框架专项最佳实践
• references/db-schema.md：数据库 Schema 设计参考
• references/environment-management.md：环境变量、CORS、多环境管理策略
• references/release-checklist.md：发布前检查清单
• references/technology-selection.md：技术选型决策框架
• references/testing-strategy.md：测试策略与分层测试方案
• _icon.svg：技能图标

核心能力

• 强制五步工作流：需求澄清 → 架构决策 → 清单脚手架 → 模式实现 → 测试验证，防止直接写代码
• 特征优先架构：按业务模块组织代码，替代按技术分层（controller/service/repository）的传统目录
• 三层严格隔离：控制器只处理 HTTP、服务层只含业务逻辑、仓库层只接触数据，禁止跨层越界
• 环境配置 fail-fast：启动时校验必填环境变量，缺失即崩溃，杜绝运行时配置遗漏
• 类型化错误体系：定义分层错误类 + 全局错误处理中间件，替代裸抛 Error 与 console.log
• 前后端集成规范：API 客户端类型安全、自动附认证令牌、刷新重试、CORS 显式白名单
• 生产加固清单：健康检查、优雅关闭、安全响应头、连接池、迁移管理、结构化日志全覆盖

应用场景