claude-md-master

---
name: claude-md-master
description: Claude.md 生命周期（创建、更新、改进）的掌握技能，支持仓库验证内容和多模块。在创建或更新 Claude.md 文件时使用。
---

# CLAUDE.md 大师（创建/更新/改进）

## 何时使用
- 用户要求创建、改进、更新或标准化 CLAUDE.md 文件时。

## 核心规则
- 仅包含仓库或配置中已验证的信息。
- 绝不包含秘密、令牌、凭据或用户数据。
- 绝不包含特定任务或临时指令。
- 保持简洁：根文件 <= 200 行，模块文件 <= 120 行。
- 使用项目符号；避免冗长的散文。
- 命令必须可复制粘贴，并来源于仓库文档/脚本/CI。
- 跳过空部分；避免填充内容。

## 强制输入（生成前分析）
- 与检测到的堆栈（根 + 模块）相关的构建/打包配置。
- 仓库中使用的静态分析配置（如果存在）。
- 实际模块结构和源模式（扫描真实目录/文件）。
- 每个模块的代表性源根，用于提取：
  包/特性结构、关键类型和正在使用的注解。

## 发现（快速 + 有针对性）
1. 找到现有的 CLAUDE.md 变体：`CLAUDE.md`、`.claude.md`、`.claude.local.md`。
2. 通过最少量的读取识别技术栈和入口点：
   - `README.md`，相关的 `docs/*`
   - 构建/打包文件（参见技术栈引用）
   - 运行时/配置：`Dockerfile`、`docker-compose.yml`、`.env.example`、`config/*`
   - CI：`.github/workflows/*`、`.gitlab-ci.yml`、`.circleci/*`
3. 仅当命令存在于仓库脚本/配置/文档中时才提取它们。
4. 检测多模块结构：
   - Android/Gradle：读取 `settings.gradle` 或 `settings.gradle.kts` 中的 include。
   - iOS：检测 `*.xcodeproj`/`*.xcworkspace` 中的多个 target/workspace。
   - 如果有多个模块/target 包含 `src/` 或构建配置，则规划模块 CLAUDE.md 文件。
5. 对于每个模块候选，读取其构建文件 + 最少量的文档，以捕获模块特定的目的、入口点和命令。
6. 扫描源代码根目录以查找：
   - 顶层包/功能文件夹和分层约定。
   - 使用中的关键注解/类型（根据技术栈引用）。
   - 代码库中使用的命名约定。
7. 从文档或代码模式中捕获不明显的流程/陷阱。

性能：
- 优先使用文件列表 + 有针对性的读取。
- 当一个部分或符号足够时，避免完整文件读取。
- 跳过大型目录：`node_modules`、`vendor`、`build`、`dist`。

## 特定技术栈参考（模式2）
仅当出现检测信号时才阅读相关参考：
- Android/Gradle → `references/android.md`
- iOS/Xcode/Swift → `references/ios.md`
- PHP → `references/php.md`
- Go → `references/go.md`
- React (web) → `references/react-web.md`
- React Native → `references/react-native.md`
- Rust → `references/rust.md`
- Python → `references/python.md`
- Java/JVM → `references/java.md`
- Node tooling → `references/node.md`
- .NET/C# → `references/dotnet.md`
- Dart/Flutter → `references/flutter.md`
- Ruby/Rails → `references/ruby.md`
- Elixir/Erlang → `references/elixir.md`
- C/C++/CMake → `references/cpp.md`
- Other/Unknown → `references/generic.md` (当没有特定参考匹配时的备用方案)

如果检测到多个技术栈，请阅读多个参考。
如果没有识别出任何技术栈，请使用通用参考。

## 多模块输出策略（检测到时强制执行）
- 始终创建根 `CLAUDE.md`。
- 也在每个有意义的模块/目标根目录中创建 `CLAUDE.md`。
  - “有意义” = 拥有自己的构建配置和 `src/`（或等效目录）。
  - 跳过仅包含工具的目录，如 `buildSrc`、`gradle`、`scripts`、`tools`。
- 模块文件必须是模块特定的，并避免重复：
  - 包含目的、关键路径、入口点、模块测试和模块命令（如果有）。
  - 通过 `@/CLAUDE.md` 引用共享信息。

## 业务模块 CLAUDE.md 策略（所有技术栈）
对于 monorepo 业务逻辑目录（`src/`、`lib/`、`packages/`、`internal/`）：
- 对于文件数 >5 或拥有自己 README 的模块，创建 `CLAUDE.md`
- 跳过仅包含工具的目录：`Helper`、`Utils`、`Common`、`Shared`、`Exception`、`Trait`、`Constants`
- 不要求分层结构；无论架构如何，都提供模块信息
- 每个模块的 CLAUDE.md 最多 120 行
- 通过 `@/CLAUDE.md` 引用根目录以获取共享架构/模式
- 包含：目的、结构、关键类、依赖项、入口点

## 强制输出部分（每个模块的 CLAUDE.md）
如果代码库中检测到以下部分，则包含它们（仅当不存在时才跳过）：
- **功能/组件清单**：列出源根目录下的顶级目录
- **核心/共享模块**：工具、通用或共享代码目录
- **导航/路由结构**：导航图、路由或路由器
- **网络/API 层模式**：API 客户端、端点、响应封装器
- **DI/注入模式**：模块、容器或注入设置
- **构建/配置文件**：模块特定配置（proguard、manifests 等）

请参阅特定技术栈的参考资料，了解要检测和报告的确切模式。

## 更新工作流程（必须遵循）
1. 仅提出有针对性的添加；显示每个文件的差异。

2. 在应用更新之前请求批准：

**Cursor IDE:**
使用 AskQuestion 工具，并带以下选项：
- id: "approval"
- prompt: "应用这些 CLAUDE.md 更新吗？"
- options: [{"id": "yes", "label": "是，应用"}, {"id": "no", "label": "否，取消"}]

**Claude Code (终端):**
输出建议的更改并询问：
"您批准这些更新吗？(yes/no)"
停止并等待用户响应，然后继续。

**其他环境（回退）：**
如果没有可用的结构化提问工具：
1. 清晰展示建议的更改
2. 提问：“您批准这些更新吗？回复‘yes’应用，或回复‘no’取消。”
3. 在继续之前等待明确的用户确认

3. 应用更新，保留自定义内容。

如果 `CLAUDE.md` 不存在，建议新建文件以供批准。

## 内容提取规则（强制）
- 仅从代码库中提取：
  - 提取：使用的类型/类/注解名称、真实路径模式、命名约定。
  - 绝不提取：硬编码值、秘密、API 密钥、业务特定逻辑。
  - 绝不提取：Do/Do Not 规则中的代码片段。

