用途
本技能为 Umbraco 17+ 站点添加站点级设置单例:在内容树根级创建一个 siteSettings 节点,集中存放属于全站的内容(Logo、导航、页脚、社交链接、默认分享图片、跟踪代码)。它明确不是首页;其 schema 由 umbraco-add-document-type 以 site settings 角色决定,本技能负责添加选项卡、根级行为和内容节点。
依赖与前置
规则来自 umbraco-content-model-conventions,需求文档格式与六步工作流来自 umbraco-content-requirements-documentation,两者必须与本技能一同安装。如果指向其中任一技能的任何链接无法读取,应停止并说明。
使用方式(步骤)
- 检查:现有设置(在首页或其他节点)、根类型、语言,参考 workflow.md。
- 决定选项卡:哪些选项卡、顺序如何,0 到 9,参考 tab-layout.md。
- 决定字段:别名、数据类型、重复器,参考 workflow.md。
- 编写与检查:设置类型、所需数据类型与重复器、变更集,参考 workflow.md。
- 批准:停止,由用户批准变更集,参考 workflow.md。
- 应用:若已连接则通过 MCP,否则按手动步骤执行,参考 workflow.md。
- 验证:回读全部内容,设置状态行并报告,参考 workflow.md。
MCP 与手动的选择
同一方法、两种机制:连接了 Umbraco Developer MCP 时使用它,否则根据同一份需求文档生成手动操作步骤;见 change-workflow.md。
最佳实践
设置不放在首页,规则见 allowed-children-and-root.md,该规则有意覆盖旧建议(把设置放在根页面)。
一个类型、每个站点一个节点。第二个站点获得第二个 siteSettings 内容节点,绝不创建 micrositeSettings 类型;代码如何找到正确节点需与开发者商定。
首页保持在内容根级的第一位。排在它上面的设置节点会改变所有 URL;见根顺序,并在用户创建节点后检查位置。
选项卡独立,编号 0 到 9,无模板、子节点或组合;规则见 tabs-groups-sorts.md 和 templates.md,布局见 tab-layout.md。
把设置从首页移走会丢失其值,除非进行迁移。应停止并说明;绝不要删除首页字段来腾出位置。
“只加一个设置节点”不构成批准,它只是变更请求;应停在批准关口。
验证
客观断言位于 evals/evals.json,可用 umbraco-skill-evaluator 运行。覆盖层级:Documented。本技能不附带代码和资源。它编写的需求文档由 umbraco-content-requirements-documentation 中的 linter 检查,且有一项评估对该指南进行了评分。未在真实站点上运行过。
限制
目标为 Umbraco 17+。MCP 工具名称的核对方式见 umbraco-content-requirements-documentation;已连接的工具列表是权威依据。未提供收费、价格等信息。