用途
Umbraco Add Page 是面向 Umbraco 17+ 站点的实现技能,用于新增一个页面。这里的页面指“访问者被期望落地访问的文档类型”,而模板是使其成为页面的关键:任何节点都可以有 URL,但没有模板就不会被渲染为页面。
若用户只说“加一个页面”而未给更多信息,技能建议采用 minimum-viable-page.md 中的默认方案,而不是逐条追问。若无法确定访问者是否会落地访问某个对象(如办公室、作者、招聘条目),只问这一个问题:答案为是则留在本技能,为否则交给 umbraco-add-document-type。
主要能力
- 决定页面种类:根页面、内容页或编程式页面;列表页移交给其他技能处理(page-kinds.md)。
- 决定模板、父级与子级、SEO 规则;优先复用站点已有内容。
- 文档类型的模式由 umbraco-add-document-type 以 page 角色提供;区块、区块区域、SEO 组合或新数据类型由各自的同类技能提供。
- 将页面所需的所有部分写入一个变更集,页面按应用顺序编号,只做一次审批(combined-changeset.md)。
- 父级更新:新页面通过加入父级的允许子级而变得可创建,因此父级本身也是变更的一部分。
使用方式
技能遵循七步流程(workflow.md):
- 检查站点:主页、主模板、组合(优先 SEO)、区块区域、区块、数据类型、语言。
- 决定页面种类。
- 决定细节:优先复用;模式经 add-document-type;模板、父级、子级、SEO、区块。
- 编写并 lint:一个变更集包含页面所需的所有部分,页面按应用顺序编号。
- 审批:停止,对整个变更集做一次审批。
- 应用:叶子优先;连接 MCP 时通过 MCP,否则按同一需求文档手动走查。
- 验证:读回所有内容,设置状态行,说明剩余事项。
大多数页面是四个需求页面加五个清单项:页面模板、页面、父级更新和变更集,并使用站点已有的 SEO 组合。只有当页面需要站点缺少的 SEO 组合、新数据类型、区块或区块区域时,才需要打开 combined-changeset.md。
适用场景
- 需要为 Umbraco 17+ 站点新增一个可被访问者落地访问的页面,并同步处理其模板、SEO 组合与父级允许子级关系。
- 页面还需要站点当前没有的区块、区块区域或数据类型,希望这些内容与页面一起一次审批、按依赖顺序应用。
- 希望复用站点已有的组合与约定,而不是为页面重复定义字段。
限制与注意事项
- 目标版本为 Umbraco 17+;MCP 工具名称需按 umbraco-content-requirements-documentation 所述核对,已连接的工具列表才是权威。
- 必须同时安装 umbraco-content-model-conventions 与 umbraco-content-requirements-documentation(change-workflow.md),以及下列同类技能;若任一链接无法读取,应停止并说明。
- 除首页外,任何页面都不应放在根级;新页面通过加入父级的允许子级而创建,父级因此成为变更的一部分(allowed-children-and-root.md)。
- 每个页面都需要 SEO;站点若无 SEO 组合,第一个页面会一并引入。分享与页面详情组合保持可选。
- 页面主要由组合与行为构成,只给它组合未提供的字段;没有自有属性的页面是正常的(compositions.md)。
- 编辑父级是变更中风险最高的一步:它是已有内容类型的全量替换更新,需先读取、修改、写入,并在之后对比属性数量。
- 一个页面一次审批;页面所需的区块、区块区域或数据类型加入同一变更集一并审批,叶子优先,不得拆分为多次审批,也不得让同类技能为自己的部分停下等待审批。
- 对于含缩写的名称,别名应手动输入,不要使用 Umbraco 自动生成的别名(naming.md)。
- “直接创建它”是对页面的请求,而不是对用户尚未看到的需求文档的审批;审批关卡见 change-workflow.md。
- 本技能不附带资产;其唯一代码是 workflow.md 中两行 Razor 布局占位,属于不会被任何宿主编译的上下文。需求文档由 umbraco-content-requirements-documentation 中的 linter 检查;客观断言位于 evals/evals.json,可用 umbraco-skill-evaluator 运行。覆盖层级为 Documented;未对真实站点运行过。
暂未提供
资料未说明具体安装命令、收费方式、支持平台或实际效果数据。