## 编写前验证
- [ ] 每条规则都引用了代码库中的实际类型/路径
- [ ] Do/Do Not 部分没有代码示例
- [ ] 模式与代码库中的实际内容匹配（未过时）

## 内容规则
- 包含：命令、架构摘要、关键路径、测试、注意事项、工作流怪癖。
- 排除：通用最佳实践、显而易见的信息、未经证实 statements。
- 使用 `@path/to/file` 导入以避免重复。
- Do/Do Not 格式是可选的；仅当文件中已使用时才保留。
- 避免代码示例，除了简短的复制粘贴命令。

## 现有文件策略
检测：
- 如果存在 `<!-- Generated by claude-md-editor skill -->` → 后续运行
- 否则 → 首次运行

首次运行 + 现有文件：
- 备份 `CLAUDE.md` → `CLAUDE.md.bak`
- 使用 `.bak` 作为来源，仅提取可重用的、项目特定的信息
- 生成一个新的简洁文件并添加标记

后续运行：
- 保留自定义部分和措辞，除非过时或不正确
- 仅更新与当前仓库状态冲突的内容
- 仅当缺少的部分确实增加了价值时才添加

绝不修改 `.claude.local.md`。

## 输出
更新后，打印一份简洁的报告：
```
## CLAUDE.md 更新报告
- /CLAUDE.md [CREATED | BACKED_UP+CREATED | UPDATED]
- /<module>/CLAUDE.md [CREATED | UPDATED]
- 备份：列出所有 `.bak` 文件
```

## 验证清单
- 描述具体，包含触发词
- 无占位符残留
- 不包含秘密信息
- 命令真实且可复制粘贴
- 遵循报告优先原则
- 引用深度为一层
 文件：README.md
# claude-md-master

CLAUDE.md 生命周期管理的核心技能：使用经过仓库验证的数据，创建、更新和改进文件，支持多模块和特定堆栈规则。

## 概述
- 目标：根据真实的仓库数据生成准确、简洁的 `CLAUDE.md` 文件
- 范围：根目录 + 有意义的模块，支持特定堆栈检测
- 安全措施：无秘密信息，无冗余内容，写入前需明确批准

## AI 如何发现和使用此技能
- 发现：工具通过仓库技能目录（已安装/环境中可用）学习此技能
- 自动使用：当请求包含“创建/更新/改进 CLAUDE.md”时，工具会选择此技能作为最佳匹配
- 手动使用：操作员可以明确调用 `/claude-md-master` 来强制执行此工作流
- 运行行为：它会扫描仓库文档/配置/源代码，提出更改建议，并在获得明确批准后才写入文件

## 受众
- 在 Cursor/Claude Code 中使用技能的 AI 操作员
- 负责演进规则和引用的维护者

## 功能
- 使用经过验证、源自仓库的内容生成或更新 `CLAUDE.md`
- 强制执行严格的安全和简洁规则（无秘密信息，无冗余内容）
- 检测多模块仓库并生成模块级别的 `CLAUDE.md`
- 使用特定堆栈引用来捕获准确的模式

## 使用时机
- 用户要求创建、改进、更新或标准化 `CLAUDE.md`
- 仓库需要针对 AI 工作流提供一致、经过验证的指导

## 所需输入（必须分析）
- 仓库文档：`README.md`、`docs/*`（如果存在）
- 与检测到的技术栈相关的构建/配置文件
- 运行时/配置：`Dockerfile`、`.env.example`、`config/*`（如果存在）
- CI：`.github/workflows/*`、`.gitlab-ci.yml`、`.circleci/*`（如果存在）
- 源代码根目录，用于提取真实结构、类型、注解、命名

## 输出
- 根目录 `CLAUDE.md`（始终）
- 针对有意义模块的模块 `CLAUDE.md`（构建配置 + `src/`）
- 简洁的更新报告，列出已创建/更新的文件和备份

## 工作流程（高层）
1. 定位现有 `CLAUDE.md` 变体并检测是首次运行还是后续运行
2. 识别技术栈和多模块结构
3. 读取相关文档/配置/CI 以获取真实命令和工作流程
4. 扫描源代码根目录以获取结构、关键类型、注解、模式
5. 生成根文件 + 模块文件，通过 `@/CLAUDE.md` 避免重复
6. 在应用更新前请求明确批准
7. 应用更改并打印更新报告

## 核心规则和约束
- 仅包含在仓库中验证过的信息；绝不添加秘密
- 保持简洁：根文件 <= 200 行，模块文件 <= 120 行
- 命令必须真实，且可从仓库文档/脚本/CI 中复制粘贴
- 跳过空部分；避免通用指导
- 绝不修改 `.claude.local.md`
- 在“应做/不应做”部分避免代码示例

## 多模块策略（摘要）
- 始终创建根 `CLAUDE.md`
- 仅为有意义的模块创建模块级文件
- 跳过仅包含工具的目录（例如 `buildSrc`、`gradle`、`scripts`、`tools`）
- 当业务模块文件数 >5 或有自己的 README 时，为其创建独立文件

## 参考资料（特定技术栈指南）
每份参考资料都定义了检测信号、预生成来源、代码库扫描目标、强制输出项、命令来源和关键路径。

