工作十几年后留下的 10 个后端 Skill:从脚手架到排障

作者站在 Java 后端和大模型 Agent 落地视角,从近三十个开发者 Skill 里筛出 10 个能嵌进日常流程的技能,覆盖初始化、编码、评审、测试、排障和部署,并强调技能是效率放大器而不是能力替代品。

基本信息

  • 来源类型:文章(掘金)
  • 原文位置:raw/articles/2026-10-07-111629-tg-65aaa5.md
  • 原文 URL:https://juejin.cn/post/7686407614478893108
  • 消化日期:2026-10-07
  • 作者立场:后端开发者,技术栈从 SSH 到 Spring Cloud 微服务,再到大模型 Agent;每个技能声称至少在十个项目里验证过

核心观点

  1. 真正提效的是贴合技术栈和工作流的少数 Skill,不是装全。 作者接触 WorkBuddy 大半年、试过近三十个开发者向 Skill,踩过“功能花哨但没用”“安装后再也没打开过”的坑。日常工作核心一直是用最少时间交付高质量代码,但大部分工时消耗在写重复 CRUD、翻代码找架构、改 Git 冲突、对着规范做评审、线上 bug 找不到根因。
  2. springboot-scaffold 把“Web 接口 + 数据库 CRUD + 基础组件”的半小时到一个半小时起步成本压到约 30 秒。 内置 Spring Boot + MyBatis-Plus + MySQL + Redis + Swagger/Knife4j,按 controller/service/dao/entity/common 分层,连参数校验、统一返回、分页、跨域都预先做好;生成可导入 IDE 运行的完整项目,而不是零散片段。作者用它生成部门-员工一对多的人员管理系统,连建表 SQL、Mapper.xml 和基础 CRUD 一并产出。
  3. code-review 把评审固化成质量、安全性、性能、可维护性四维清单,人只留在业务判断上。 检查项包括命名、复杂度、重复代码、SQL 注入、XSS、权限校验、算法效率、资源使用、缓存、注释、模块设计和测试覆盖率。一次用户查询接口被指出:缺参数长度校验(安全,P1)、查询无缓存会打库(性能,P2)、getUserInfo 不符合“动词+名词”应改为 queryUserInfo(质量,P3)。作者称团队评审效率至少提升一半。
  4. mcp-builder 把内部库和 API 收成只读、限流的 MCP 服务,让 Agent 调用业务系统。 医疗后台案例:只允许查患者表、医嘱表、检查报告表,禁止写入,单次最多 100 条,查询必须带时间范围、禁止全表扫描。以前自己写查询接口要两三天且有 SQL 注入风险,用 Skill 十几分钟生成可运行服务后,自然语言即可出合规 SQL 和结构化统计。
  5. 其余六个技能分别卡住测试、Git、排障、读库、自定义流程、冲突和原型部署。 tdd 强制红-绿-重构,订单金额(满减、折扣、运费、叠加、退款分摊)做到测试覆盖率 100%;github 用自然语言做 revert 与 cherry-pick,并预览影响;diagnosing-bugs 把偶发超时从“没索引的组合查询 + 百万级表”定位到联合索引加 5 分钟 Redis 缓存,响应从 2 秒降到 20ms 以内;zoom-out 用约十分钟理清五年、十几万行老项目;skill-creator 把“接口收尾”收成一句话;resolving-merge-conflicts 把十几处冲突在约五分钟内合并;cloudbase 约二十分钟做出可公网访问的反馈收集原型。串起来后,作者称机械性工作从 60% 降到 20%,一周的需求变成三四天。

实操内容保留

代码/配置

(本文无独立代码块或配置文件。可复用的是口头指定的技术栈、约束和排查结论。)

人员管理脚手架指定的技术栈与约束:

  • Spring Boot 3.2 + MyBatis-Plus 3.5.5 + MySQL 8.0
  • 实体:部门、员工,一对多
  • 能力:分页查询、多条件筛选、参数校验、Knife4j 文档
  • 表名前缀:tb_
  • 生成物:完整项目结构、建表 SQL、Mapper.xml、基础 CRUD;导入 IDEA 后只改数据库连接即可启动
  • 使用约定:生成时必须指定 JDK、Spring Boot 版本和 ORM,否则默认版本可能和现有栈不匹配;团队异常码、日志格式、工具类应写进生成规范

