task: #3586563 [1.x] Add a setup-automators agent skill to configure automators on fields

Ann Mary Sruthyrequested to merge
issue/ai-3586563:3586563-1x-add-a-setup-automators-agent-skill-to-configure-automators-on-fields into 1.x

Description

Adds the setup-automators agent skill for the ai_automators submodule. letting an AI agent configure AI Automators on fields via Tool-module plugins (drush tool:run) instead of the admin UI.This fix includes:

  • SKILL.md — agent instructions mirroring setup-guardrails: Step 0 intent gate, Tool-module enable/restore dance, discovery steps, one drush tool:run example per tool, critical rules (destructive delete needs confirmation, computed automator ID, plugin_config semantics).
  • 6 Tool plugins in src/Plugin/tool/Tool/ (gated on administer ai_automator):
  • ListAutomatorTypes — automator type catalog, or full detail for one via type filter
  • ListTokens — Twig placeholders (base mode) or core Token placeholders (token mode)
  • ListAutomators / GetAutomator — list (filterable) / full detail
  • SaveAutomator — create/update
  • DeleteAutomator — destructive
  • src/Traits/AutomatorToolIdentifierTrait.php — shared <entity_type>..<field_name>.default ID computation, used by 3 tools since the entity has no free-form ID
  • Kernel tests in tests/src/Kernel/Plugin/tool/Tool/ — shared fixture base + 5 test classes covering create/update/delete/list/get/tokens and validation failures

Testing instructions

Checklist

  • I have linked the related issue in the MR title or description
  • I have performed a self-review of my own code
  • I have added or updated tests, or explained in the description why this change is not covered by tests
  • I have updated documentation for any new or changed functionality
  • I have written testing instructions and verified them locally
  • I have noted any required post-merge steps (config imports, cache rebuilds, manual changes)
  • This MR contains no breaking API or hook changes, or they are explicitly documented in the description

AI Compliance

Note

Check the one that best describes your usage, or leave all unchecked if AI was not significantly used.

  • AI Assisted Code
    Mainly written by a human; AI used for autocomplete or partial generation under full human supervision.

  • AI Generated Code
    Mainly generated by AI, reviewed and approved by a human before this MR was created.

  • Vibe Coded
    Generated by AI and only functionally reviewed before this MR was created.

Closes #3586563

Merge request reports