- `references/android.md` — Android/Gradle
- `references/ios.md` — iOS/Xcode/Swift
- `references/react-web.md` — React Web 应用
- `references/react-native.md` — React Native
- `references/node.md` — Node 工具（通用）
- `references/python.md` — Python
- `references/java.md` — Java/JVM
- `references/dotnet.md` — .NET (C#/F#)
- `references/go.md` — Go
- `references/rust.md` — Rust
- `references/flutter.md` — Dart/Flutter
- `references/ruby.md` — Ruby/Rails
- `references/php.md` — PHP (Laravel/Symfony/CI/Phalcon)
- `references/elixir.md` — Elixir/Erlang
- `references/cpp.md` — C/C++
- `references/generic.md` — 当没有匹配的技术栈时的回退方案

## 扩展技能
- 使用相同的模板添加新的 `references/<stack>.md`
- 保持检测信号和强制输出具体且可验证
- 不要引入未经验证的命令或通用建议

## 质量检查清单
- 每条规则都引用了仓库中实际的类型/路径
- 没有遗留占位符
- 不包含秘密信息
- 命令真实且可复制粘贴
- 遵循“报告优先”原则；引用深度为一级
文件：references/android.md
# Android (Gradle)

## 检测信号
- `settings.gradle` 或 `settings.gradle.kts`
- `build.gradle` 或 `build.gradle.kts`
- `gradle.properties`
- `gradle/libs.versions.toml`
- `gradlew`
- `gradle/wrapper/gradle-wrapper.properties`
- `app/src/main/AndroidManifest.xml`

## 多模块信号
- `settings.gradle*` 中有多个 `include(...)` 或 `includeBuild(...)` 条目
- 多个模块目录包含 `build.gradle*` 和 `src/`
- 常见的模块根目录，如 `feature/`、`core/`、`library/`（如果存在）

## 生成前，分析以下来源
- `settings.gradle` 或 `settings.gradle.kts`
- `build.gradle` 或 `build.gradle.kts`（根目录和模块）
- `gradle/libs.versions.toml`
- `gradle.properties`
- `config/detekt/detekt.yml`（如果存在）
- `app/src/main/AndroidManifest.xml`（或模块清单）

## 代码库扫描（Android 特有）
- 每个模块的源根目录：`*/src/main/java/`、`*/src/main/kotlin/`
- 功能/层级文件夹的包树（仅当存在时记录）：
  `features/`、`core/`、`common/`、`data/`、`domain/`、`presentation/`、
  `ui/`、`di/`、`navigation/`、`network/`
- 注解使用情况（仅当存在时记录）：
  Hilt (`@HiltAndroidApp`、`@AndroidEntryPoint`、`@HiltViewModel`、
  `@Module`、`@InstallIn`、`@Provides`、`@Binds`)、
  Compose (`@Composable`、`@Preview`)、
  Room (`@Entity`、`@Dao`、`@Database`)、
  WorkManager (`@HiltWorker`、`ListenableWorker`、`CoroutineWorker`)、
  Serialization (`@Serializable`、`@Parcelize`)、
  Retrofit (`@GET`、`@POST`、`@PUT`、`@DELETE`、`@Body`、`@Query`)
- 导航模式（仅当存在时记录）：`NavHost`、`composable`

## 强制输出 (Android 模块 CLAUDE.md)
如果检测到以下内容，请包含它们（列出找到的实际名称）：
- **功能清单**：列出 `features/` 下的目录（例如，homepage, payment, auth）
- **核心模块**：列出 `core/` 下的目录（例如，data, network, localization）
- **导航图**：列出 `*Graph.kt` 或 `*Navigator*.kt` 文件
- **Hilt 模块**：列出 `@Module` 类或 `di/` 包内容
- **Retrofit API**：列出 `*Api.kt` 接口
- **Room 数据库**：列出 `@Database` 类
- **Workers**：列出 `@HiltWorker` 类
- **Proguard**：如果存在，提及 `proguard-rules.pro`

## 命令来源
- README/文档或 CI 调用 Gradle wrapper
- 调用 `./gradlew` 的仓库脚本
- 文档/脚本中使用的 `./gradlew assemble`, `./gradlew test`, `./gradlew lint`
- 仅包含仓库中存在的命令

## 需要提及的关键路径（仅当存在时）
- `app/src/main/`, `app/src/main/res/`
- `app/src/main/java/`, `app/src/main/kotlin/`
- `app/src/test/`, `app/src/androidTest/`
 FILE:references/cpp.md 
# C / C++

## 检测信号
- `CMakeLists.txt`
- `meson.build`
- `Makefile`
- `conanfile.*`, `vcpkg.json`
- `compile_commands.json`
- `src/`, `include/`

## 多模块信号
- 包含 `add_subdirectory(...)` 的 `CMakeLists.txt`
- 子目录中存在多个 `CMakeLists.txt` 或 `meson.build`
- `libs/`, `apps/`, 或 `modules/` 包含它们自己的构建文件

## 生成前，分析这些来源
- `CMakeLists.txt` / `meson.build` / `Makefile`
- `conanfile.*`, `vcpkg.json` (如果存在)
- `compile_commands.json` (如果存在)
- `src/`, `include/`, `tests/`, `libs/`

## 代码库扫描 (C/C++ 特定)
- 源代码根目录: `src/`, `include/`, `tests/`, `libs/`
- 库/应用分离 (仅当存在时记录):
  `src/lib`, `src/app`, `src/bin`
- 命名空间和类前缀 (仅当存在时记录)
- CMake 目标 (仅当存在时记录):
  `add_library`, `add_executable`

## 强制输出 (C/C++ 模块 CLAUDE.md)
如果检测到，请包含以下内容 (列出找到的实际名称):
- **库**: 列出库目标
- **可执行文件**: 列出可执行目标
- **头文件**: 列出公共头文件目录
- **模块/组件**: 列出包含构建文件的子目录
- **依赖项**: 列出 Conan/vcpkg 依赖项 (如果有)

## 命令来源
- README/文档或 CI 调用 `cmake`, `ninja`, `make`, 或 `meson`
- 调用构建工具的仓库脚本
- 仅包含仓库中存在的命令

## 需要提及的关键路径 (仅当存在时)
- `src/`, `include/`
- `tests/`, `libs/`
 文件:references/dotnet.md
# .NET (C# / F#)

## 检测信号
- `*.sln`
- `*.csproj`, `*.fsproj`, `*.vbproj`
- `global.json`
- `Directory.Build.props`, `Directory.Build.targets`
- `nuget.config`
- `Program.cs`
- `Startup.cs`
- `appsettings*.json`

## 多模块信号
- 包含多个项目条目的 `*.sln`
- `src/` 和 `tests/` 下的多个 `*.*proj` 文件
- 管理跨项目共享设置的 `Directory.Build.*`

## 生成前，分析这些来源
- `*.sln`, `*.csproj` / `*.fsproj` / `*.vbproj`
- `Directory.Build.props`, `Directory.Build.targets`
- `global.json`, `nuget.config`
- `Program.cs` / `Startup.cs`
- `appsettings*.json`

## 代码库扫描（.NET 特有）
- 源代码根目录：`src/`、`tests/`、包含 `*.csproj` 的项目文件夹
- 分层文件夹（仅当存在时记录）：
  `Controllers`、`Services`、`Repositories`、`Domain`、`Infrastructure`
- ASP.NET 属性（仅当存在时记录）：
  `[ApiController]`、`[Route]`、`[HttpGet]`、`[HttpPost]`、`[Authorize]`
- EF Core 使用情况（仅当存在时记录）：
  `DbContext`、`Migrations`、`[Key]`、`[Table]`

## 强制输出（.NET 模块 CLAUDE.md）
如果检测到，请包含以下内容（列出找到的实际名称）：
- **控制器**：列出 `[ApiController]` 类
- **服务**：列出服务类
- **仓储**：列出仓储类
- **实体**：列出 EF Core 实体类
- **DbContext**：列出数据库上下文类
- **中间件**：列出自定义中间件
- **配置**：列出配置节或选项类

## 命令来源
- README/文档或 CI 调用 `dotnet`
- 仓库脚本，如 `build.ps1`、`build.sh`
- 文档/脚本中 `dotnet run`、`dotnet test` 的使用
- 仅包含仓库中存在的命令

## 需要提及的关键路径（仅当存在时）
- `src/`、`tests/`
- `appsettings*.json`
- `Controllers/`、`Models/`、`Views/`、`wwwroot/`
 文件：references/elixir.md
# Elixir / Erlang

## 检测信号
- `mix.exs`、`mix.lock`
- `config/config.exs`
- `lib/`、`test/`
- `apps/`（umbrella 项目）
- `rel/`

## 多模块信号
- 包含多个 `mix.exs` 的 `apps/` 目录下的 umbrella 项目
- 根 `mix.exs` 中包含 `apps_path`

## 生成前，分析这些来源
- 根 `mix.exs`、`mix.lock`
- `config/config.exs`
- `apps/*/mix.exs`（umbrella 项目）
- `lib/`、`test/`、`rel/`

## 代码库扫描 (Elixir 特有)
- 源代码根目录: `lib/`, `test/`, `apps/*/lib` (umbrella 项目)
- Phoenix 结构 (仅当存在时记录):
  `lib/*_web/`, `controllers`, `views`, `channels`, `routers`
- Ecto 用法 (仅当存在时记录):
  `schema`, `Repo`, `migrations`
- 上下文/模块 (仅当存在时记录):
  `lib/*/` 上下文模块和 `*_context.ex`

## 强制输出 (Elixir 模块 CLAUDE.md)
如果检测到，请包含以下内容（列出实际找到的名称）：
- **上下文**: 列出上下文模块
- **Schemas**: 列出 Ecto schema 模块
- **Controllers**: 列出 Phoenix controller 模块
- **Channels**: 列出 Phoenix channel 模块
- **Workers**: 列出后台作业模块 (Oban 等)
- **Umbrella apps**: 列出 umbrella 项目下的应用 (如果有)

## 命令来源
- README/文档或 CI 调用 `mix`
- 调用 `mix` 的仓库脚本
- 仅包含仓库中存在的命令

## 需要提及的关键路径 (仅当存在时)
- `lib/`, `test/`, `config/`
- `apps/`, `rel/`
 FILE:references/flutter.md 
# Dart / Flutter

## 检测信号
- `pubspec.yaml`, `pubspec.lock`
- `analysis_options.yaml`
- `lib/`
- `android/`, `ios/`, `web/`, `macos/`, `windows/`, `linux/`

## 多模块信号
- `melos.yaml` (Flutter monorepo)
- `packages/`, `apps/` 或 `plugins/` 下的多个 `pubspec.yaml`

## 生成前，分析这些来源
- `pubspec.yaml`, `pubspec.lock`
- `analysis_options.yaml`
- `melos.yaml` (如果是 monorepo)
- `lib/`, `test/` 和平台文件夹 (`android/`, `ios/` 等)

## 代码库扫描 (Flutter 特有)
- 源代码根目录: `lib/`, `test/`
- 入口点 (仅当存在时记录): `lib/main.dart`
- 分层文件夹 (仅当存在时记录):
  `features/`, `core/`, `data/`, `domain/`, `presentation/`
- 状态管理 (仅当存在时记录):
  `Bloc`, `Cubit`, `ChangeNotifier`, `Provider`, `Riverpod`
- Widget 命名 (仅当存在时记录):
  `*Screen`, `*Page`

## 强制输出 (Flutter 模块 CLAUDE.md)
如果检测到则包含这些 (列出实际找到的名称):
- **Features**: 列出 `features/` 或 `lib/` 下的目录
- **Core modules**: 列出 `core/` 下的目录 (如果存在)
- **State management**: 列出 Bloc/Cubit/Provider 设置
- **Repositories**: 列出 repository 类
- **Data sources**: 列出远程/本地数据源类
- **Widgets**: 列出共享 widget 目录

## 命令来源
- README/文档或 CI 调用 `flutter`
- 调用 `flutter` 或 `dart` 的仓库脚本
- 文档/脚本中 `flutter run`, `flutter test`, `flutter pub get` 的使用
- 仅包含仓库中存在的命令

## 需要提及的关键路径 (仅当存在时)
- `lib/`, `test/`
- `android/`, `ios/`
 文件:references/generic.md
# 通用 / 未知技术栈

当没有特定的技术栈参考匹配时，使用此参考。

## 检测信号 (常见模式)
- `README.md`, `CONTRIBUTING.md`
- `Makefile`, `Taskfile.yml`, `justfile`
- `Dockerfile`, `docker-compose.yml`
- `.env.example`, `config/`
- CI 文件: `.github/workflows/`, `.gitlab-ci.yml`, `.circleci/`

## 生成前，分析这些来源
- `README.md` - 项目概览、设置说明、命令
- 根目录下的构建/包文件 (任何可识别的格式)
- `Makefile`, `Taskfile.yml`, `justfile`, `scripts/` (如果存在)
- CI/CD 配置中的构建/测试命令
- `Dockerfile` 中的运行时信息

## 代码库扫描（通用）
- 识别源根目录：`src/`、`lib/`、`app/`、`pkg/` 或根目录
- 分层文件夹（仅当存在时记录）：
  `controllers`、`services`、`models`、`handlers`、`utils`、`config`
- 入口点：`main.*`、`index.*`、`app.*`、`server.*`
- 测试位置：`tests/`、`test/`、`spec/`、`__tests__/` 或同级目录

## 强制输出（通用 CLAUDE.md）
如果检测到以下内容，请包含（列出找到的实际名称）：
- **入口点**：主文件、启动脚本
- **源结构**：源根目录下的顶级目录
- **配置文件**：环境、设置、秘密模板
- **构建系统**：检测到的构建工具和配置位置
- **测试设置**：测试框架和运行命令

## 命令来源
- README 设置/使用部分
- `Makefile` 目标、`Taskfile.yml` 任务、`justfile` 菜谱
- CI 工作流步骤（构建、测试、lint）
- `scripts/` 目录
- 仅包含仓库中存在的命令

## 需要提及的关键路径（仅当存在时）
- 源根目录及其顶级结构
- 配置/环境文件
- 测试目录
- 文档位置
- 构建输出目录
 文件：references/go.md
# Go

## 检测信号
- `go.mod`、`go.sum`、`go.work`
- `cmd/`、`internal/`
- `main.go`
- `magefile.go`
- `Taskfile.yml`

## 多模块信号
- 包含多个模块路径的 `go.work`
- 子目录中存在多个 `go.mod` 文件
- `apps/` 或 `services/` 各自拥有自己的 `go.mod`

## 生成前，分析这些来源
- `go.work`、`go.mod`、`go.sum`
- `cmd/`、`internal/`、`pkg/` 布局
- `Makefile`、`Taskfile.yml`、`magefile.go`（如果存在）

## 代码库扫描 (Go 语言特定)
- 源代码根目录: `cmd/`, `internal/`, `pkg/`, `api/`
- 分层文件夹 (仅当存在时记录):
  `handler`, `service`, `repository`, `store`, `config`
- 框架标记 (仅当存在时记录):
  `gin`, `echo`, `fiber`, `chi` 导入
- 入口点 (仅当存在时记录):
  `cmd/*/main.go`, `main.go`

## 强制输出 (Go module CLAUDE.md)
如果检测到以下内容，请包含它们 (列出实际找到的名称):
- **命令**: 列出 `cmd/` 下的二进制文件
- **处理程序**: 列出 HTTP 处理程序包
- **服务**: 列出服务包
- **仓库**: 列出仓库或存储包
- **模型**: 列出领域模型包
- **配置**: 列出配置加载包

## 命令来源
- README/文档或 CI
- `Makefile`, `Taskfile.yml`, 或调用 Go 工具的仓库脚本
- 文档/脚本中 `go test ./...`, `go run` 的使用
- 仅包含仓库中存在的命令

## 需要提及的关键路径 (仅当存在时)
- `cmd/`, `internal/`, `pkg/`, `api/`
- `tests/` 或 `*_test.go` 布局
 FILE:references/ios.md 
# iOS (Xcode/Swift)

## 检测信号
- `Package.swift`
- `*.xcodeproj` 或 `*.xcworkspace`
- `Podfile`, `Cartfile`
- `Project.swift`, `Tuist/`
- `fastlane/Fastfile`
- `*.xcconfig`
- `Sources/` 或 `Tests/` (SPM 布局)

## 多模块信号
- `*.xcworkspace` 或 `*.xcodeproj` 中有多个 target/project
- 包含多个 target/product 的 `Package.swift`
- `Sources/<TargetName>` 和 `Tests/<TargetName>` 布局
- 定义多个 target 的 `Project.swift` (Tuist)

## 生成前，请分析以下来源
- `Package.swift` (SPM)
- `*.xcodeproj/project.pbxproj` 或 `*.xcworkspace/contents.xcworkspacedata`
- `Podfile`, `Cartfile` (如果存在)
- `Project.swift` / `Tuist/` (如果存在)
- `fastlane/Fastfile` (如果存在)
- `Sources/` 和 `Tests/` 目录下的目标布局

## 代码库扫描 (iOS 特定)
- 源代码根目录: `Sources/`, `Tests/`, `ios/` (如果存在)
- 功能/层级文件夹 (仅当存在时记录):
  `Features/`, `Core/`, `Services/`, `Networking/`, `UI/`, `Domain/`, `Data/`
- SwiftUI 使用情况 (仅当存在时记录):
  `@main`, `App`, `@State`, `@StateObject`, `@ObservedObject`,
  `@Environment`, `@EnvironmentObject`, `@Binding`
- UIKit/生命周期 (仅当存在时记录):
  `UIApplicationDelegate`, `SceneDelegate`, `UIViewController`
- Combine/并发 (仅当存在时记录):
  `@Published`, `Publisher`, `AnyCancellable`, `@MainActor`, `Task`

## 强制输出 (iOS 模块 CLAUDE.md)
如果检测到以下内容，请包含它们 (列出实际找到的名称):
- **功能清单**: 列出 `Features/` 下的目录或功能目标
- **核心模块**: 列出 `Core/`, `Services/`, `Networking/` 下的目录
- **导航**: 列出协调器 (coordinators)、路由器 (routers) 或 SwiftUI 导航文件
- **DI 容器**: 列出 DI 设置 (Swinject, Factory, 手动容器)
- **网络层**: 列出 API 客户端或网络服务
- **持久化**: 列出 CoreData 模型或其他存储类

## 命令来源
- README/文档或 CI 调用 Xcode 或 Swift 工具
- 调用 Xcode/Swift 工具的仓库脚本
- 文档/脚本中 `xcodebuild`, `swift build`, `swift test` 的使用
- 仅包含仓库中存在的命令

## 提及的关键路径（仅当存在时）
- `Sources/`, `Tests/`
- `fastlane/`
- `ios/` (React Native 或多平台仓库)
 FILE:references/java.md 
# Java / JVM

## 检测信号
- `pom.xml` 或 `build.gradle*`
- `settings.gradle`, `gradle.properties`
- `mvnw`, `gradlew`
- `gradle/wrapper/gradle-wrapper.properties`
- `src/main/java`, `src/test/java`, `src/main/kotlin`
- `src/main/resources/application.yml`, `src/main/resources/application.properties`

## 多模块信号
- `settings.gradle*` 包含多个模块
- 带有 `<modules>` 的父 `pom.xml` (packaging `pom`)
- 子目录中存在多个 `build.gradle*` 或 `pom.xml` 文件

## 生成前，分析这些来源
- `settings.gradle*` 和 `build.gradle*` (如果是 Gradle)
- 父级和模块的 `pom.xml` (如果是 Maven)
- `gradle/libs.versions.toml` (如果存在)
- `gradle.properties` / `mvnw` / `gradlew`
- `src/main/resources/application.yml|application.properties` (如果存在)

## 代码库扫描 (Java/JVM 特有)
- 源代码根目录: `src/main/java`, `src/main/kotlin`, `src/test/java`, `src/test/kotlin`
- 包/层级文件夹 (仅当存在时记录):
  `controller`, `service`, `repository`, `domain`, `model`, `dto`, `config`, `client`
- 框架注解 (仅当存在时记录):
  `@SpringBootApplication`, `@RestController`, `@Controller`, `@Service`,
  `@Repository`, `@Component`, `@Configuration`, `@Bean`, `@Transactional`
- 持久化/验证 (仅当存在时记录):
  `@Entity`, `@Table`, `@Id`, `@OneToMany`, `@ManyToOne`, `@Valid`, `@NotNull`
- 入口点 (仅当存在时记录):
  带有 `main` 方法的 `*Application` 类

## 强制输出 (Java/JVM 模块 CLAUDE.md)
如果检测到，请包含以下内容（列出找到的实际名称）：
- **控制器**: 列出 `@RestController` 或 `@Controller` 类
- **服务**: 列出 `@Service` 类
- **仓库**: 列出 `@Repository` 类或 JPA 接口
- **实体**: 列出 `@Entity` 类
- **配置**: 列出 `@Configuration` 类
- **安全**: 列出安全配置或认证过滤器
- **配置文件**: 列出正在使用的 Spring 配置文件

## 命令来源
- Maven/Gradle wrapper 脚本
- README/文档或 CI
- 文档/脚本中使用的 `./mvnw spring-boot:run`, `./gradlew bootRun`
- 只包含仓库中存在的命令

## 需要提及的关键路径 (仅当存在时)
- `src/main/java`, `src/test/java`
- `src/main/kotlin`, `src/test/kotlin`
- `src/main/resources`, `src/test/resources`
- `src/main/java/**/controller`, `src/main/java/**/service`, `src/main/java/**/repository`
文件:references/node.md
# Node 工具 (通用)

## 检测信号
- `package.json`
- `package-lock.json`, `pnpm-lock.yaml`, `yarn.lock`
- `.nvmrc`, `.node-version`
- `tsconfig.json`
- `.npmrc`, `.yarnrc.yml`
- `next.config.*`, `nuxt.config.*`
- `nest-cli.json`, `svelte.config.*`, `astro.config.*`

## 多模块信号
- `pnpm-workspace.yaml`, `lerna.json`, `nx.json`, `turbo.json`, `rush.json`
- 根 `package.json` 带有 `workspaces`
- `apps/`, `packages/` 下的多个 `package.json`

## 生成前，分析这些来源
- 根 `package.json` 和工作区配置 (`pnpm-workspace.yaml`, `lerna.json`,
  `nx.json`, `turbo.json`, `rush.json`)
- `apps/*/package.json`, `packages/*/package.json` (如果是 monorepo)
- `tsconfig.json` 或 `jsconfig.json`
- 框架配置: `next.config.*`, `nuxt.config.*`, `nest-cli.json`,
  `svelte.config.*`, `astro.config.*` (如果存在)

## 代码库扫描（Node 特有）
- 源代码根目录：`src/`, `lib/`, `apps/`, `packages/`
- 文件夹模式（仅当存在时记录）：
  `routes`, `controllers`, `services`, `middlewares`, `handlers`,
  `utils`, `config`, `models`, `schemas`
- 框架标记（仅当存在时记录）：
  Express (`express()`, `Router`), Koa (`new Koa()`),
  Fastify (`fastify()`), Nest (`@Controller`, `@Module`, `@Injectable`)
- 全栈布局（仅当存在时记录）：
  Next/Nuxt (`pages/`, `app/`, `server/`)

## 强制输出（Node 模块 CLAUDE.md）
如果检测到以下内容，请包含（列出找到的实际名称）：
- **路由/页面**：列出路由文件或页面组件
- **控制器/处理程序**：列出控制器或处理程序文件
- **服务**：列出服务类或模块
- **中间件**：列出中间件文件
- **模型/模式**：列出数据模型或验证模式
- **状态管理**：列出存储设置（Redux, Zustand 等）
- **API 客户端**：列出外部 API 客户端模块

## 命令来源
- `package.json` 脚本
- README/文档或 CI
- 文档/脚本中 `npm|yarn|pnpm` 脚本的使用
- 仅包含仓库中存在的命令

## 需要提及的关键路径（仅当存在时）
- `src/`, `lib/`
- `tests/`
- `apps/`, `packages/` (monorepos)
- `pages/`, `app/`, `server/`, `api/`
- `controllers/`, `services/`
 FILE:references/php.md 
# PHP

## 检测信号
- `composer.json`, `composer.lock`
- `public/index.php`
- `artisan`, `spark`, `bin/console` (框架入口点)
- `phpunit.xml`, `phpstan.neon`, `phpstan.neon.dist`, `psalm.xml`
- `config/app.php`
- `routes/web.php`, `routes/api.php`
- `config/packages/` (Symfony)
- `app/Config/` (CI4)
- `ext-phalcon` in composer.json (Phalcon)
- `phalcon/ide-stubs`, `phalcon/devtools` (Phalcon)

## 多模块信号
- `modules/` 或 `app/Modules/` (HMVC 风格)
- `app/Config/Modules.php`, `app/Config/Autoload.php` (CI4)
- `composer.json` 中的多个 PSR-4 根
- `packages/` 或 `apps/` 下的多个 `composer.json`
- `apps/` 及其包含 `Module.php` 或 `controllers/` 的子目录

## 生成前，分析这些来源
- `composer.json`, `composer.lock`
- `config/` 和 `routes/` (框架配置)
- `app/Config/*` (CI4)
- `modules/` 或 `app/Modules/` (如果是 HMVC)
- `phpunit.xml`, `phpstan.neon*`, `psalm.xml` (如果存在)
- `bin/worker.php`, `bin/console.php` (CLI 入口点)

## 代码库扫描 (PHP 特有)
- 源代码根目录: `app/`, `src/`, `modules/`, `packages/`, `apps/`
- Laravel 结构 (仅当存在时记录):
  `app/Http/Controllers`, `app/Models`, `database/migrations`,
  `routes/*.php`, `resources/views`
- Symfony 结构 (仅当存在时记录):
  `src/Controller`, `src/Entity`, `config/packages`, `templates`
- CodeIgniter 结构 (仅当存在时记录):
  `app/Controllers`, `app/Models`, `app/Views`, `app/Config/Routes.php`,
  `app/Database/Migrations`
- Phalcon 结构 (仅当存在时记录):
  `apps/*/controllers/`, `apps/*/Module.php`, `models/`
- 属性/注解 (仅当存在时记录):
  `#[Route]`, `#[Entity]`, `#[ORM\\Column]`

## 业务模块发现
根据检测到的框架扫描这些路径:
- Laravel: `app/Services/`, `app/Domains/`, `app/Modules/`, `packages/`
- Symfony: `src/` 顶级目录
- CodeIgniter: `app/Modules/`, `modules/`
- Phalcon: `src/`, `apps/*/`
- 通用: `src/`, `lib/`

对于每个路径：
- 列出按文件计数排名前 5-10 的最大模块
- 对于每个重要模块（>5 个文件），如果可以从名称推断，请注明其用途
- 如果存在，识别分层模式：`*/Repository/`、`*/Service/`、`*/Controller/`、`*/Action/`

## 模块级 CLAUDE.md 信号
扫描以下路径以查找重要模块（框架特定）：
- `src/` - Symfony、Phalcon、自定义框架
- `app/Services/`、`app/Domains/` - Laravel 领域驱动
- `app/Modules/`、`modules/` - Laravel/CI4 HMVC
- `packages/` - Laravel 内部包
- `apps/` - Phalcon 多应用

在以下情况下创建 `<path>/<Module>/CLAUDE.md`：
- 阈值：模块有 >5 个文件或有自己的 `README.md`
- 跳过实用程序目录：`Helper/`、`Exception/`、`Trait/`、`Contract/`、`Interface/`、`Constants/`、`Support/`
- 不需要分层结构；无论架构如何，都提供模块信息

### 模块 CLAUDE.md 内容（最多 120 行）
- 用途：1-2 句模块描述
- 结构：列出子目录（Service/、Repository/ 等）
- 关键类：主要服务/管理器/操作类
- 依赖项：此模块依赖的其他模块（通过 use 语句）
- 入口点：主要的公共接口/外观
- 框架特定：ServiceProvider (Laravel)、Module.php (Phalcon/CI4)

## Worker/Job 检测
- `bin/worker.php` 或类似的 worker 入口点
- `*/Job/`、`*/Jobs/`、`*/Worker/` 目录
- 队列配置文件（`queue.php`、`rabbitmq.php`、`amqp.php`）
- 如果存在，列出 job 类

## API 版本控制检测
- `routes_v*.php` 或 `routes/v*/` 模式
- `controllers/v*/` 目录结构
- 从路由文件或配置中注明当前/活动的 API 版本

## 强制输出 (PHP 模块 CLAUDE.md)
如果检测到以下内容，请列出（列出实际找到的名称）：
- **控制器**: 列出控制器目录/类
- **模型**: 列出模型/实体类或目录
- **服务**: 列出服务类或目录
- **仓库**: 列出仓库类或目录
- **路由**: 列出路由文件和版本控制模式
- **迁移**: 提及迁移目录和文件数量
- **中间件**: 列出中间件类
- **视图/模板**: 提及视图引擎和布局
- **Worker/Job**: 如果存在，列出 Job 类
- **业务模块**: 按大小列出检测到的源路径中的顶级模块

## 命令源
- `composer.json` 脚本
- README/文档或 CI
- 文档/脚本中 `php artisan`、`bin/console` 的使用
- `bin/worker.php` 命令
- 仅包含仓库中存在的命令

## 需要提及的关键路径 (仅当存在时)
- `app/`, `src/`, `apps/`
- `public/`, `routes/`, `config/`, `database/`
- `app/Http/`, `resources/`, `storage/` (Laravel)
- `templates/` (Symfony)
- `app/Controllers/`, `app/Views/` (CI4)
- `apps/*/controllers/`, `models/` (Phalcon)
- `tests/`, `tests/acceptance/`, `tests/unit/`
文件:references/python.md
# Python

## 检测信号
- `pyproject.toml`
- `requirements.txt`, `requirements-dev.txt`, `Pipfile`, `poetry.lock`
- `tox.ini`, `pytest.ini`
- `manage.py`
- `setup.py`, `setup.cfg`
- `settings.py`, `urls.py` (Django)

## 多模块信号
- 子目录中存在多个 `pyproject.toml`/`setup.py`/`setup.cfg`
- `packages/` 或 `apps/`，每个都有自己的包配置
- Django 风格的 `apps/`，包含多个 `apps.py` (如果存在)

## 生成前，分析这些来源
- `pyproject.toml` 或 `setup.py` / `setup.cfg`
- `requirements*.txt`, `Pipfile`, `poetry.lock`
- `tox.ini`, `pytest.ini`
- `manage.py`, `settings.py`, `urls.py` (如果是 Django 项目)
- `src/`, `app/`, `packages/` 下的包根目录 (如果存在)

## 代码库扫描 (Python 特有)
- 源码根目录: `src/`, `app/`, `packages/`, `tests/`
- 文件夹模式 (仅当存在时记录):
  `api`, `routers`, `views`, `services`, `repositories`,
  `models`, `schemas`, `utils`, `config`
- Django 结构 (仅当存在时记录):
  `apps.py`, `models.py`, `views.py`, `urls.py`, `migrations/`, `settings.py`
- FastAPI/Flask 标记 (仅当存在时记录):
  `FastAPI()`, `APIRouter`, `@app.get`, `@router.post`,
  `Flask(__name__)`, `Blueprint`
- 类型模型使用 (仅当存在时记录):
  `pydantic.BaseModel`, `TypedDict`, `dataclass`

## 强制输出 (Python 模块 CLAUDE.md)
如果检测到以下内容，请包含 (列出找到的实际名称):
- **路由/视图**: 列出 API 路由或视图文件
- **服务**: 列出服务模块
- **模型/模式**: 列出数据模型 (Pydantic, SQLAlchemy, Django)
- **仓库**: 列出仓库或 DAO 模块
- **迁移**: 提及迁移目录
- **中间件**: 列出中间件类
- **Django 应用**: 列出已安装的应用 (如果是 Django 项目)

## 命令来源
- `pyproject.toml` 工具部分
- README/文档 或 CI
- 调用 Python 工具的仓库脚本
- 文档/脚本中 `python manage.py`, `pytest`, `tox` 的使用
- 仅包含仓库中存在的命令

## 需要提及的关键路径 (仅当存在时)
- `src/`, `app/`, `scripts/`
- `templates/`, `static/`
- `tests/`
 FILE:references/react-native.md 
# React Native

## 检测信号
- 包含 `react-native` 的 `package.json`
- `react-native.config.js`
- `metro.config.js`
- `ios/`, `android/`
- `babel.config.js`, `app.json`, `app.config.*`
- `eas.json`，`package.json` 中包含 `expo`

## 多模块信号
- `pnpm-workspace.yaml`, `lerna.json`, `nx.json`, `turbo.json`
- 根目录 `package.json` 包含 `workspaces`
- `packages/` 或 `apps/`，每个都包含 `package.json`

## 生成前，分析这些来源
- 根目录 `package.json` 和工作区配置 (`pnpm-workspace.yaml`, `lerna.json`,
  `nx.json`, `turbo.json`)
- `react-native.config.js`, `metro.config.js`
- `ios/` 和 `android/` 原生文件夹
- `app.json` / `app.config.*` / `eas.json` (如果是 Expo 项目)

## 代码库扫描 (React Native 特有)
- 源根目录: `src/`, `app/`
- 入口文件 (仅当存在时记录):
  `index.js`, `index.ts`, `App.tsx`
- 原生文件夹 (仅当存在时记录): `ios/`, `android/`
- 导航/状态 (仅当存在时记录):
  `react-navigation`, `redux`, `mobx`
- 原生模块模式 (仅当存在时记录):
  `NativeModules`, `TurboModule`

## 强制输出 (React Native 模块 CLAUDE.md)
如果检测到，请包含以下内容（列出实际找到的名称）：
- **屏幕/导航器**: 列出屏幕组件和导航器
- **组件**: 列出共享组件目录
- **服务/API**: 列出 API 客户端模块
- **状态管理**: 列出存储设置
- **原生模块**: 列出自定义原生模块
- **平台文件夹**: 提及 ios/ 和 android/ 设置

## 命令来源
- `package.json` 脚本
- README/文档或 CI
- `ios/` 和 `android/` 中的原生构建文件
- 文档/脚本中 `expo` 脚本的使用 (如果是 Expo 项目)
- 仅包含仓库中存在的命令

## 需要提及的关键路径 (仅当存在时)
- `ios/`, `android/`
- `src/`, `app/`
 FILE:references/react-web.md 
# React (Web)

## 检测信号
- `package.json`
- `src/`, `public/`
- `vite.config.*`, `next.config.*`, `webpack.config.*`
- `tsconfig.json`
- `turbo.json`
- `app/` 或 `pages/` (Next.js)

## 多模块信号
- `pnpm-workspace.yaml`, `lerna.json`, `nx.json`, `turbo.json`
- 带有 `workspaces` 的根 `package.json`
- `apps/` 和 `packages/` 各自包含 `package.json`

## 生成前，分析这些来源
- 根 `package.json` 和工作区配置 (`pnpm-workspace.yaml`, `lerna.json`,
  `nx.json`, `turbo.json`)
- `apps/*/package.json`, `packages/*/package.json` (如果是 monorepo)
- `vite.config.*`, `next.config.*`, `webpack.config.*`
- `tsconfig.json` / `jsconfig.json`

## 代码库扫描 (React web 特有)
- 源根目录: `src/`, `app/`, `pages/`, `components/`, `hooks/`, `services/`
- 文件夹模式 (仅当存在时记录):
  `routes`, `store`, `state`, `api`, `utils`, `assets`
- 路由标记 (仅当存在时记录):
  React Router (`Routes`, `Route`), Next (`app/`, `pages/`)
- 状态管理 (仅当存在时记录):
  `redux`, `zustand`, `recoil`
- 命名约定 (仅当存在时记录):
  hooks `use*`, components PascalCase

## 强制输出 (React web 模块 CLAUDE.md)
如果检测到，请包含以下内容 (列出实际找到的名称):
- **页面/路由**: 列出页面组件或路由文件
- **组件**: 列出共享组件目录
- **Hooks**: 列出自定义 hooks
- **服务/API**: 列出 API 客户端模块
- **状态管理**: 列出 store 设置 (Redux, Zustand 等)
- **工具**: 列出工具模块

## 命令来源
- `package.json` 脚本
- README/文档 或 CI
- 仅包含仓库中存在的命令

## 提及的关键路径（仅当存在时）
- `src/`, `public/`
- `app/`, `pages/`, `components/`
- `hooks/`, `services/`
- `apps/`, `packages/` (monorepos)
 FILE:references/ruby.md 
# Ruby / Rails

## 检测信号
- `Gemfile`, `Gemfile.lock`
- `Rakefile`
- `config.ru`
- `bin/rails` 或 `bin/rake`
- `config/application.rb`
- `config/routes.rb`

## 多模块信号
- 子目录中存在多个 `Gemfile` 或 `.gemspec` 文件
- `gems/`, `packages/`, 或 `engines/` 包含独立的 gem 规范
- `apps/` 下存在多个 Rails 应用（每个应用都有 `config/application.rb`）

## 生成前，分析这些来源
- `Gemfile`, `Gemfile.lock`, 以及任何 `.gemspec`
- `config/application.rb`, `config/routes.rb`
- `Rakefile` / `bin/rails` (如果存在)
- `engines/`, `gems/`, `apps/` (如果是多应用/引擎设置)

## 代码库扫描 (Ruby/Rails 特定)
- 源代码根目录: `app/`, `lib/`, `engines/`, `gems/`
- Rails 层 (仅当存在时记录):
  `app/models`, `app/controllers`, `app/views`, `app/jobs`, `app/services`
- 配置和初始化器 (仅当存在时记录):
  `config/routes.rb`, `config/application.rb`, `config/initializers/`
- ActiveRecord/迁移 (仅当存在时记录):
  `db/migrate`, `ActiveRecord::Base`
- 测试 (仅当存在时记录): `spec/`, `test/`

## 强制输出 (Ruby 模块 CLAUDE.md)
如果检测到，请包含以下内容（列出找到的实际名称）：
- **控制器**: 列出控制器类
- **模型**: 列出 ActiveRecord 模型
- **服务**: 列出服务对象
- **作业**: 列出后台作业类
- **路由**: 总结关键路由命名空间
- **迁移**: 提及 db/migrate 数量
- **引擎**: 列出已挂载的引擎（如果有）

## 命令来源
- README/文档或 CI 调用 `bundle`, `rails`, `rake`
- `Rakefile` 任务
- 文档/脚本中 `bundle exec` 的使用
- 仅包含仓库中存在的命令

## 需要提及的关键路径（仅当存在时）
- `app/`, `config/`, `db/`
- `app/controllers/`, `app/models/`, `app/views/`
- `spec/` 或 `test/`
 文件：references/rust.md
# Rust

## 检测信号
- `Cargo.toml`, `Cargo.lock`
- `rust-toolchain.toml`
- `src/main.rs`, `src/lib.rs`
- `Cargo.toml` 中的工作区成员, `crates/`

## 多模块信号
- `Cargo.toml` 中带有 `members` 的 `[workspace]`
- `crates/` 或 `apps/` 下的多个 `Cargo.toml`

## 生成前，分析这些来源
- 根目录 `Cargo.toml`, `Cargo.lock`
- `rust-toolchain.toml` (如果存在)
- `crates/` 或 `apps/` 中的工作区 `Cargo.toml`
- `src/main.rs` / `src/lib.rs`

## 代码库扫描 (Rust 特定)
- 源代码根目录: `src/`, `crates/`, `tests/`, `examples/`
- 模块布局 (仅当存在时记录):
  `lib.rs`, `main.rs`, `mod.rs`, `src/bin/*`
- Serde 使用 (仅当存在时记录):
  `#[derive(Serialize, Deserialize)]`
- 异步/运行时 (仅当存在时记录):
  `tokio`, `async-std`
- Web 框架 (仅当存在时记录):
  `axum`, `actix-web`, `warp`

## 强制输出 (Rust 模块 CLAUDE.md)
如果检测到，请包含这些内容（列出实际找到的名称）：
- **Crates**: 列出工作区 crate 及其用途
- **Binaries**: 列出 `src/bin/*` 或 `[[bin]]` 目标
- **Modules**: 列出顶级 `mod` 声明
- **Handlers/routes**: 列出 Web 处理程序模块 (如果是 Web 应用)
- **Models**: 列出领域模型模块
- **Config**: 列出配置加载模块

## 命令来源
- README/文档或 CI
- 调用 `cargo` 的仓库脚本
- 文档/脚本中 `cargo test`, `cargo run` 的使用
- 仅包含仓库中存在的命令

## 提及的关键路径（仅当存在时）
- `src/`, `crates/`
- `tests/`, `examples/`, `benches/`