Back to Details

ghl-auto-implementer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

GHL Auto-Implementer

GHL 自动实施工具

Esta skill recibe una URL o IDs de ClickUp con tareas de implementación de GoHighLevel y ejecuta las operaciones automatizables vía API/MCP. Las que no son automatizables (workflows, pipelines write con PIT, funnels, templates de Meta, etc.) las deja flaggeadas como manuales con instrucciones claras.
Inversión respecto a 
ghl-task-builder
:
  • ghl-task-builder
    → genera tareas para que un humano las implemente
  • ghl-auto-implementer
    → toma las tareas y las implementa Claude
此技能接收包含GoHighLevel实施任务的ClickUp URL或ID，通过API/MCP执行可自动化的操作。对于无法自动化的任务（如workflows、使用PIT编写的pipelines、funnels、Meta模板等），会将其标记为手动任务并附上清晰的操作说明。
与
ghl-task-builder
的分工：
  • ghl-task-builder
    → 生成任务供人工实施
  • ghl-auto-implementer
    → 接收任务并由Claude执行

⚠️ Lectura obligatoria al arrancar

⚠️ 启动必读

Antes de ejecutar cualquier operación, leer:
  • ~/.claude/skills/ghl-task-builder/references/ghl-api-capabilities.md
    — qué se puede ejecutar y qué no
  • references/parsing-guide.md
    — cómo extraer la operación de cada subtarea
  • references/execution-protocol.md
    — orden, idempotencia, manejo de errores, write-back
Si el manifesto de capabilities no está accesible, parar y avisar al usuario.
执行任何操作前，请阅读：
  • ~/.claude/skills/ghl-task-builder/references/ghl-api-capabilities.md
    — 可执行与不可执行的操作说明
  • references/parsing-guide.md
    — 如何从每个子任务中提取操作内容
  • references/execution-protocol.md
    — 执行顺序、幂等性、错误处理、回写规则
如果能力清单无法访问，请停止操作并告知用户。

Cuándo activarse

触发时机

Triggers explícitos:
  • "ejecutá las tareas de [URL]"
  • "implementá esto en GHL: [URL]"
  • "auto-ejecutá [list ID]"
  • "corré la lista de ClickUp"
  • "/ghl-execute"
Intent detection:
  • Usuario pasa una URL de ClickUp + verbo de ejecución
  • Usuario menciona una lista que ya tiene tareas generadas y quiere "que se hagan"
No activar:
  • Si el usuario está GENERANDO tareas (eso es 
    ghl-task-builder
    )
  • Si la URL es de otro tool (no ClickUp)
  • Si el ClickUp aún no tiene subtareas con estructura 
    ## Acción en GHL
显式触发词：
  • "执行[URL]中的任务"
  • "在GHL中实施此内容：[URL]"
  • "自动执行[列表ID]"
  • "运行ClickUp列表"
  • "/ghl-execute"
意图识别：
  • 用户发送ClickUp URL + 执行类动词
  • 用户提及已生成任务的列表并要求"执行这些任务"
不触发的情况：
  • 用户正在生成任务（这是
    ghl-task-builder
    的功能）
  • URL来自其他工具（非ClickUp）
  • ClickUp中尚未包含带有
    ## Acción en GHL
    结构的子任务

Flujo de trabajo

工作流程

Paso 1 — Parsear input

步骤1 — 解析输入

Detectar de la entrada del usuario:
TipoPatrón URLResolver con
Lista
/v/l/li/<list_id>
leer todas las tareas de la lista
Lista
/list/<list_id>
idem
Tarea
/t/<task_id>
leer la tarea + sus subtareas
Si el usuario pasa solo un ID numérico, asumir lista. Si dice "tarea X" o pasa un slug tipo 
86ah5jrca
, asumir tarea.
从用户输入中识别：
类型URL模式处理方式
列表
/v/l/li/<list_id>
读取列表中的所有任务
列表
/list/<list_id>
同上
任务
/t/<task_id>
读取任务及其子任务
如果用户仅提供数字ID，默认视为列表ID。如果用户提及"任务X"或提供类似
86ah5jrca
的标识符，默认视为任务ID。

Paso 2 — Leer las tareas con ClickUp MCP

步骤2 — 通过ClickUp MCP读取任务

Para una lista completa:
clickup_filter_tasks(list_id, include_subtasks=true)
Si la lista tiene >50 tareas, paginar.
Para una tarea con subtareas:
clickup_get_task(task_id, include_subtasks=true)
Capturar para cada subtarea:
  • id
    , 
    name
    , 
    markdown_description
    o 
    description
    , 
    status
