用途
本技能为 Umbraco 17+ 站点添加“不属于任何页面”的共享内容：在内容树根目录创建一个文件夹文档类型（如 authorFolder），以及它所承载的数据项类型（如 author）。页面随后通过选择器从文件夹中选取数据项，而不是在每个页面重复输入相同名称。
此处“文件夹”指承载内容节点的文档类型，而非设置树中的组织文件夹。文件夹和项类型的架构由 umbraco-add-document-type 决定（角色为 data folder 或 item）；本技能负责添加内容树行为和选择器。
依赖
规则来自 umbraco-content-model-conventions，需求文档格式和六步工作流来自 umbraco-content-requirements-documentation（change-workflow.md）；两者必须与本技能一同安装。若无法读取其中任一链接，应停止并说明。
工作流步骤
- 检查：现有数据文件夹和项、根目录允许的内容、Data/ 文件夹。
- 决策：文件夹与项名称、字段、嵌套、选择器及其使用者。
- 分类法：类别及类似受控列表——数据项还是标签。
- 编写与检查：文件夹、项、选择器数据类型、获得选择器的类型、变更集。
- 批准：暂停，由用户批准变更集。
- 应用：若已连接 MCP 则通过 MCP，否则手动走查。
- 验证：回读全部内容，设置状态行并报告。
MCP 与手动方式
已连接 MCP 时使用 MCP，否则依据同一需求文档进行手动走查；详见 change-workflow.md。
版本兼容性
面向 Umbraco 17+。选择器使用 Umbraco.MultiNodeTreePicker，编辑器 UI 为 Umb.PropertyEditorUi.ContentPicker，依据 Umbraco 17.5.3 包读取。MCP 工具名称的核对方式见 umbraco-content-requirements-documentation；已连接的工具列表是权威依据。
最佳实践
- 共享数据集中存放：多个页面引用的作者、办公地点或类别应是数据文件夹中的内容节点，而非首页上的一组编号字段，也不是每页 Textstring 中重复输入的名称。
- 数据不是页面：文件夹和项没有模板，也没有 SEO 或分享组合。它们位于文档类型树的 Data/ 中，并在内容根目录中与首页并列、排在首页之后；详见 allowed-children-and-root.md。
- 受控列表是内容而非标签：站点用于筛选或分组的类别、主题和地区是可按 id 选取的数据项；自由标签用于编辑自行发明的关键词。选择依据见 taxonomy.md。
- 选择而非重输：页面通过限定到该文件夹和项类型的选择器引用数据项，因此重命名作者会在所有位置生效。
- 每种用途一个选择器数据类型：“选择一个作者”和“最多选择三个类别”是不同配置，各自是独立的数据类型。
- “只需添加类别”是对变更的请求，而不是对用户尚未看到的需求文档的批准；审批关卡见 change-workflow.md。
验证
客观断言位于 evals/evals.json，使用 umbraco-skill-evaluator 运行。覆盖层级：Documented。本技能不附带代码和资产。它编写的需求文档由 umbraco-content-requirements-documentation 中的 linter 检查，且有评估对指导内容评分。未针对实时站点运行。