用途:本技能提供一套可运行的参考 Umbraco 站点与配套脚本,用于证明某个技能产出的代码确实能编译、运行,而非仅静态检查。它面向在 Umbraco 17+ 上编写或验证技能实现的开发者。
参考实例:Umbraco-CMS.Skills 是一个真实 Umbraco 17 Web 项目,目标框架 net10.0、Umbraco.Cms 17.5.3,首次启动无人值守安装到 SQLite(admin@example.com / 1234567890),自带 Clean 起始套件,提供真实的文档类型、模板与已发布页面,可供技能输出运行验证。\n\n主要用法:\n- 启动/停止:.claude/skills/umbraco-reference-instance/scripts/instance.sh boot|status|stop(boot 幂等,首次约需 4 分钟轮询)。\n- 环境变量:UMBRACO_URL、UMBRACO_USER_LOGIN、UMBRACO_USER_PASSWORD,脚本读取环境变量并回退默认值。\n- 内容探查:可用 Umbraco Developer MCP CLI(--call get-document-root、get-document-children、get-document-type-by-id)读取内容树与文档类型;只读模式 --umbraco-readonly 防改动。\n- 无需鉴权可用 Delivery API:curl -sk ".../umbraco/delivery/api/v2/content?fetch=children:/&take=100"。\n- API 用户:instance.sh api-user 会创建 .mcp.json 所期望的凭据(幂等)。\n- 确定性验证:dotnet build 与 dotnet test 两个测试主机(Clean 与 Blank),以及 python3 scripts/generate-examples.py --lint。\n- 手工探索:scripts/instance.sh try 后 boot、reset。\n\n限制与注意:运行库与构建输出被 gitignore,不得提交填充后的 SQLite、bin/、obj/ 等;不要直连 SQLite 内部表;编译错误常因 API 版本差异,需先清声明错误再判断;资产仅能证明实例所对版本一端。缺失信息暂未提供。