MCP 只读查询约束(twinbee_medical):

  • 只允许查询患者表、医嘱表、检查报告表
  • 禁止任何写入
  • 单次最多返回 100 条
  • 查询条件必须带时间范围,禁止全表扫描
  • 必须加流量限制,避免高频调用打挂业务系统

线上超时的修复与预防:

  • 根因:两个字段组合查询只建了单字段索引;用户表到百万级,过滤后仍大量扫描
  • 修复:给查询字段加联合索引,接口加 Redis 缓存,缓存时间 5 分钟
  • 结果:响应从 2 秒降到 20ms 以内
  • 预防:高频查询接口做索引检查;超过 10 万行的表必须有合适索引

Prompt 模板

脚手架:

用springboot-scaffold生成一个人员管理的Spring Boot项目,技术栈用Spring Boot 3.2 + MyBatis-Plus 3.5.5 + MySQL 8.0,包含部门和员工两个实体,部门和员工是一对多关系,支持分页查询、多条件筛选、参数校验,接口用Knife4j生成文档,数据库表名用tb_前缀

MCP 服务:

封装一个MySQL查询的MCP服务,连接twinbee_medical数据库,只允许查询患者表、医嘱表、检查报告表,禁止任何写入操作,限制单次查询最多返回100条,查询条件必须带时间范围,禁止全表扫描

查数:

帮我查一下昨天入院的患者人数,按科室分布,再统计一下平均住院天数

Git 回退与拣选:

帮我回退main分支上最新的一次提交,生成revert提交,不要直接重置。然后把提交号为a1b2c3d的修复提交拣选到dev、test、pre三个分支,每个分支拣选完都推送到远程

PR 总结:

总结一下#142号PR的改动,重点看数据库相关的变更和接口入参变化

架构扫描:

帮我梳理这个项目的整体架构,输出分层架构图,标注核心模块、关键入口和技术栈,重点说明数据层和消息队列的使用方式

接口收尾触发词是“接口收尾”,示例是“对UserController做接口收尾”。

CloudBase 原型:

做一个用户反馈表单页面,包含姓名、联系方式、反馈类型、反馈内容四个字段,提交后存到数据库,做一个简单的后台列表页能查看所有反馈,支持按时间筛选和导出Excel,部署成可访问的公网链接

提交信息格式约束:feat: 新增xxx功能、fix: 修复xxx问题。

操作步骤

十个技能及作者给出的用法边界:

  1. springboot-scaffold:基础骨架交给它,复杂业务自己写。微服务里每个服务的基础层也可复用,用来统一包结构。
  2. code-review:写完一个模块就审一次。先用它清掉规则性问题,再把人的时间留给业务评审。它查不出业务合理性。
  3. mcp-builder:描述要暴露的工具、输入输出和权限,生成带文档、鉴权、流量控制和日志的 MCP Server。数据库场景默认只读。
  4. tdd:拆需求、写边界用例、跑红、写到转绿、再重构。简单 CRUD 可收成“先写接口定义,再写实现,最后补测试”,配合 spring-boot-starter-test。
  5. github:日常提交、分支、变基、回滚、拣选、PR、Issue 用自然语言;强制推送和重置主分支必须先看操作预览。
  6. diagnosing-bugs:捕获错误和堆栈 → 梳理复现 → 定位故障点 → 分析根因 → 最小修复 → 验证和预防。信息要带堆栈、相关代码、最近变更和监控。基础设施故障(网络、资源、中间件)它查不出来。
  7. zoom-out:先看全局再钻方法。超大仓库只扫目标模块。架构图可导出用于交接和评审。
  8. skill-creator:用自然语言描述触发时机、动作、输出和规则,生成可复用 Skill。先从小流程(格式化、提交信息)做起,再做复杂工作流,并分享给团队。
  9. resolving-merge-conflicts:文本和配置冲突可直接用;业务逻辑冲突必须人工确认。习惯上小步提交,合并前先拉最新代码,本地解决后再推。
  10. cloudbase:适合原型、内部工具和小型项目;大型项目仍走传统架构。上线后改掉默认可写权限,加登录和权限控制,重要数据定期备份。

