SuperAPI AI 工具集

godot-analyst

编程与开发

查看项目

更新于 10-16 10:38

技能介绍

用途

Godot Expert Analyst: Anara 是一个用于评估 Godot 4.7+ 项目架构质量的技能。它不以“能否运行”为判断标准,而是关注项目“能否在规模上良好运行”,用于对专业级项目进行认证,并给出架构提升蓝图。适用于评估项目健康度、现代化程度、可扩展性、依赖图,或生成 Visionary Certificate 的场景。

主要能力

该技能围绕四个加权评分维度展开:

  1. Modernity Index(现代化指数,权重 20%):评估是否使用 Godot 4.7 的现代 VM 优化,包括严格类型化的 Dictionary/Array、Signal.connect(callable) 模式、StringName 驻留、Godot 4.7 API 等;对旧式 connect("string", ...)、无类型集合、已移除的 RichTextLabel 属性等扣分。
  2. Scalability & Decoupling(可扩展性与解耦,权重 30%):评估场景能否被完全隔离测试,包括观察者模式(信号向上、导出向下)、依赖注入架构;对结构性硬编码(get_parent()、../)和逻辑直接修改 UI 节点扣分。
  3. Structural Cohesion(结构内聚,权重 20%):评估项目组织是否利于团队成长,包括 folder-by-feature、100% snake_case 合规;对路径大小写违规、单体式文件夹扣分。
  4. Rendering & Execution(渲染与执行,权重 30%):评估 GPU 负担,包括 MultiMesh 使用、通过 instance_shader_parameter 共享材质;对运行时 material.duplicate()、在 _process 中轮询复杂逻辑扣分。

此外还提供资产依赖分析(使用 ResourceLoader.get_dependencies 追踪文件互锁,识别高依赖场景与孤立节点内存泄漏)、项目结构验证(folder-by-feature 与架构漂移检测)、多行 RegEx 脚本审计、趋势追踪(通过 ConfigFile 持久化基线检测架构衰退)以及模块依赖图(识别热点节点与循环预加载)。

使用方式

该技能以 Anara 角色运行,交互流程为:

  1. Scan:请求项目路径,进行完整 DNS/DNA 映射。
  2. Sector:加载 atlas 及仅当前活跃的 Evolutionary Sector 分类文件。
  3. Evaluate:使用三个分析引擎辅助脚本与加权评分标准进行评估。
  4. Synthesize:提供高层架构评审(Visionary Review)。
  5. Certify:输出 Visionary Certificate(等级 + 分数 + 证据)。
  6. 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/ 中不存在的评分脚本;不得将“能运行”视为通过。具体安装命令、收费与价格信息暂未提供。