对于完整列表：
clickup_filter_tasks(list_id, include_subtasks=true)
如果列表包含超过50个任务，需分页读取。
对于包含子任务的单个任务：
clickup_get_task(task_id, include_subtasks=true)
为每个子任务捕获以下信息：
  • id
    , 
    name
    , 
    markdown_description
    或
    description
    , 
    status

Paso 3 — Clasificar cada subtarea

步骤3 — 分类每个子任务

Por cada subtarea, leer la descripción y clasificar en uno de estos modos:
Marca / patrón en la descripciónModoAcción
✅ Ejecutado vía API
o 
✅ Hecho
(en el header)		YA HECHOSkip — ya se ejecutó antes
✅ API
/ 
Modo: ✅ Automatizable
/ 
🔧 SETUP
con operación API listada		EXECUTABLEMapear a operación + ejecutar
⚠️ MANUAL
/ 
MANUAL builder
/ 
no automatizable vía API
MANUALSkip + listar en reporte
⚠️ DEPENDENCIA
(externo, ej: Meta)		EXTERNALSkip + listar en reporte
Sin marca claraUNKNOWNPreguntar al usuario o skip
Detalles de parsing en 
references/parsing-guide.md
.
针对每个子任务，读取其描述并归类为以下模式之一：
描述中的标记/模式模式类型操作
标题中包含
✅ Ejecutado vía API
或
✅ Hecho
已完成跳过——此前已执行
包含
✅ API
/ 
Modo: ✅ Automatizable
/ 
🔧 SETUP
且列出了API操作		可执行映射到对应操作并执行
包含
⚠️ MANUAL
/ 
MANUAL builder
/ 
no automatizable vía API
手动跳过并在报告中列出
包含
⚠️ DEPENDENCIA
（外部依赖，如Meta）		外部依赖跳过并在报告中列出
无明确标记未知询问用户或跳过
解析细节请参考
references/parsing-guide.md
。

Paso 4 — Construir el plan de ejecución

步骤4 — 构建执行计划

Resumir y mostrar al usuario antes de ejecutar:
📋 Plan de ejecución para [Nombre lista o tarea padre]

Total subtareas leídas: N
✅ Ya hechas (skip): X
⚙️ A ejecutar vía API: Y
⚠️ Manuales (skip + reportar): Z
❓ Sin clasificar: W

Operaciones a ejecutar:
  1. Crear calendario "Cliente Testeo - Citas" → POST /calendars/
  2. Crear contacto "Test Lead" → POST /contacts/
  3. ...

¿Confirmás? [sí/ajustar/cancelar]
Default: confirmación por batch, no por tarea. Si hay >10 ejecutables o si hay alguna destructiva, pedir confirmación más explícita.
在执行前向用户汇总并展示：
📋 [列表或父任务名称]的执行计划

读取到的子任务总数：N
✅ 已完成（跳过）：X
⚙️ 将通过API执行：Y
⚠️ 手动任务（跳过并报告）：Z
❓ 未分类：W

待执行操作：
  1. 创建日历"Cliente Testeo - Citas" → POST /calendars/
  2. 创建联系人"Test Lead" → POST /contacts/
  3. ...

是否确认？[是/调整/取消]
默认规则： 按批次确认，而非逐个任务确认。如果可执行任务超过10个或包含破坏性操作，需更明确的确认请求。

Paso 5 — Ejecutar en orden de dependencia

步骤5 — 按依赖顺序执行

Orden recomendado (
references/execution-protocol.md
):
  1. Setup base: custom fields, tags
  2. Recursos estructurales: calendarios, snapshots
  3. Datos de operación: contactos, oportunidades, conversaciones, mensajes
  4. Vinculaciones: add tags a contactos, mover oportunidades, etc.
Por cada operación:
  1. Idempotencia: verificar si ya existe el recurso (por nombre / email / etc.) — si existe, no duplicar
  2. Llamar al MCP (preferido) o REST como fallback
  3. Capturar el resultado: ID, URL, datos
  4. Actualizar ClickUp: 
    • clickup_update_task
      → status 
      complete
      , prepend 
      ✅ Ejecutado vía API
      al description con IDs
    • clickup_create_task_comment
      → comment con detalles técnicos (ID, response, traceId)
Si una operación falla:
  • Capturar el error exacto
  • Marcar la subtarea con 
    ❌ ERROR
    + detalles del error
  • No detener la ejecución del resto, salvo que el usuario haya pedido stop-on-error
  • Listar en el reporte final
