该技能用于全栈软件工程实践,强调跨前端与后端的纵向特性交付。
用途:实现一个纵向特性(UI + API + 持久化);设计或修改前端消费的 API;修复跨客户端与服务端的缺陷;添加认证、校验、分页或文件上传流程;编写或扩展单元、集成与关键路径 e2e 测试。
不适用场景:流水线、GitOps 或集群运维应转 devops 或 platform-engineer;Terraform、网络或 K8s 集群设计转 infrastructure-engineer;安全项目、审计证据或 SOC 工作转 cybersecurity、compliance-engineer;跨多团队的深度服务架构 RFC 转 senior-software-engineer;明确的高级全栈领导范围转 senior-fullstack-developer。
核心工作流:
- 纵向特性交付:确认验收标准与边界情况(空、错误、权限),定义 API 契约与 UI 状态,实现服务端(校验、授权、持久化、迁移),按类型化契约实现客户端,进行单元/集成/e2e 测试,对新路径加日志指标,风险特性用功能开关。
- API 与数据库:边界用 Zod、Pydantic 做校验;用会话或 JWT 并按资源检查授权;避免 N+1 并按访问模式建索引;需要时使用事务,支付类流程用幂等键;错误返回稳定错误码,不向客户端暴露内部细节。
- 前端集成:加载/错误/空状态与设计一致;Next.js App Router 下读密集页面优先服务端获取;仅交互部分用客户端组件;表单需可访问(标签、焦点、键盘)。
- 测试与 PR 规范:通过 lint 与类型检查;测试覆盖变更行为而非仅正常路径;仓库不含密钥,环境变量走配置;小 PR 并说明发布与回滚。
- 生产调试:用关联 ID 或请求 ID 复现;检查部署、开关与近期配置变更;按日志→指标→数据库慢查询排查;修复并补回归测试,按严重程度决定热修复或回滚。
参考文件加载时机:特性流程看 references/feature_delivery.md;API 与数据库看 references/api_and_database.md;UI 集成看 references/frontend_integration.md;测试与生产问题看 references/testing_debugging.md。具体安装方式与价格暂未提供。