AgentSkillsCN

canvas-dev-humanify-recipe-update

更新

SKILL.md
--- frontmatter
name: canvas-dev-humanify-recipe-update
description: Update the
`recipes/canvas_dev_humanify` recipe by exporting `js_component` config and
default content, normalizing exported content/config files, and verifying
install.

Canvas Dev Humanify recipe update

Use this skill only when updating recipes/canvas_dev_humanify after content or js_component changes.

Scope

  • •Work in the project root (.).
  • •Primary targets:
    • •recipes/canvas_dev_humanify/config
    • •recipes/canvas_dev_humanify/content
  • •Use DDEV-wrapped commands only.

Workflow

  1. •Take a safety snapshot before destructive install checks.
  • •ddev snapshot
  1. •Export active config to a temporary directory and copy back only canvas.js_component.*.yml files used by Humanify.
  • •ddev drush cex --destination=../<tmp_dir> -y
  • •Copy canvas.js_component.*.yml from <tmp_dir> to recipes/canvas_dev_humanify/config/.
  1. •Export default content with references for the canvas_page entity included in recipes/canvas_dev_humanify.
  • •Get UUID from recipes/canvas_dev_humanify/content/canvas_page/*.yml.
  • •Resolve entity ID:
    • •ddev drush php:eval "\$e = \Drupal::service('entity.repository')->loadEntityByUuid('canvas_page', '<uuid>'); print \$e ? \$e->id() : '';"
  • •Export:
    • •ddev drush dcer canvas_page <id> --folder=../recipes/canvas_dev_humanify/content -y
  1. •Normalize exported canvas_page content to pass recipe import.
  • •File:
    • •recipes/canvas_dev_humanify/content/canvas_page/4fca895c-5da4-4fd5-86d1-c42788254bb6.yml
  • •Required cleanup:
    • •Convert root parent_uuid: '' to parent_uuid: null
    • •Convert root slot: '' to slot: null
    • •Remove empty label: '' rows
  1. •Remove unstable config metadata from js_component config entities in recipes/canvas_dev_humanify.
  • •Remove uuid: lines from all:
    • •recipes/canvas_dev_humanify/config/canvas.js_component*.yml
  • •Remove _core blocks (including default_config_hash) from the same files.
  1. •Run formatting fixes from the project root.
  • •npm run code:fix
  • •This runs Prettier.

Validation

Validate install flow:

  1. •ddev si
  2. •ddev drush st

If install fails:

  1. •Always rollback:
  • •ddev snapshot restore <snapshot_name>
  1. •Troubleshoot and fix the cause.
  2. •Retry install validation:
  • •ddev si
  • •ddev drush st

Troubleshooting notes

  • •ddev drush command names here are from this repo's current Drush setup:
    • •config:export (cex)
    • •default-content:export-references (dcer)
  • •ddev si may show non-fatal schema warnings for ai_agents_test views.
  • •If dcer fails due exporter/type compatibility errors, stop and escalate to a separate backend/PHP task instead of patching module PHP in this workflow.