lms
fc23b75e95
- 通用框架分类由项目框架改为核心框架 - 模块索引补录第三方插件并校准各模块状态 - 项目规则入口声明核心规则完整定义 - 20/40 规则文档中重复 Git 规则改为链接引用 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
3.0 KiB
3.0 KiB
AI 工具扫描范围
本文件定义 AI 工具在正常分析项目时应跳过的目录和文件，以节省 token 并避免误读本地缓存/生成噪音。
Codex 和 Claude Code 均遵循此规则。
返回主规则索引：rules/项目规则入口.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 — 项目规则总索引
- 00-项目概览.md — 项目概览与重要目录说明
- 20-开发规则.md — 开发规则（含生成文件约束）
文档关联
当本文档发生变更时，应同步检查以下关联文档，避免信息不一致。
| 文档 | 关联原因 |
|---|---|
| rules/项目规则入口.md | 项目设置是项目规则入口索引的关键规则 |
| rules/00-项目概览.md | 扫描范围中的目录说明与项目概览互相引用 |
| rules/20-开发规则.md | 生成文件约束、例外读取与扫描范围互相引用 |