NLDClient-yudde/.cursor/skills/knowledge-base/SKILL.md

92 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

---
name: knowledge-base
description: 项目知识库索引。查阅功能说明、性能优化记录、开发日志时使用。触发关键词:武器熟练度 WeaponDegree、ShowAreaId 显示区域、攻击换弹 canAttackNoReloadFull、暂停技能释放、载具科技树、PerformanceManager 性能参数 性能优化、GC 分配 内存优化 Buff性能、密钥泄露 secret exposure、资源检查 FileChecker batch runner。涵盖 AI_Gen_Doc 和 AI_CODE 中的所有文档。
version: "1.0"
updated: "2026-05-08"
---
# 项目知识库
提供对项目 AI 生成文档和开发记录的索引和查阅能力。
## 关键词 → 文档速查
当用户提到以下关键词时,自动定位到对应文档:
| 关键词 | 文档路径 |
|--------|----------|
| 武器熟练度, WeaponDegree | `AI_Gen_Doc/武器熟练度功能说明.md` |
| ShowAreaId, 显示区域 | `AI_Gen_Doc/ShowAreaId相关逻辑说明.md` |
| 攻击换弹, canAttackNoReloadFull, 不换弹 | `AI_Gen_Doc/canAttackNoReloadFull功能说明.md` |
| 暂停技能, 暂停释放, pause skill | `AI_Gen_Doc/暂停状态下技能释放流程说明.md` |
| 载具科技树, vehicle tech tree | `AI_Gen_Doc/载具科技树生成功能说明.md` |
| 性能参数, PerformanceManager, 动态性能 | `AI_Gen_Doc/PerformanceManager动态性能参数接入指南.md` |
| 性能优化, GC, 内存, Buff性能, 优化清单 | `AI_Gen_Doc/性能优化任务清单.md` + `AI_Gen_Doc/Finish/` |
| 密钥泄露, secret, exposure, 安全扫描 | `AI_Gen_Doc/package_secret_exposure_report.md` |
| 资源检查, FileChecker, batch runner | `AI_CODE/batch_resource_checker_*.md` |
## 知识库目录
### AI_Gen_Doc/ — 功能说明与任务清单
| 文档 | 用途 |
|------|------|
| `武器熟练度功能说明.md` | WeaponDegree 属性设计与配置说明 |
| `ShowAreaId相关逻辑说明.md` | 显示区域 ID 的逻辑说明 |
| `canAttackNoReloadFull功能说明.md` | 攻击时不自动换弹的功能说明 |
| `暂停状态下技能释放流程说明.md` | 暂停状态下技能释放的处理流程 |
| `载具科技树生成功能说明.md` | 载具科技树的生成逻辑 |
| `PerformanceManager动态性能参数接入指南.md` | 动态性能参数配置指南 |
| `性能优化任务清单.md` | 按独立单元组织的性能优化任务P0/P1 优先级) |
| `package_secret_exposure_report.md` | 包体密钥泄露扫描报告 |
**`Finish/` 子目录**(已完成任务详情):
| 文件 | 任务 |
|------|------|
| `P0-01_GetBuffsByType复用List.md` | Buff 系统 — GetBuffsByType 复用 List |
| `P0-02_RemoveBuffById去除lambda.md` | Buff 系统 — RemoveBuffById 去除 lambda 分配 |
| `P0-03_needRemoveList改用HashSet.md` | Buff 系统 — _needRemoveList 改用 HashSet |
| `P0-04_totalBuffList_Contains改用HashSet.md` | Buff 系统 — totalBuffList.Contains 改用 HashSet |
| `P0-06_BuffAddSearchValue去除KeysToList.md` | Buff 系统 — BuffAddSearchValue 去除 KeysToList |
| `P0-07_UpdateBatchGroup复用List.md` | Buff 系统 — UpdateBatchGroup 复用 List |
| `P0-11_DamageRecordor去除ToArray.md` | 伤害记录 — DamageRecordor 去除 ToArray |
### AI_CODE/ — 开发日志与改进记录
| 文档 | 用途 |
|------|------|
| `batch_resource_checker_debug_journal.md` | 批量资源检测工具问题定位全程记录 |
| `batch_resource_checker_improvement_summary.md` | 批量资源检测工具改进总结 |
## 使用方式
### 查阅功能说明
当需要了解某个游戏功能的设计和实现时:
1. 先阅读对应功能说明文档了解设计意图
2. 再根据文档中的文件引用定位源码
3. 结合源码和文档进行修改
### 查阅性能优化记录
当进行性能相关工作时:
1. 阅读 `性能优化任务清单.md` 了解已完成和待完成的任务
2. 查看 `Finish/` 目录中的已完成任务了解优化模式和收益
3. 参考已完成任务的模式执行新优化
### 查阅开发日志
当遇到类似问题或需要了解工具链时:
1. 阅读 `AI_CODE/` 中的调试日志了解问题排查思路
2. 阅读改进总结了解工具链演进
## 安全规则
- 查询前先用 `file_search` 确认目标文档是否存在,若不存在则搜索相似文件名并告知用户
- 只读查阅,不要修改已归档的文档(除非用户要求更新)
- 性能优化任务执行前必须评估风险(跨类修改、生命周期影响等)
- 有风险的任务标记为跳过,等用户确认后再执行