用途
该技能为 Umbraco 17+ 站点添加一个列表区块，成对引入列表页类型（articleListingPage）和它所列举的条目页类型（articlePage）。两者必须一起添加：只有列表页无法列举任何内容，只有条目页则无处存放。
主要能力
- 同时定义列表页与条目页，并在同一次变更中规定两者之间的允许子级关系。
- 为列表配置独立的集合视图，让编辑者以表格方式管理条目，包括列、排序、分页大小和布局。
- 每个页面单独调用一次 umbraco-add-page，从而各自获得模板并应用 SEO 组合；页面 schema 由 umbraco-add-document-type 以 page 角色决定。
- 按需求先行的方式工作：写下变更、等待用户批准、应用、再回读验证。
使用方式
流程分七步：检查首页、组合、主模板、已有列表与条目；确定这一对页面的名称、组合、字段、模板、父级与子级；确定集合视图的列、排序、分页与布局；编写并 lint（集合视图、两个模板、两个页面类型、父级更新、变更集）；停止并等待用户批准变更集；通过 MCP（如已连接）或手动步骤应用；最后回读全部内容、设置状态行并报告。已连接 MCP 时使用 MCP，否则按同一需求文档手动走查。
命名建议为 <noun>ListingPage 列举 <noun>Page。列表本身不承载条目数据：描述条目的字段（日期、摘要、作者）应放在条目或其组合上，列表只把它们显示为列。排序应依据条目自身持有的字段，通常按条目上的日期倒序，条目没有日期时可回退到创建日期。父级是已有类型，通过整体替换更新，这是变更中风险最高的一步。两个页面都必须应用 SEO 组合；若站点没有该组合，则把它纳入本次变更。
适用场景
适用于需要在 Umbraco 17+ 站点中新增博客、文章列表等“列表 + 条目”区块，并希望有明确需求文档、审批门槛和可验证结果的场景。
限制
该技能依赖 umbraco-content-model-conventions 与 umbraco-content-requirements-documentation 一并安装；若任一链接无法读取，应停止并说明。目标为 Umbraco 17+，集合视图基于 Umbraco 17.5.3 包中的 Umbraco.ListView 与 Umb.PropertyEditorUi.Collection。MCP 工具名称以实际连接的工具列表为准。技能本身不附带资产，唯一代码是未编译的 Razor 布局存根；需求文档由其配套文档中的 linter 检查，评估仅针对指导内容，未在真实站点上运行验证。