emoon-backend/AGENTS.md

医梦 AI 中台

本项目是一个基于 RuoYi-Vue-Plus 改造的 Maven 多模块工程（Java 17 / Spring Boot 3 / MyBatis-Plus），核心业务是面向医院的 AI 中台和门诊软硬件一体化方案。

Agent skills

Issue tracker

议题以本地 Markdown 文件记录在 .scratch/<feature>/ 目录下。详见 docs/agents/issue-tracker.md。

Triage labels

使用中文标签：待评估、待补充、可自动执行、需人工处理、不做。详见 docs/agents/triage-labels.md。

Domain docs

单上下文布局：CONTEXT.md + docs/adr/。详见 docs/agents/domain.md。

工程约束速查

所有 AI 编程工具写代码前先读取以下文档：

• docs/架构文档/AI中台工程约束.md — 模块边界、依赖规则、接口归属表、六条红线
• docs/架构文档/工程规约生效说明.md — 架构测试运行方式
• docs/接口文档/医梦AI中台对外接口设计文档_v1.2_正式联调基准版.md — 对外接口契约
• docs/架构文档/AI中台二期+三期需求技术方案.md — 架构决策、数据模型、组件职责

开发流程自动激活规则

以下规则定义了什么场景下自动使用哪个 skill。你必须在对应的触发条件下主动提议或直接执行对应 skill，不需要等待用户记住 skill 名称。

场景 → Skill 映射表

场景	自动执行/提议的 Skill	说明
写新功能/新模块/新接口	tdd	先写测试→红→绿→重构
修改现有代码/重构	tdd + review	先读现有测试，改代码，跑全量测试，再 review diff
用户要求审查代码	review	读取 diff，检查正确性/安全性/测试覆盖
讨论技术方案/架构设计	grill-me	追问式审查，澄清所有模糊点和边界条件
遇到编译错误/测试失败/线上故障	diagnose	复现→缩小范围→假设→验证→修复
从零开始一个新需求	to-prd → grill-me → tdd	结构化需求→设计审查→测试驱动实现
修改 Maven 依赖/模块结构	improve-codebase-architecture + review	架构变更双审查
修改接口 YAML/路径/Schema	review + 提醒更新 docs/接口文档/	接口契约和文档同步
涉及鉴权/脱敏/安全	security_review	安全专项审查
用户问"这个模块做什么的"/"代码在哪里"	explore	只读探索，不修改
用户要求验证/验收	运行 mvn -pl <module> -DskipTests=false test	编译+测试

标准开发循环

无论任务是哪个阶段，每次写代码遵循：

1. 理解上下文 → 读相关设计文档和现有代码
2. 写测试 → 先表达"这段代码应该做什么"
3. 跑测试确认失败 → 验证测试本身正确
4. 写最小实现 → 只写让测试通过的必要代码
5. 跑测试确认通过 → 绿了才能继续
6. 重构 → 消除重复、改善命名、提取方法
7. 跑全量测试 → 确认没有破坏已有功能
8. 编译+架构测试 → `mvn compile` + `AiPlatformArchitectureTest`
9. 报告结果 → 测试数量、通过/失败、改动文件清单

每次修改代码后的强制检查

mvn -pl <改动的模块> -am -DskipTests compile   # 必须通过
mvn -pl <改动的模块> -DskipTests=false -Dprofiles.active= test  # 涉及测试代码时

如果修改了 Maven 模块结构（新增/删除模块、改依赖），额外执行：

mvn -pl emoon-admin -DskipTests=false -Dprofiles.active= -Dtest=AiPlatformArchitectureTest test

禁止行为

• 跳过测试直接写实现
• 修改代码后不编译验证
• 新建模块后不更新根 pom.xml 的 dependencyManagement
• 在 Controller 中注入 Mapper（违反工程约束 F1 红线）
• 在 emoon-openplatform 中写业务逻辑
• 把 Dify/HIS/DeepSeek 的 API Key 写进日志或前端