订单金额 TDD 用例(作者原文列举):

  1. 正常订单,无任何优惠,金额和运费计算正确
  2. 满足满减条件,订单金额扣减正确,运费正常计算
  3. 使用折扣券,和满减叠加逻辑正确(先折扣后满减)
  4. 订单金额为 0,运费收取起步价
  5. 异常参数(负数金额、不存在的优惠券),抛出对应异常
  6. 部分退款,优惠金额按比例分摊

接口收尾自定义 Skill 的固定顺序:

  1. 检查参数校验注解:必填字段有 @NotBlank,数值有范围限制
  2. 给每个方法加操作日志和异常日志,格式符合团队规范
  3. 补全接口注释和参数说明,保证 Swagger 不漏字段
  4. 生成单元测试骨架,含正常和异常场景
  5. 做代码格式优化和导入排序

作者建议 Java 后端先装的三个:springboot-scaffold、code-review、github。先用透两三个,再按场景补充。

关键概念

  • WorkBuddy — 作者使用大半年的技能运行环境;文中所有 Skill 都通过它对着自然语言触发
  • MCP(Model Context Protocol) — 文中视为 AI 工具调用的标准化协议;mcp-builder 生成的服务可接入任何支持 MCP 的 Agent
  • springboot-scaffold — Java 后端项目骨架生成器
  • code-review — 四维代码评审技能(此文中的安装名,不是本仓库的 review 技能)
  • mcp-builder — 把内部系统、数据库、API 封装成 MCP Server
  • tdd — 红-绿-重构流程技能
  • github — Git 与 GitHub 自然语言操作技能
  • diagnosing-bugs — 结构化线上排障技能
  • zoom-out — 代码库高层架构扫描技能
  • skill-creator — 用自然语言生成自定义 Skill
  • resolving-merge-conflicts — 按双方修改意图合并冲突
  • cloudbase — 腾讯云一站式后端云,用于原型快速部署
  • TDD — 先写测试再写实现;作者用订单金额计算说明边界覆盖
  • Spring Boot — 文中脚手架和测试的宿主框架

与其他素材的关联

  • 本库已有多篇 WorkBuddy 实操文(如 2026-10-01-juejin-workbuddy-7-scenarios、2026-07-17-juejin-workbuddy-agnes-ai-api)。这篇把视角收窄到 Java 后端全流程,并给出可直接复用的提示词和权限约束,偏技能选型而不是某一个产品演示。
  • 与本库里的 MCP、Agent 工具调用讨论互补:这里的增量是“只读 + 时间范围 + 100 条上限 + 禁全表扫描”这组可执行的数据库暴露边界。

原文精彩摘录

接触WorkBuddy大半年,试过近三十个开发者向Skill,踩过“功能花哨但没用”“安装后再也没打开过”的坑,也找到了几个真正能嵌入日常开发流程、每天都要用的技能。很多人装Skill喜欢求多求全,实际上真正能提升效率的,永远是贴合你技术栈、匹配你工作流的那几个。

用了这么多Skill,最深的感受是:它们是效率放大器,不是能力替代品。你懂架构,zoom-out才能帮你更快理清架构;你懂代码质量,code-review才能帮你查出真正的问题;你懂业务逻辑,TDD才能帮你写出合理的测试用例。技能帮你省掉的是重复劳动的时间,让你有更多精力去做更有价值的思考,而不是代替你思考。

这套流程跑下来,从需求到上线,每个环节都有对应的技能辅助,机械性工作占比从60%降到了20%,剩下的时间都可以花在业务逻辑和架构设计上。以前一周才能做完的需求,现在三四天就能交付,质量还更高。

相关页面

  • 本页是该素材的摘要页。文中十个安装名都是 WorkBuddy 技能,未在本次消化中另建实体页,避免和仓库里同名的工程技能混淆。