用途 该技能用于在 Umbraco 17+ 站点中新增一个文档类型的架构，明确它的名称、别名、在文档类型树中的文件夹位置、图标、描述、选项卡与字段、所采用的组合，以及是否随文化变化。它不生成模板，模板属于另一项技能（umbraco-add-page）。
主要能力
- 按角色决定文档类型的放置：页面位于文档类型根目录，其余类型放在 Compositions/、Data/ 或 Elements/ 下；普通类型不放在根目录。
- 依据约定规则（来自 umbraco-content-model-conventions）与需求文档格式、六步工作流（来自 umbraco-content-requirements-documentation）执行。
- 区分“页面”与“非页面”文档类型：如果访客会落到该内容上，则属于页面，交给 umbraco-add-page 处理，本技能只提供架构。
- 可被 umbraco-add-page、umbraco-add-listing-page、umbraco-add-data-folder、umbraco-add-site-settings 等技能调用，此时只确定架构行并撰写需求页面，由调用方合并变更集。
使用方式 流程分七步：1）检查现有类型、角色文件夹、组合、数据类型、语言；2）决定角色（页面、数据文件夹或条目、站点设置、独立普通类型）；3）确定细节（名称、别名、文件夹、图标、描述、选项卡、字段、组合、文化）；4）编写文档类型、所需数据类型与变更集，并运行 lint；5）停止等待用户批准变更集；6）通过 MCP 应用（如已连接），否则按需求文档手动操作；7）回读验证、设置状态行并报告。安装时需同时安装 umbraco-content-model-conventions 和 umbraco-content-requirements-documentation；若链接无法读取则应停止并说明。
适用场景 适用于为 Umbraco 17+ 站点规划或新增非页面的内容架构，例如数据文件夹、条目类型、站点设置类型等；也作为其他技能的前置步骤，为其提供页面或数据类型的架构定义。若需求实际上是页面，应转交 umbraco-add-page。
限制
- 不创建模板，不赋予类型模板。
- 非页面类型不添加 SEO 或分享字段，因为搜索引擎不会看到这些内容。
- 除首页、站点设置和数据文件夹外，其他内容不应放在根目录。
- 别名需手动输入，创建前应先确定名称与排序，以免后续重命名破坏模板、模型和查询。
- “直接创建”不等于批准尚未查看的需求文档，审批环节不可跳过。
- 目标版本为 Umbraco 17+；MCP 工具名称以实际连接的工具列表为准。
- 该技能不附带代码与资源；需求文档由相关技能的 linter 检查，评估基于指导内容，未对真实站点运行。