← ClaudeAtlas

fullstack-devlisted

Full-stack backend architecture and frontend-backend integration guide. TRIGGER when: building a full-stack app, creating REST API with frontend, scaffolding backend service, building todo/CRUD/real-time/chat apps, Express + React, Next.js API, Node.js/Python/Go backend, designing service layers, implementing error handling, managing config/auth, setting up API clients, implementing auth flows, handling file uploads, adding real-time features (SSE/WebSocket), hardening for production. DO NOT TRIGGER when: pure frontend UI work, pure CSS/styling, database schema only, simple scripts, bug fixes, single-file changes, adding a small feature to existing code. 触发词:全栈、后端服务、REST API、前后端联调、鉴权、WebSocket、生产加固。
JIANGEPLUS/senior-developer-codex · ★ 0 · AI & Automation · score 70
Install: claude install-skill JIANGEPLUS/senior-developer-codex
# Full-Stack Development Practices ## MANDATORY WORKFLOW **触发此 skill 后,必须按以下步骤执行:** ### Step 0: Gather Requirements 确认以下信息(如用户已指定则跳过): 1. **Stack**: 后端+前端语言/框架 2. **Service type**: API-only / 全栈单体 / 微服务 3. **Database**: SQL / NoSQL 4. **Integration**: REST / GraphQL / tRPC / gRPC 5. **Real-time**: SSE / WebSocket / Polling / 不需要 6. **Auth**: JWT / Session / OAuth / 不需要 ### Step 1: Architectural Decisions 基于需求做出并声明决策(每个决策一句话): | 决策项 | 参考 | |--------|------| | 项目结构 | Feature-first(推荐)vs Layer-first | | API 客户端 | Typed fetch / React Query / tRPC / OpenAPI | | 认证策略 | JWT + refresh / session / 第三方 | | 实时方案 | Polling / SSE / WebSocket | | 错误处理 | Typed error hierarchy + global handler | ### Step 2: Scaffold with Checklist **后端服务 Checklist:** - [ ] Feature-first 项目结构 - [ ] 配置集中管理,环境变量启动时验证(fail fast) - [ ] 类型化错误层级(非通用 Error) - [ ] 全局错误处理中间件 - [ ] 结构化 JSON 日志 + request ID - [ ] 数据库 Migration + 连接池 - [ ] 输入验证(Zod / Pydantic / Go validator) - [ ] 认证中间件 - [ ] 健康检查端点(`/health`, `/ready`) - [ ] 优雅关闭(SIGTERM) - [ ] CORS 配置(显式 origin) - [ ] 安全头(helmet 等) - [ ] `.env.example`(不含真实密钥) **前后端集成 Checklist:** - [ ] 类型化 API Client - [ ] Base URL 从环境变量读取 - [ ] Auth token 自动附加 - [ ] API 错误映射为用户友好消息 - [ ] Loading 状态处理 - [ ] 跨边界类型安全 - [ ] CORS 显式配置 - [ ] Refresh token 流程 ### Step 3: Implement 按照 references 中的模式编写代码。每完成一个模块立即验证。 ### Step 4: Verify ```bash # 构建检查 cd server && npm run build cd client && npm run build # 冒烟测试 curl http://localhost:3000/health # 集成检查:前端能连通后端 ``` ### Step 5: