用途:Umbraco Skill Code Analyzer 是一个静态分析工具,用于验证 SKILL.md 文件中的代码示例是否正确,主要面向 Umbraco CMS 后台(Backoffice)相关技能文档的维护者。
主要能力:检查 @umbraco-cms/backoffice/* 导入路径是否属于已知模块;校验 type: 值是否为已知的 Umbraco 扩展类型;标记过时的代码写法;可选执行 TypeScript 语法与类型检查。问题类型包括 invalid-import、unknown-extension-type、deprecated-pattern(均为 warning)以及 typescript-error(error)。
使用方式:进入 .claude/skills/umbraco-skill-code-analyzer/scripts 目录,执行 npm install --silent,然后运行 npx tsx analyze-code.ts。可通过环境变量 CHECK_TYPESCRIPT 控制是否进行 TypeScript 编译,默认 true,设为 false 可跳过。
输出:在项目根目录生成 code-analysis-report.json,包含时间戳、扫描的技能数、分析的代码块数、发现的问题数,以及按技能分组的问题明细和统计信息(如总代码块数、TypeScript 代码块数、导入问题数、扩展类型问题数、编译错误数、过时写法数)。
更新已知值:脚本维护已知模块与扩展类型列表,需编辑 analyze-code.ts,向 KNOWN_BACKOFFICE_MODULES 集合和 KNOWN_EXTENSION_TYPES 集合中添加条目。
限制:资料未提供支持的 Umbraco 版本范围、运行环境要求、性能数据及许可信息。