SuperAPI AI 工具集

umbraco-add-page

编程与开发

查看项目

更新于 10-22 05:17

技能介绍

用途

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):

  1. 检查站点:主页、主模板、组合(优先 SEO)、区块区域、区块、数据类型、语言。
  2. 决定页面种类。
  3. 决定细节:优先复用;模式经 add-document-type;模板、父级、子级、SEO、区块。
  4. 编写并 lint:一个变更集包含页面所需的所有部分,页面按应用顺序编号。
  5. 审批:停止,对整个变更集做一次审批。
  6. 应用:叶子优先;连接 MCP 时通过 MCP,否则按同一需求文档手动走查。
  7. 验证:读回所有内容,设置状态行,说明剩余事项。

大多数页面是四个需求页面加五个清单项:页面模板、页面、父级更新和变更集,并使用站点已有的 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;未对真实站点运行过。

暂未提供

资料未说明具体安装命令、收费方式、支持平台或实际效果数据。