# 智慧水务通Mcp中心服务

> 这个是智慧水务平台的Mcp中心服务

## AI 协作规则

### 单一事实来源

规则正文**唯一**存放在 **`.cursor/rules/*.mdc`**。修改约定时**只编辑这些文件**，勿在别处维护重复副本。

### 与 Cursor 的差异（重要）

- **Cursor** 会按每个 `.mdc` 顶部的 YAML（如 `alwaysApply`、`globs`）自动决定是否注入上下文。
- **Claude Code 不会**根据上述 YAML 自动做同等筛选；须在任务中**主动读取**相关文件（例如用 Read 工具，或在对话里 `@` 对应路径），否则容易漏掉仅带 `globs` 的规则。

### 必读与按需读取

开展**实质性**工作（改代码、改配置、做方案/评审）前：

1. **必读**：`project-context.mdc`、`architecture.mdc`（全局上下文与项目架构）。
2. **按当前任务路径选读**（与各文件 `globs` 对齐，避免漏规）：
   - 涉及 `pom.xml` 或 `src/**/application.properties` 读取 `build-and-run.mdc`
   - 涉及 `src/**/*.java` 读取 `coding-standards.mdc`
   - 涉及 `src/**/dbdao/**/*.java` 读取 `database-persistence.mdc`

当前目录下对应文件为：

- `.cursor/rules/project-context.mdc`
- `.cursor/rules/architecture.mdc`
- `.cursor/rules/build-and-run.mdc`
- `.cursor/rules/coding-standards.mdc`
- `.cursor/rules/database-persistence.mdc`

若新增其他 `.mdc`，同样视为规则的一部分，**在相关工作时主动阅读**。

### 仓库维护约定

- **勿**将 `.cursor/rules/` 或其中文件加入 **`.claudeignore`**（或等价忽略配置），否则 Claude 侧无法可靠读到规则。
- 若本文件与任一 `.mdc` 冲突，**以 `.cursor/rules/*.mdc` 为准**。