用途
Godot Expert Analyst: Anara 是一个用于评估 Godot 4.7+ 项目架构质量的技能。它不以“能否运行”为判断标准,而是关注项目“能否在规模上良好运行”,用于对专业级项目进行认证,并给出架构提升蓝图。适用于评估项目健康度、现代化程度、可扩展性、依赖图,或生成 Visionary Certificate 的场景。
主要能力
该技能围绕四个加权评分维度展开:
- Modernity Index(现代化指数,权重 20%):评估是否使用 Godot 4.7 的现代 VM 优化,包括严格类型化的 Dictionary/Array、Signal.connect(callable) 模式、StringName 驻留、Godot 4.7 API 等;对旧式 connect("string", ...)、无类型集合、已移除的 RichTextLabel 属性等扣分。
- Scalability & Decoupling(可扩展性与解耦,权重 30%):评估场景能否被完全隔离测试,包括观察者模式(信号向上、导出向下)、依赖注入架构;对结构性硬编码(get_parent()、../)和逻辑直接修改 UI 节点扣分。
- Structural Cohesion(结构内聚,权重 20%):评估项目组织是否利于团队成长,包括 folder-by-feature、100% snake_case 合规;对路径大小写违规、单体式文件夹扣分。
- Rendering & Execution(渲染与执行,权重 30%):评估 GPU 负担,包括 MultiMesh 使用、通过 instance_shader_parameter 共享材质;对运行时 material.duplicate()、在 _process 中轮询复杂逻辑扣分。
此外还提供资产依赖分析(使用 ResourceLoader.get_dependencies 追踪文件互锁,识别高依赖场景与孤立节点内存泄漏)、项目结构验证(folder-by-feature 与架构漂移检测)、多行 RegEx 脚本审计、趋势追踪(通过 ConfigFile 持久化基线检测架构衰退)以及模块依赖图(识别热点节点与循环预加载)。
使用方式
该技能以 Anara 角色运行,交互流程为:
- Scan:请求项目路径,进行完整 DNS/DNA 映射。
- Sector:加载 atlas 及仅当前活跃的 Evolutionary Sector 分类文件。
- Evaluate:使用三个分析引擎辅助脚本与加权评分标准进行评估。
- Synthesize:提供高层架构评审(Visionary Review)。
- Certify:输出 Visionary Certificate(等级 + 分数 + 证据)。
- Blueprint:提供三步重构计划以进入下一认证等级。
分析引擎包含三个辅助脚本:scoring_logic.gd(多行 RegEx / 复杂度辅助)、visionary_comparison.gd(通过 ConfigFile 基线持久化并比较历史分数)、marking_rubrics_atlas.gd(atlas/sector 导航辅助)。评分权重来自 Marking Rubrics Atlas 与活跃分类文件,而非不存在的 Python 评分脚本。
认证等级分为:VISIONARY: ELITE(90%+)、VISIONARY: ADVANCED(70-89%)、VISIONARY: STANDARD(50-69%)、LEGACY(< 50%)。
适用场景
适用于 Godot 4.7+ 项目的架构审计、项目健康度评估、现代化程度检查、可扩展性分析、依赖图分析、认证报告生成,以及为重构提供蓝图。也可与 godot-auditor、godot-debugging-profiling、godot-performance-optimization 等技能配合使用。
限制
该技能明确要求:不得在未加载活跃分类评分标准的情况下进行认证;不得手工解析 TSCN/tres 文件,应使用 ResourceLoader.get_dependencies;不得加载 references/categories/ 下的全部文件,仅按渐进式披露加载;不得虚构 scripts/ 中不存在的评分脚本;不得将“能运行”视为通过。具体安装命令、收费与价格信息暂未提供。