[docs][fix]: 统一通用框架分类并补录第三方插件到模块索引
- 通用框架分类由项目框架改为核心框架 - 模块索引补录第三方插件并校准各模块状态 - 项目规则入口声明核心规则完整定义 - 20/40 规则文档中重复 Git 规则改为链接引用 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
82
rules/70-AI工具扫描范围.md
Normal file
82
rules/70-AI工具扫描范围.md
Normal file
@@ -0,0 +1,82 @@
|
||||
# AI 工具扫描范围
|
||||
|
||||
> 本文件定义 AI 工具在正常分析项目时应跳过的目录和文件,以节省 token 并避免误读本地缓存/生成噪音。
|
||||
>
|
||||
> Codex 和 Claude Code 均遵循此规则。
|
||||
>
|
||||
> 返回主规则索引:[rules/项目规则入口.md](项目规则入口.md)
|
||||
|
||||
---
|
||||
|
||||
## 通用跳过模式
|
||||
|
||||
| 模式 | 原因 |
|
||||
|------|------|
|
||||
| `.git/` | Git 版本控制元数据 |
|
||||
| `.vs/` | Visual Studio 本地缓存 |
|
||||
| `obj/` | .NET 编译中间输出目录 |
|
||||
| `bin/` | .NET 编译输出目录 |
|
||||
| `node_modules/` | Node.js 依赖目录 |
|
||||
| `*.log` | 运行时日志 |
|
||||
| `*.tmp` / `*.temp` | 临时文件 |
|
||||
| `Thumbs.db` / `.DS_Store` | 系统缩略图/缓存 |
|
||||
|
||||
## Unity 项目跳过模式
|
||||
|
||||
由于 StrayFog 是 Unity 框架,若知识库关联 Unity 工程,AI 分析时还应跳过:
|
||||
|
||||
| 模式 | 原因 |
|
||||
|------|------|
|
||||
| `Library/` | Unity 本地缓存(资源导入、编译缓存、包缓存等),非项目源码 |
|
||||
| `Temp/` | Unity 运行时临时文件 |
|
||||
| `Logs/` | Unity 运行时日志 |
|
||||
| `UserSettings/` | Unity 用户本地偏好设置 |
|
||||
| `*.csproj` | 由 Unity 自动生成的项目文件 |
|
||||
| `*.sln` | 由 Unity 自动生成的解决方案文件 |
|
||||
| `Library/PackageCache/` | Unity Package Manager 缓存的第三方包源码 |
|
||||
| `HybridCLRData/` | HybridCLR 构建生成输出(DLL、桥接文件等) |
|
||||
|
||||
## AI 工具本地状态
|
||||
|
||||
| 模式 | 原因 |
|
||||
|------|------|
|
||||
| `.codex/` | Codex 本地 hooks 状态 |
|
||||
| `.claude/` | Claude Code 本地命令/技能状态(除 `config` 外) |
|
||||
|
||||
## 文档仓库跳过模式
|
||||
|
||||
本仓库本身以 Markdown 文档为主,以下文件通常无需 AI 全文读取:
|
||||
|
||||
| 模式 | 原因 |
|
||||
|------|------|
|
||||
| 图片、音频、视频等二进制资源 | 非文本内容 |
|
||||
| `.claude/` 中的本地 skill/hook 状态 | 工具私有状态 |
|
||||
| `__pycache__/` | Python 缓存 |
|
||||
|
||||
## 例外情况
|
||||
|
||||
当任务明确要求分析**构建问题**或**生成流程问题**时,可以按需读取以下目录中的特定文件:
|
||||
|
||||
- `HybridCLRData/` — 检查 HybridCLR 构建输出、DLL 生成结果或 AOT 桥接错误
|
||||
- `Library/PackageCache/` — 检查特定包的版本或源码(仅限调试包相关问题时)
|
||||
- `*.csproj` / `*.sln` — 检查项目引用或编译配置问题
|
||||
|
||||
> 例外读取后,应在分析结论中说明读取了哪些缓存/生成文件以及原因。
|
||||
|
||||
## 相关规则
|
||||
|
||||
- [rules/项目规则入口.md](项目规则入口.md) — 项目规则总索引
|
||||
- [00-项目概览.md](00-项目概览.md) — 项目概览与重要目录说明
|
||||
- [20-开发规则.md](20-开发规则.md) — 开发规则(含生成文件约束)
|
||||
|
||||
---
|
||||
|
||||
## 文档关联
|
||||
|
||||
> 当本文档发生变更时,应同步检查以下关联文档,避免信息不一致。
|
||||
|
||||
| 文档 | 关联原因 |
|
||||
|---|---|
|
||||
| [rules/项目规则入口.md](项目规则入口.md) | 项目设置是项目规则入口索引的关键规则 |
|
||||
| [rules/00-项目概览.md](00-项目概览.md) | 扫描范围中的目录说明与项目概览互相引用 |
|
||||
| [rules/20-开发规则.md](20-开发规则.md) | 生成文件约束、例外读取与扫描范围互相引用 |
|
||||
Reference in New Issue
Block a user