痛点微服务演示的最后一公里每个微服务项目都有一堆模块注册中心、网关、多个服务提供者、消费者、消息队列……项目写完了怎么给别人演示手动启动 10 个服务等 5 分钟打开浏览器一个个敲 URL解释这个请求走了 Gateway → Consumer → Provider 的链路切到终端再演示一遍 Dubbo 调用最后还要清理环境……演示 5 分钟准备 30 分钟。新思路让 AI 来演示如果有一种方式你只需要对 AI 说一句话“帮我演示一下 Sentinel 网关限流”AI 就会自动检查服务是否运行通过 nacos-config 模块发布限流规则发送 10 次请求前 5 次正常后 5 次返回 444 限流清理配置恢复环境这不是录屏不是固定脚本是 AI 理解你的意图后动态执行的真实演示。它是怎么工作的核心是一个叫SKILL.md的技能文件放在项目的.qoder/skills/目录下。它不是普通的文档而是 AI Agent 的操作手册——用结构化的方式描述了每个演示场景的前置条件、执行步骤和验证标准。.qoder/ └── skills/ └── demo-spring-cloud/ ├── SKILL.md # 技能定义告诉 AI 怎么演示 ├── verify-stream.sh # Stream 一键验证脚本 └── verify-seata.sh # Seata 一键验证脚本当你在 IDE 里输入/demo-spring-cloud或者说演示一下网关路由AI 会读取 SKILL.md理解当前项目有哪些模块、端口、依赖关系检查环境Nacos 是否运行、RocketMQ 是否需要启动执行操作启动服务、发送请求、验证响应汇报结果告诉你哪些通过、哪些失败一个 SKILL 覆盖全部演示场景这个项目涵盖了 Spring Cloud Alibaba 生态的完整链路场景AI 能做什么服务注册与发现启动 Nacos → 启动服务 → 查询注册实例 → 验证调用网关路由通过 Gateway 访问各服务 → 验证路由转发Dubbo/gRPC演示多协议调用链路含 REST 接口Sentinel 限流发布规则 → 触发限流 → 验证 444 响应Stream 消息启动 RocketMQ → 创建 Topic → 发送/消费消息Seata 分布式事务初始化数据库 → 启动 4 个服务 → 模拟回滚/提交Spring AI聊天、Tool Calling、多模态视觉识别不需要记端口、不需要记 URL、不需要记启动顺序。你只需要说演示。与传统方式的对比传统方式SKILL 驱动启动服务手动开多个终端逐个mvn spring-boot:runstart-all.sh start或让 AI 处理演示调用复制粘贴 URL手动改参数AI 自动构造请求并解读结果环境检查自己判断哪个服务没起来AI 自动检测并给出诊断清理环境ps auxgrep java逐个 kill知识传递口头讲解 文档SKILL.md 本身就是可执行的文档更深层的价值可执行的文档SKILL.md 的巧妙之处在于——它既是文档又是脚本还是 AI 的上下文。对人来说它是一份清晰的操作手册对 AI 来说它是执行指令集对项目来说它是活的文档随着代码演进同步更新这解决了微服务项目的一个长期问题文档和代码脱节。当 SKILL.md 里的步骤跑不通时你立刻知道是代码出了问题而不是文档过时了。如何体验# 克隆项目gitclone https://github.com/javahongxi/spring-cloud-samples.gitcdspring-cloud-samples# 在 Qoder IDE 中打开然后# 方式一直接对话帮我演示一下这个微服务项目# 方式二调用技能/demo-spring-cloud# 方式三使用脚本不依赖 AI./start-all.sh start# 启动所有服务./start-all.sh verify# 执行验证./start-all.sh stop# 停止所有服务写在最后微服务项目的价值不在于有多少个模块而在于能不能让人快速理解它在做什么。AI Agent Skill 让演示这件事从负担变成了能力——你的项目不再是一堆需要解释的代码而是一个可以自我展示的活系统。项目地址github.com/javahongxi/spring-cloud-samples欢迎 Star也欢迎贡献你自己的 SKILL 场景。