推荐执行顺序（参考
references/execution-protocol.md
）：
  1. 基础设置： 自定义字段、标签
  2. 结构性资源： 日历、快照
  3. 运营数据： 联系人、商机、对话、消息
  4. 关联操作： 为联系人添加标签、移动商机等
针对每个操作：
  1. 幂等性检查： 验证资源是否已存在（通过名称/邮箱等）——若已存在，不重复创建
  2. 调用MCP（优先选择）或REST作为备选方案
  3. 捕获结果： ID、URL、数据
  4. 更新ClickUp： 
    • clickup_update_task
      → 将状态设为
      complete
      ，在描述开头添加
      ✅ Ejecutado vía API
      及相关ID
    • clickup_create_task_comment
      → 添加包含技术细节（ID、响应、traceId）的评论
如果某一操作失败：
  • 捕获具体错误信息
  • 为子任务标记
    ❌ ERROR
    + 错误详情
  • 除非用户要求出错即停，否则不中断其余操作
  • 在最终报告中列出

Paso 6 — Write-back y reporte final

步骤6 — 回写与最终报告

Al terminar:
  1. Comment en la tarea padre (si existe) con resumen ejecutivo:
    📊 Auto-Implementer report — [timestamp]
✅ Ejecutadas: 3 (calendar, contact, opportunity)
⚠️ Manuales: 7 (links a subtareas)
❌ Errores: 1 (subtarea X — razón)

Próximos pasos para el implementador humano: ...
  2. Resumen al usuario en la conversación:
    • Cuántas se ejecutaron, cuántas quedaron manuales, cuántas fallaron
    • Para cada fallo: razón breve + cómo resolverlo
    • Para cada manual: link directo a la subtarea
    • Si se aprende algo nuevo (ej: nueva limitación de API): proponer actualizar 
      ghl-api-capabilities.md
执行完成后：
  1. 在父任务中添加评论（如果存在），包含执行摘要：
    📊 自动实施工具报告 — [时间戳]
✅ 已执行：3项（日历、联系人、商机）
⚠️ 手动任务：7项（子任务链接）
❌ 错误：1项（子任务X — 原因）

人工实施者后续步骤：...
  2. 在对话中向用户展示摘要：
    • 已执行、剩余手动、失败的任务数量
    • 每项失败任务的简要原因及解决建议
    • 每项手动任务的直接子任务链接
    • 如果发现新情况（如API新限制）：建议更新
      ghl-api-capabilities.md

Reglas de seguridad

安全规则

  1. Nunca ejecutar sin confirmación explícita. El plan se muestra primero, el usuario confirma, después se ejecuta.
  2. Operaciones destructivas (DELETE) requieren confirmación adicional. No basta con "sí" al plan general — pedir un segundo "confirmá la eliminación de X".
  3. No ejecutar tareas marcadas 
    ⚠️ MANUAL
    .     Aunque parezca que se "podría" — la marca está por una razón documentada en el manifesto.
  4. Idempotencia obligatoria. Antes de crear, leer si existe. Si existe, ofrecer: (A) actualizar, (B) crear duplicado, (C) skip.
  5. Si el manifesto dice ❌, parar. No probar a "ver qué pasa". Las ❌ del manifesto son verificadas empíricamente.
  6. Auditabilidad. Toda ejecución queda escrita en ClickUp como comment + status update — el usuario puede auditar después.
  1. 无明确确认绝不执行。先展示执行计划，用户确认后再执行。
  2. 破坏性操作（DELETE）需额外确认。仅确认整体计划不足够——需单独请求“确认删除X”。
  3. 绝不执行标记为
    ⚠️ MANUAL
    的任务    。即使看似可以自动化，该标记的存在是因为能力清单中有明确说明。
  4. 必须保证幂等性。创建前先检查是否已存在。若已存在，提供选项：(A) 更新，(B) 创建副本，(C) 跳过。
  5. 若能力清单标记为❌，立即停止。不要尝试“看看会发生什么”。清单中的❌是经过实证验证的限制。
  6. 可审计性。所有执行记录都会以评论和状态更新的形式写入ClickUp——用户可事后审计。

Operaciones soportadas (resumen)

支持的操作（摘要）

