过去一年，AI 编程从“网页写脚本”进化到了“IDE 接管全模块”。很多人惊呼：“一个人就是一支军队！”
但在企业级复杂业务中，灾难往往接踵而至：
🧠 上下文坍塌：项目一复杂，AI 就“失忆”。忘了老需求、忘了架构设计、忘了代码规范，像盲人摸象般乱改。
🏗️ 架构极速腐化：缺乏全局把控，今天加接口明天改链路。代码像打补丁，系统加速沦为难以重构的“屎山”。
📄 裸奔的工程资产：功能勉强跑通，但 PRD、架构图、测试用例散落一地，甚至一片空白。
乱象的本质：我们仅仅把 AI 当成了不知疲倦的“超级外包”，却没有给它一个“团队”和“流程”的框架。
这正是 fish-claude-code 诞生的意义。
它的目标极其明确：把 AI 从“写代码的工具”，升级为遵循敏捷流程的虚拟研发团队。告别开盲盒式的试错，让 AI 真正成为可控、可追溯、零返工的工业级生产力引擎。
散兵游勇式的 AI 协作，正引发代码库的加速熵增。站在技术 Leader 视角，本项目解决的核心命题是：不仅要用 AI 让编码“更快”，更要用工程纪律让系统“更稳”。真正的研发提效，绝不是秒级生成一堆需要人工排雷的代码，而是一次性交付零返工的工业级产物。
- 🔴 刺痛点：10 个程序员有 10 种用 AI 的姿势，产出质量全凭个人水平。高手的隐性经验无法在团队内复用，核心人员一旦流失，所谓的“AI 生产力”瞬间归零。
- 🟢 破局法：直接交付标准化的 AI 研发流水线。我们将顶尖架构师的思考模型与排雷经验封装成开箱即用的 Agent 矩阵。让高手的“隐性经验”，变成全团队随时调用的“数字基建”。
- 🔴 刺痛点：原生 AI 是个聪明的“瞎子”，为了凑功能疯狂堆砌逻辑，无视 N+1 查询、死锁和分层规范。写得越快，后期的排错与重构成本（技术债）就越高。
- 🟢 破局法：建立前置架构契约。通过预设的专家技能包与铁血 Reviewer，在敲下第一行代码前就给 AI 戴上“紧箍咒”。不符合规范的实现直接“一票否决”，用严苛的准入机制掐断屎山蔓延，用“不返工”换取真实的提效。
- 🔴 刺痛点：缺乏经验的工程师极易被 AI 的“幻觉”带偏，盲目 Copy/Paste，拉低整体工程水位，随时可能埋下引发线上灾难的定时炸弹。
- 🟢 破局法：这不是辅助插件，而是贴身的虚拟资深导师团（架构师/DBA/安全专家）。有这套严苛的 SOP 兜底，即便是初中级研发，也能在专家的护航下，安全、高标准地交付核心业务。
- 🔴 刺痛点：传统开发流程中，需求对齐、架构评审、测试验收……每一个环节都在疯狂燃烧管理精力，团队协作摩擦力极大。
- 🟢 破局法：实现从“规划拆解 -> 架构设计 -> 编码落地 -> 破坏性测试 -> 安全审计”的全链路自动化闭环。真正把 AI 从被动的“代码补全机”，升级为流水线上能扛事儿的“研发合伙人”。
本项目为你提供了完整的 Agent 角色卡和专家技能包。将这些 Markdown 文件置入你的工作区，Claude Code 将瞬间觉醒以下人格：
- 📝
planner.md(项目规划师)：将复杂需求拆解为可执行的研发阶段（Phase），管理依赖与风险。 - 🏗️
architect.md(架构师)：基于第一性原理进行系统设计与技术选型决策，只做设计，输出强制约束。 - 💻
java-developer.md(高级开发)：精通 Spring Cloud Alibaba 生态，极致防御性编程，精准落地架构设计。 - 🛡️
code-reviewer.md(代码审查官)：拥有“一票否决权”，严格比对代码与 DDL/架构图的对齐度。 - 🗄️
database-reviewer.md(DBA 专家)：扼杀慢查询，优化索引设计，防范 N+1 陷阱。 - 🧪
qa-engineer.md(自动化测试专家)：破坏性测试思维，基于 JUnit5 + Mockito 挖掘隐藏边界 Bug。 - 🔒
security-reviewer.md(安全审计)：防御 OWASP Top 10，守护代码与数据安全。 - 🚀
devops-sre.md(云原生运维)：搞定 Dockerfile 最佳实践、环境一致性与 CI/CD 构建。
系统内置了完善的 Java 知识图谱，供 Agent 随时调用：
- 底层内功：
clean-code,design-patterns,java-coding-standards - 框架实战：
springboot-patterns,jpa-patterns,springboot-security,concurrency-review - 工程规范：
api-design,git-commit,logging-patterns,maven-dependency-audit
- 克隆本仓库：
git clone [https://github.com/your-username/Claude-Code-Java-SOP.git](https://github.com/your-username/Claude-Code-Java-SOP.git)
- 挂载到工作区：
将仓库中的
CLAUDE.md文件直接复制到你电脑的主目录下~/.claude/CLAUDE.md。 - 修改设置： 将 ANTHROPIC_AUTH_TOKEN 换成自己的密码
- 唤醒你的研发团队： 在 Claude Code 中，通过简单的自然语言即可触发标准化流程。
| 步骤 | 操作指令（示例） | 关键输出 |
|---|---|---|
| 1. 架构设计 | "@architect: "设计会议纪要分析功能，需支持异步处理。 | ## [DESIGN] (含 DDL、Mermaid 时序图和接口定义) |
| 2. 任务规划 | "@planner: "基于上述设计方案，拆解具体的实现步骤和风险点。 | Implementation Plan (分阶段的详细执行路线图) |
| 3. 编码实现 | "@java-developer: "读取 ## [DESIGN]，实现会议纪要分析的核心业务逻辑。 | ## [IMPLEMENTATION] (符合防御性编程规范的 Java 代码) |
| 4. 数据库评审 | "@database-reviewer: "审核上述实现中的 SQL 语句和索引设计。 | Database Review Report (优化建议及 EXPLAIN 分析) |
| 5. 代码评审 | "@code-reviewer: "根据架构设计约束，对上述代码执行铁血评审。 | ## [REVIEW_LOG] (评分及 BLOCKER/WARN 缺陷列表) |
| 6. 自动化测试 | "@qa-engineer: "对实现的业务逻辑进行破坏性单元测试，确保边界覆盖。 | ## [TEST_REPORT] (JUnit 5 + Mockito 测试套件) |
这是一个不断进化的开源项目。如果你在实践中总结出了更好的 SOP 流程，或者扩展了新的专家技能（比如 Vue 前端架构、Python 数据流），欢迎提交 PR！
如果你觉得这个项目真正提升了你的开发效率，请不要吝啬你的 ⭐️ Star，这是对开源创作者最大的鼓励！
本项目基于 MIT License 开源。