技能介绍

要解决什么问题

在 Cocos Creator 项目里做功能设计或重构时，常见误区是先扫目录、再猜依赖，把「文件图谱」当成架构本身。模块之间的 import、预制体 UUID、动态调用链一旦变复杂，只靠肉眼很难判断删除某文件会不会断引用、职责是否堆在少数「上帝类」里。

CF-OOP-GEN 的定位是：主体是面向对象分析与落地设计，文件图谱只在已有代码时作为辅助验证，用来对照你设计出来的模块边界、调用关系是否合理。

技能如何工作

处理设计或开发任务时，按固定顺序推进：澄清需求边界与输入输出 → 从领域名词与行为识别候选对象 → 单一职责与关系（优先组合）→ 状态与生命周期 → 类/接口与依赖方向 → 用 SOLID 检查 → 仅在真实变化点选用设计模式 → 输出类结构、文件计划与验收标准。

思维资料按任务按需读取：references/oop.md、solid.md 以及创建型/结构型/行为型模式与测试、异常日志等章节，避免机械套模式。

当项目里确有代码时，再执行图谱相关能力：generate、scan 或 locate 会写入 /.cf/feature-graph.json 等产物，并在项目根目录生成 cf-map.html 供本地打开查看；可核对模块依赖、调用链、UUID 注册表与删除后的断裂点。高精度分析依赖 Node.js 与 TypeScript Compiler API；环境不可用时走内置回退，不能把未解析的调用表述为确定关系。

适用边界与注意点

用户只问「怎么用」「安装」「快速开始」时，应直答 usage-guide.md 对应平台章节，不进入 OOP 分析、不跑图谱、不改项目。
不得在没有代码项目时强制运行图谱；不得用图谱扫描替代对象建模。
环境（Windows、Python 3.10+、Node/TS API）缺失时不自动安装，先说明再由用户决定。
首次执行图谱命令可能自动启动后台 watch（可用 CF_OOP_GEN_NO_WATCH=1 关闭）；查看可视化请打开项目根目录的页面，而非 Skill 安装目录里的模板。