用途：该技能面向 Drupal Canvas 中的 Twig 版单目录组件（SDC），在创建、修改或排查组件时使用。Canvas 是 Drupal 的 React 可视化页面构建器，Canvas 1.0 于 2025 年 12 月发布，依赖 SDC；Drupal CMS 2.0（2026 年 1 月）起将其作为默认页面构建器。适用于组件注册、Canvas 编辑器预览问题，以及 prop 变更后旧实例更新的场景。Code Components（React/JSX）和 Canvas 编辑器通用用法应改用 drupal-canvas/skills。
安装：composer require 'drupal/canvas:^1.0' 与 drush en canvas -y，要求 Drupal ^11.2。
主要能力：组件放在主题或模块的 components/ 目录下，Drupal 扫描含 .component.yml 的目录。组件 ID 形如 {provider}:{component-name}，管理界面在 Appearance > Components。每个 SDC 必须包含同名的 .component.yml 与 .twig，CSS/JS 同名自动附加；文件名用 kebab-case，模板扩展名为 .twig（不是 .html.twig）。component.yml 定义 props、slots、libraryOverrides 等；每个 prop 和 slot 需有 title，必填 prop 需有能通过校验的 examples，否则组件在 Canvas 中被禁用。
使用方式：创建或修改组件文件后执行 ddev drush cr 清缓存，并在 /admin/appearance/component/status 确认启用。新组件需在同一变更中导出自动创建的 canvas.component.sdc.<extension>.<name> 配置对象；变更 props 需迁移旧实例到新 active_version 并重新导出配置。Twig 中须用 |default() 提供默认值，schema 默认值仅作文档。组件 CSS 不要按路由或路径 body 类限定作用域。
限制：Canvas 未提供实例迁移的 Drush 命令；内容模板暂无节点级就地编辑器（Canvas 1.7.1 至 1.9.0，2026 年 8 月核查）。