1. 为什么我翻了几十个 Spring Skills 仓库最后只留下 6 个Spring Boot 项目里引入 Agent Skills本质上是在给 AI 装一份“项目级操作手册”。它不是一个临时 Prompt而是放在约定目录里的SKILL.mdClaude Code、Codex、Cursor 这类工具启动时会自动读取后续生成代码、写测试、改配置都会按这份手册执行。对 Spring 团队来说这解决的是一个很现实的问题每个人都在用 AI 写代码但写出来的风格、依赖、测试策略完全不一致。我这次筛选的标准有三条。第一仓库必须能直接落到 Spring Boot 工程里不是泛泛的 Prompt 集合第二要有可复制的配置片段而不是只讲理念第三覆盖的场景要互补不能六个仓库都在讲 CRUD。按这三条筛下来几十个候选里真正能打的就剩 6 个dr-jskill、agent-skill-java-spring-framework、sivalabs-agent-skills、auth0/agent-skills、spring-testing-skills、spring-ai-agent-utils。这 6 个仓库分别对应依赖注入与版本约束、过时 API 治理、架构与测试切片、安全集成、测试策略拆分、以及在自己的 Spring Boot 应用里造 Agent。它们不是互相替代的关系而是可以叠加使用。下面我会按“先讲清楚每个仓库解决什么问题再给可复制配置最后给验证动作”的顺序展开同时说明怎么通过 TaoToken 统一 Key 和 API 通道接入避免每个工具各配一套密钥。适合谁看正在用 Spring Boot 3.x/4.x 做项目、已经在用 Claude Code 或 Codex 写代码、并且希望把 AI 生成结果稳定在团队规范内的后端同学。如果你还在手写 Prompt 让 AI 生成 Service 层这篇的配置片段可以直接抄。2. TaoToken 前置统一 Key 与 API 通道再谈 Skills 落地在讲具体仓库之前先把接入层说清楚。Agent Skills 本身只是行为约束文件它不负责模型调用。真正让 AI 跑起来的是背后的模型通道。我试过在每个工具里单独配 Key结果是 Claude Code 一套、Codex 一套、Cursor 又一套换模型时到处改。后来统一走 TaoToken一个 Key 覆盖多个模型入口配置只维护一份。TaoToken 在这里的角色是统一 API 通道。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。注意 API 地址不带 UTM 参数配置里直接写这个基址即可。你需要先在控制台创建 Key然后把它填到各个工具的配置里。具体操作路径打开控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面新建一个 Key复制出来。这个 Key 后面会同时用在 Claude Code、Codex 和 Cline 的配置里。如果你只是先验证模型能不能通可以直接用模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 发一条消息测试。这里有个关键点Skills 仓库里的SKILL.md不包含任何密钥它只描述行为规范。密钥统一放在工具配置里。所以正确的顺序是先配好 TaoToken 通道确认模型能返回结果再把 Skills 目录挂到项目里。顺序反了的话你会以为是 Skill 没生效其实是 Key 没配对。对于长期做编码和 Agent 任务的场景可以用 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合持续性的代码生成任务。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各工具的完整配置示例。下面第三节我会给出可直接复制的配置片段。3. 可复制配置6 个仓库的落地片段与目录约定这一节是全文的核心每个仓库我都给出目录位置和可复制的配置内容。目录约定先统一说明Claude Code 读.claude/skills/Codex 读.codex/skills/Cursor 读.cursor/skills/。项目级目录只对当前工程生效用户级目录对整台机器生效。我建议 Spring Boot 项目用项目级目录方便随代码提交、团队共享。先配 TaoToken 通道。Claude Code 的配置放在~/.claude/settings.json内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥 } }Codex 的配置放在~/.codex/auth.json三件套是 Base URL、Key、Model ID缺一不可{ base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-5 }Cline 的 MCP 配置放在项目根目录的.cline/mcp.json同样写全三件套{ mcpServers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-5 } } }通道配好后开始挂 Skills。第一个仓库dr-jskill作者是 JHipster 创始人风格非常强 opinionated默认技术栈是 Java 25、Spring Boot 4.x、PostgreSQL。它的目录结构里versions.json管依赖版本references/放最佳实践SKILL.md管主行为约束。安装方式npx skills add dr-jskill --dir .claude/skills/第二个仓库agent-skill-java-spring-framework专门治 AI 的老代码病禁止RestTemplate、禁止javax.*、强制jakarta.*、强制 Spring Modulith。它的SKILL.md里有一段约束可以直接抄进你的项目## 禁止事项 - 禁止使用 RestTemplate统一用 RestClient - 禁止 javax.* 包统一 jakarta.* - 禁止字段注入统一构造器注入 - 测试必须使用 Testcontainers第三个仓库sivalabs-agent-skills社区里体系最成熟的一个把架构、测试、本地开发、CI、代码质量拆开管理内置 ArchUnit 做架构校验。它的配置片段# .claude/skills/sivalabs/skill.toml [skill] name spring-modulith-arch enforce [ArchUnit, Spotless, Checkstyle] package_structure modulith第四个仓库auth0/agent-skillsAuth0 官方出的专治 Spring Boot API 安全集成。它把 JWT 校验、Scope 授权、SecurityFilterChain、OAuth2、DPoP 都写进了 Skill还特别标注了 domain 不能带https、audience 必须完全一致这两个高频坑。配置片段# .claude/skills/auth0/security.yaml jwt: domain: your-tenant.auth0.com audience: https://api.yourdomain.com algorithms: [RS256]第五个仓库spring-testing-skills把 JPA、MVC、Security、WebFlux 测试场景全部拆开明确禁止乱用DirtiesContext推 Testcontainers、MockMvcTester、AssertJ。配置片段## 测试切片规则 - Controller 测试用 WebMvcTest禁止启动完整上下文 - Repository 测试用 DataJpaTest Testcontainers - 禁止 DirtiesContext除非有明确理由并注释说明第六个仓库spring-ai-agent-utils和前面五个不同它是给你一套 Java Agent 能力库接进 Spring Boot 后你的应用自己就能变成 Agent支持文件编辑、Shell 执行、代码搜索、Memory、Skills 子任务分发。它的依赖配置dependency groupIdcom.example/groupId artifactIdspring-ai-agent-utils/artifactId version0.1.0/version /dependency这 6 个仓库可以叠加。我的建议是新项目挂dr-jskillsivalabs-agent-skills老项目重构挂agent-skill-java-spring-framework有安全需求挂auth0/agent-skills测试慢挂spring-testing-skills要做 Agent 应用再上spring-ai-agent-utils。4. 验证请求确认 Skills 在本地 Spring Boot 工程中生效配置写完不代表生效必须验证。我踩过的坑是目录放对了但工具没读到生成结果还是老样子。下面给一套可复现的验证流程。第一步验证 TaoToken 通道。用 curl 直接打 API确认 Key 和基址没问题curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-5, max_tokens: 128, messages: [{role: user, content: 回复 OK}] }返回里能看到content字段和正常文本说明通道通了。如果返回 401先查 Key如果返回local proxy failed查基址是不是写成了带路径的地址。第二步验证 Skills 被读取。在 Spring Boot 项目里让 AI 生成一个 Controller观察它是否遵守了SKILL.md里的约束。比如挂了agent-skill-java-spring-framework后你让它“写一个调用外部接口的 Service”如果它用RestClient而不是RestTemplate说明 Skill 生效了。如果它还是给RestTemplate检查目录是不是.claude/skills/而不是.claude/skill/。第三步验证测试切片。挂了spring-testing-skills后让它“给 UserController 写测试”正确结果是生成WebMvcTest而不是SpringBootTest。如果它启动了完整上下文说明 Skill 没读到或者你的SKILL.md里规则写得不够明确。第四步验证架构校验。挂了sivalabs-agent-skills后运行 ArchUnit 测试./gradlew test --tests *ArchitectureTest*如果 AI 生成的代码违反了 Modulith 的模块边界ArchUnit 会直接报错。这一步很关键因为 AI 写代码最大的问题就是随着代码量增加架构会逐渐失控ArchUnit 是最后一道防线。第五步验证安全配置。挂了auth0/agent-skills后让它生成SecurityFilterChain检查生成的domain有没有带httpsaudience是否和你的 API 标识完全一致。这两个点配错的话JWT 校验会一直失败但报错信息不直观。实测下来这套验证流程走一遍大概十分钟能排除 90% 的“Skill 没生效”问题。剩下的 10% 通常是工具版本太旧不支持 Skills 目录升级到最新版即可。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节对照真实报错给排查路径。这些错我都遇到过按顺序查基本能定位。401 Unauthorized。最常见的原因是 Key 没填对或者填到了错误的配置字段。Claude Code 用ANTHROPIC_API_KEYCodex 用api_keyCline 用apiKey字段名不一样。另一个原因是 Key 复制时带了空格。排查方法用第 4 节的 curl 命令直接测curl 通了说明 Key 没问题那就是工具配置字段写错了。local proxy failed。这个报错通常出现在基址配置错误时。TaoToken 的 API 基址是https://taotoken.net/api不要在后面加/v1或/messages工具会自己拼路径。如果你写成了https://taotoken.net/api/v1就会出现这个错。改成纯基址即可。reading choices 相关报错。这个一般出现在模型返回格式和工具预期不一致时。检查 Model ID 是否写对比如claude-sonnet-4-5不要写成claude-sonnet-4.5。另外确认max_tokens没有设成 0 或负数。如果用的是 Codex检查auth.json里三个字段是否齐全缺 Model ID 也会导致解析失败。OAuth 相关报错。这个多出现在auth0/agent-skills场景。典型错误是domain带了https://前缀正确写法是your-tenant.auth0.com不带协议。另一个是audience和 Auth0 控制台里配置的 API Identifier 不一致必须完全一致包括结尾斜杠。还有algorithms要和你实际用的签名算法匹配RS256 是最常见的。Skill 不生效但没报错。这种最隐蔽。检查三点目录名是不是skills复数SKILL.md文件名是不是全大写文件是不是放在项目根目录下的约定路径里。如果都对了还不生效在SKILL.md开头加一行明确的触发条件比如“当用户要求生成 Spring 代码时必须遵守以下规则”有些工具需要显式触发。测试跑得慢。如果挂了spring-testing-skills还是慢检查是不是有DirtiesContext残留。这个注解会导致 Spring 上下文反复重建CI 时间直接翻倍。全局搜一下能删就删。排查顺序建议先 curl 测通道再查工具配置字段再查 Skills 目录最后查 Skill 内容本身。按这个顺序大部分问题五分钟内能定位。6. 语义一致 CTA把 Key、文档和模型验证串起来配置和排查都走通之后剩下的就是日常使用。我的习惯是Key 统一在 TaoToken 控制台管理接入文档放在手边模型验证用对话页面快速测。这样换模型、加工具、调 Skills 都不用重新折腾密钥。如果你还没建 Key直接去 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 新建一个然后按第 3 节的片段填到对应工具里。接入过程中遇到配置字段不确定的查接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各工具的完整示例。想先确认模型返回正常用模型对话 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 发一条消息即可。长期做编码和 Agent 任务的Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 更适合持续性的代码生成场景。Claude Code 用户如果走 Anthropic 兼容通道参考 ClaudeCodeAnthropic 配置 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 里面的 Base URL 和 Key 字段和第 3 节一致。最后说一个我自己的经验Skills 仓库更新很快几乎每周都有新的 Spring Skills 冒出来。我的做法是每个季度重新过一遍这 6 个仓库的SKILL.md把团队新踩的坑补进去。规范写一次后续所有 AI 生成任务自动生效这比每次手写 Prompt 省事得多。与其反复教 AI不如直接给它装好规则。
