Free AI

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
  # Claude Code 项目规范

  ## 语义化代码导航 (Semantic Navigation)

  项目已连接 LSP-MCP 服务器 (127.0.0.1:9527)。在处理 C# 代码时，必须优先使用语义工具，禁止仅依赖文本搜索。

  ### 1. 查找与定位逻辑 (Finding Code)

    - **查找类/方法/变量的定义**：严禁使用 `glob` 或 `grep` 查找符号位置。必须直接调用 `get_definition`。
    - **理解代码含义**：在修改不熟悉的符号前，先调用 `get_hover` 获取该符号的完整类型信息和文档注释（尤其在处理 ET 框架的复杂泛型时）。
    - **处理编译错误**：若修改后出现编译问题，优先使用 `get_completions` 获取补全建议，辅助修复语法错误。

  ### 2. 影响分析逻辑 (Impact Analysis)

    - **重构与修改前**：在修改任何 `Component`、`System` 或公共接口前，必须执行 `get_references`。
    - **评估范围**：根据 `get_references` 返回的列表，评估修改对项目其他模块的影响，确保不会破坏 ET 框架的事件分发或组件生命周期。

  ### 3. 全局重命名 (Refactoring)

    - **跨文件更名**：严禁手动在多个文件中使用 `sed` 或 `edit_file` 替换名称。必须使用 `rename_symbol` 以确保所有语义引用（包括注释和不同文件中的引用）同步更新。

  ### 4. 故障退避机制 (Fallback)

    - 只有在以下情况方可使用 `ls` / `grep` / `glob`：
      - 查找非 C# 符号的字符串内容（如 Log 文本、JSON 键名）。
      - `lsp-mcp` 返回“未找到定义”或服务器连接异常时。
      - 需要模糊匹配文件名而非代码符号时。

  ## 开发工作流示例 (SOP)

  当你被要求“修改 UIModule 的初始化逻辑”时：

  1. **第一步**：调用 `get_definition` 定位 `UIModule` 类及其初始化方法。
  2. **第二步**：调用 `get_hover` 确认参数类型。
  3. **第三步**：调用 `get_references` 查看哪些 System 正在调用此初始化。
  4. **第四步**：执行修改。

  ## 缩进与格式要求 (Indentation & Formatting)

  本项目严格使用 **空格 (Spaces)** 缩进，禁止使用 Tab。

  1. **缩进标准**：全文使用 **4 个空格** 缩进。
  2. **编辑准则**：在执行 `edit_file` 操作前，必须先通过 `read_file` 确认目标代码块的精确缩进级别。
  3. **匹配要求**：生成的 `oldText` 必须与磁盘文件的空格数量完全一致。如果无法确定空格数量，请使用 `grep` 或查看该行前后的空格分布。
  4. **禁止混用**：严禁在一次编辑中引入任何 Tab 字符或不一致的空格缩进。

  ## 处理 C# 转义字符串 (Escaped Strings)

  当修改包含 `\n` 或 `$"{...}"` 的 C# 代码时，经常会发生编辑冲突。请执行以下规避策略：

  1. **编辑策略**：如果一行代码包含 `\n`，在 `edit_file` 时尽量不要把 `\n` 放在匹配字符串的边界，或者尝试仅替换该行中不含转义符的部分。
  2. **重构优先**：如果编辑失败，请尝试将该行重写。例如：
    - 原始：`string.Format($"\nError: {msg}")`
    - 改为：`$"{System.Environment.NewLine}Error: {msg}"` 或使用拼接。
  3. **匹配验证**：在定位 `oldText` 时，如果包含反斜杠，必须意识到 JSON 传输层可能导致的转义失效。如果匹配不到，请尝试使用 `grep` 先确认磁盘上的精确字节。