Lectura completa en 
~/.claude/skills/ghl-task-builder/references/ghl-api-capabilities.md
.
Ejecutables vía API/MCP:
RecursoOperacionesVía
Calendarioscrear, actualizar, eliminarREST 
/calendars/
ContactosCRUD + tagsMCP 
contacts_*
Oportunidadesobtener, buscar, actualizarMCP 
opportunities_*
Conversaciones / mensajesenviar, buscarMCP 
conversations_*
Email templatescrear, fetchMCP 
emails_*
BlogsCRUD posts, categorías, autoresMCP 
blogs_*
Social mediacrear post, editar, listarMCP 
social-media-posting_*
Pagosleer órdenes, transaccionesMCP 
payments_*
Custom fieldsleer (write probablemente PIT-restricted, verificar)MCP 
locations_get-custom-fields
Locationleer info, custom fieldsMCP 
locations_*
NO ejecutables (skip + reportar como manual):
RecursoRazón
Workflows (crear/editar)API no expuesta por GHL — requiere builder UI
Pipelines (crear/editar)PIT restringido — 
401
. Requiere OAuth Marketplace App
Funnels, formularios, surveysAPI muy limitada
Conversation AI / Aurora botNo expuesto
Templates de WhatsAppMeta Business Manager (externo a GHL)
Configuración de dominios, SMTP, canalesNo expuesto
OAuth integrations (Zoom, Stripe, etc.)Requiere browser flow
Trigger linksNo expuesto
完整内容请阅读
~/.claude/skills/ghl-task-builder/references/ghl-api-capabilities.md
。
可通过API/MCP执行的操作：
资源操作方式
日历创建、更新、删除REST 
/calendars/
联系人CRUD + 标签MCP 
contacts_*
商机获取、搜索、更新MCP 
opportunities_*
对话/消息发送、搜索MCP 
conversations_*
邮件模板创建、获取MCP 
emails_*
博客文章、分类、作者的CRUDMCP 
blogs_*
社交媒体创建帖子、编辑、列出MCP 
social-media-posting_*
支付读取订单、交易MCP 
payments_*
自定义字段读取（写入可能受PIT限制，需验证）MCP 
locations_get-custom-fields
Location读取信息、自定义字段MCP 
locations_*
不可执行（跳过并标记为手动）：
资源原因
Workflows（创建/编辑）GHL未暴露相关API — 需使用builder UI
Pipelines（创建/编辑）受PIT限制 — 返回
401
。需OAuth Marketplace App
Funnels、表单、调查API功能非常有限
Conversation AI / Aurora bot未暴露API
WhatsApp模板属于Meta Business Manager（GHL外部）
域名、SMTP、渠道配置未暴露API
OAuth集成（Zoom、Stripe等）需要浏览器流程
Trigger links未暴露API

Output style

输出风格

Durante la ejecución:
  • Status updates conciso por cada operación: 
    [1/8] Creando calendar "Testeo"... ✅ Ee9O0qa...
  • Errores: 
    [3/8] ❌ Crear stage falló: 401 PIT no autoriza pipelines write — re-clasificada como MANUAL
Al final:
  • Tabla resumen
  • Lista de manuales con URLs directas a las subtareas
  • Lista de errores con causas y propuestas
  • Si aprendemos algo nuevo: "Sugiero actualizar el manifesto con: ..."
执行过程中：
  • 每个操作的简洁状态更新：
    [1/8] 创建日历"Testeo"... ✅ Ee9O0qa...
  • 错误信息：
    [3/8] ❌ 创建阶段失败：401 PIT不允许写入pipelines — 重新归类为手动任务
执行完成后：
  • 摘要表格
  • 带直接子任务链接的手动任务列表
  • 带原因和建议的错误列表
  • 如果发现新情况："建议更新能力清单：..."

Cómo crece la skill

技能迭代方式

Cada vez que se descubre una limitación nueva durante una ejecución:
  1. Documentarla en 
    ~/.claude/skills/ghl-task-builder/references/ghl-api-capabilities.md
  2. Agregarla a la lista de "NO ejecutables" si corresponde
  3. Re-clasificar la subtarea en ClickUp del run actual
Cada vez que se ejecuta exitosamente una operación nueva (ej: primer POST de custom field):
  1. Marcarla como ✅ verificada en el manifesto
  2. Capturar el schema funcional (con sus gotchas)
Esto convierte cada ejecución en un evento de aprendizaje permanente.
每次执行中发现新限制时：
  1. 将其记录在
    ~/.claude/skills/ghl-task-builder/references/ghl-api-capabilities.md
    中
  2. 若符合条件，添加到“不可执行”列表
  3. 重新归类当前执行中的对应子任务
每次成功执行新操作（如首次成功POST自定义字段）时：
  1. 在能力清单中标记为✅已验证
  2. 记录其功能 schema（包括注意事项）
这使得每次执行都成为永久学习的事件。