Communitygithub.com

threadwave-skill

Suite bilingüe de automatización de publicaciones en Twitter/X con control de revisión, impulsada por ThreadWave.

¿Qué es threadwave-skill?

Esta skill de agente, diseñada para Claude Code, Cursor, Codex y otras herramientas de IA, proporciona una suite completa y controlada para publicar en Twitter/X. Su principal objetivo es gestionar tareas de publicación con un flujo de trabajo seguro y revisable, evitando acciones no autorizadas. Soporta dos modos principales: el modo 'tarea', que genera propuestas de tweets basadas en una dirección temática (de 1 a 5 tweets), y el modo 'acción exacta', que publica un texto de tweet final y específico proporcionado por el usuario. La skill incluye una validación previa obligatoria ('preflight') que verifica la configuración del CLI y las dependencias, garantizando que todo esté listo antes de cualquier operación. A lo largo del proceso, se requiere revisión y aprobación explícita del usuario en cada etapa (propuesta, fuente y contenido), y se manejan escenarios de cambio, estancamiento o resultados inesperados mediante acciones claras y reversibles. Esto asegura que el agente nunca publique contenido sin revisión o aprobación, manteniendo un control granular y seguro sobre la automatización de tweets.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add ohmyskyhigh/threadwave-skill

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Publicación en Twitter

Gestiona tu trabajo de tweets ad-hoc como un par independiente. Nunca actives ni dependas de twitter-automation; ese peer puede enrutar aquí, pero esta skill es dueña de la validación previa y del flujo de trabajo completo de publicación.

Seleccionar un Modo

Selecciona el modo tarea cuando el usuario proporcione un tema, dirección, resultado deseado, solicitud de borrador o un número del 1 al 5. Cualquier número superior a uno selecciona el modo tarea.

Selecciona el modo acción exacta solo cuando el usuario proporcione una publicación final completa y quiera explícitamente que ese texto exacto se publique ahora.

  • Por defecto, si falta un número de tarea, usa 1.
  • Acepta solo un número entero del 1 al 5.
  • Para un número superior a 5, pide al usuario que lo divida explícitamente; nunca crees múltiples propuestas automáticamente.
  • Para varios textos finales exactos, pregunta si el usuario quiere una tarea basada en una dirección o acciones exactas separadas. Nunca conviertas silenciosamente cargas exactas en direcciones generativas.
  • Si no está claro si es exactitud o dirección, haz una pregunta concisa antes de invocar tw.

Plantilla de Tarea

Al entrar en modo tarea — y siempre que la solicitud sea demasiado vaga para formar una dirección — ofrece una plantilla localizada en lugar de preguntas abiertas:

Plantilla de tarea de publicación:
Tema/dirección: <sobre qué escribir>, número <1–5>
Opcional: tono, audiencia, puntos a incluir o evitar
Ejemplo: Tema: por qué los equipos pequeños deberían automatizar las notas de versión, número 3
发推任务模板:
主题/方向:<要写什么>,条数 <1–5>
可选:语气、受众、必须包含/避开的点
示例:主题:为什么小团队应该自动化 release notes,3 条

Reutiliza la misma plantilla en caso de escasez o después de una propuesta rechazada cuando el usuario quiera reformular.

Idioma

Responde en inglés o chino simplificado según preferencia explícita, el último mensaje, el idioma de la conversación o, en su defecto, inglés. Nunca traduzcas ni normalices el texto exacto de la publicación. Preserva la dirección de la tarea sin añadir requisitos.

Validación Previa Obligatoria

Activa threadwave-preflight por nombre de skill al inicio de cada nueva tarea de publicación o sesión de agente, y después de cualquier invalidación de estado definida por su contrato. Pasa el nombre de esta skill, el modo seleccionado, la solicitud sin cambios y las familias de capacidades requeridas. Reutiliza ese resultado exitoso para decisiones de revisión sin cambios y continuación del flujo de trabajo en la misma sesión; no vuelvas a ejecutar la validación previa solo por una decisión de revisión. No invoques tw sin un resultado listo actual o reutilizable.

Se requiere CLI 1.0.21 más las familias de comandos task, draft, plan, scheduler y action. Si falta la skill, el CLI o el estado de la extensión, redirige a https://www.threadwave.xyz/cli/setup/agent.md mientras se conserva la solicitud.

Modo Tarea

1. Crear una Propuesta Delimitada

Pasa la dirección como un argumento seguro; nunca concatenes contenido del usuario en sintaxis de shell. Ejecuta el equivalente semántico de:

tw task create --surface tweet --direction <direccion_exacta_del_usuario> --count <1..5> --json

Requiere schema_version=tw_cli_harness_v1, ok=true, y los manual_request_ref, task_blueprint_proposal_ref y review_ref devueltos. La creación de tareas no autoriza ninguna mutación en X y no debe afirmar que ya existen borradores o publicaciones programadas.

2. Revisar la Propuesta de Tarea

Inspecciona solo el reference de revisión devuelto con tw task review show <review_ref> --json. Presenta la superficie, dirección, número, ruta de adquisición y alcance seguro. Detente para obtener aprobación explícita.

Después de la aprobación, invoca tw task review approve <mismo_review_ref> --json una vez bajo el mismo resultado de validación previa de la tarea reutilizable. Rechaza u omite solo después de una decisión explícita del usuario que coincida. Nunca transfieras la aprobación a una dirección, número, referencia o hash de propuesta cambiado.

Si el resultado de la aprobación está en blanco, es parcial o no se puede analizar, trátalo como indeterminado y no invoques la aprobación de nuevo aún: ejecuta tw task review show <mismo_review_ref> --json una vez como recuperación de solo lectura. Continúa solo cuando devuelva ok=true, data.review.status=approved y el task_blueprint_ref devuelto. Si devuelve de forma concluyente data.review.status=pending para el mismo review_ref y alcance sin cambios, la aprobación nunca llegó al servidor: informa al usuario y ofrece una opción explícita de sí/no para reintentar la aprobación una vez para esa referencia exacta sin cambios; un segundo resultado indeterminado detiene el flujo. Cuando la lectura de recuperación falla o no es concluyente, detente como desviación del contrato del CLI.

Captura cada task_blueprint_ref exacto devuelto por esa aprobación. Inicia un plazo fijo de 180 segundos, inspecciona inmediatamente cada uno con tw task show <task_blueprint_ref> --json, y repite solo mientras su source_status=awaiting_selection; antes de cada reintento, espera min(15 segundos, tiempo restante) para que el plazo reciba una lectura final. Nunca uses tw task review list, una lista de revisión global o una revisión más reciente para descubrir las revisiones de origen de esta tarea.

Cuando source_status=source_reviews_created, sigue solo source_review_refs_by_status.pending. Si pending está vacío pero approved o archived no están vacíos, esa tarea no tiene una decisión de origen pendiente. Si los tres cubos están vacíos, trata la respuesta como una desviación del contrato del CLI y detente. Maneja no_valid_targets_found como una escasez y sigue las referencias devueltas por el CLI directamente para cualquier otro estado de origen terminal.

3. Seguir las Referencias del Flujo de Trabajo Devueltas

Usa solo las referencias y las siguientes acciones devueltas por el CLI:

  • inspecciona y decide cualquier revisión manual de task_proposal o source_selection a través de tw task review;
  • inspecciona los artefactos generados a través de tw draft show <artifact_ref> --json;
  • inspecciona cada revisión de contenido a través de tw plan review show <review_ref> --json;
  • aprueba, rechaza u omite cada revisión de contenido de forma independiente;
  • inspecciona cada mutación programada devuelta a través de tw scheduler show y tw scheduler evidence.

No adivines la próxima revisión, artefacto, destino o tarea programada. No colapses múltiples revisiones de borradores en "aprobar todo". Cada aprobación de contenido puede autorizar solo una mutación exacta programada en X.

4. Manejar Cambios y Escasez

  • Cambio de dirección/fuente/ángulo: usa una solicitud explícita tw task retask --task o --batch después de mostrar el alcance exacto.
  • Cambio de redacción en la misma línea: usa tw draft redraft con comentarios exactos, luego requiere una nueva revisión de contenido.
  • Menos resultados válidos de los solicitados: informa el número válido real; nunca inventes ni dupliques elementos.
  • Tarea aprobada estancada en source_status=awaiting_selection después del plazo fijo de task show: presenta el task_blueprint_ref exacto y ofrece una opción explícita del usuario — reiniciar mediante tw task restart <task_blueprint_ref> --json una vez (verifica ok=true y el nuevo estado de ejecución devuelto, luego reanuda el plazo fijo de task show contra la misma referencia; restart es una nueva ejecución previa a la mutación, nunca una tarea duplicada o una afirmación de que el descubrimiento anterior fue cancelado), o detente e informa del bloqueador exacto. Una invocación de reinicio fallida o una referencia que sigue estancada cuenta como una ronda fallida; después de dos rondas fallidas en la misma sesión, detente e informa del bloqueador.
  • Evidencia de programador o mutación desconocida: detente sin reintentar. Presenta la referencia exacta y su clasificación duradera, y detente para una decisión explícita del usuario: seguir monitoreando, omitir (reconocer resultado desconocido y finalizar el monitoreo; no autoriza reintento ni reemplazo), cancelar esa scheduled_task_ref exacta nombrada por el usuario mediante tw scheduler cancel una vez con verificación del estado devuelto, o solicitar un informe de problema saneado.

Modo Acción Exacta

Requiere una publicación final exacta. No mejores, traduzcas, acortes, expandas, normalices espacios en blanco, corrijas ortografía, añadas hashtags ni cambies puntuación.

  1. Ejecuta tw action tweet --text <texto_exacto> --dry-run --json mediante el manejo seguro de argv/stdin.
  2. Muestra el texto exacto completo, el resultado de la simulación y la operación semántica; pide aprobación explícita.
  3. Trata cualquier cambio de carácter como una nueva carga que requiere una nueva simulación y aprobación.
  4. Después de la aprobación, reutiliza el resultado de validación previa de la misma tarea y envía tw action tweet --text <mismo_texto_exacto> --json una vez.
  5. Requiere ok=true, un action_ref y evidencia concluyente antes de informar como completo. Nunca reintentes un resultado desconocido ni envíes un segundo post como verificación.

Límites

  • El modo tarea crea una propuesta con 1..5 posibles elementos de borrador independientes; no otorga aprobación de mutación por lotes.
  • El modo acción exacta controla solo una publicación y permanece fuera del linaje de tarea/plan.
  • No respondas, cites, des "me gusta", guardes, sigas ni operes la interfaz de usuario del navegador directamente.
  • No expongas contenido del usuario, cargas sin procesar, referencias privadas o rutas locales en diagnósticos.

Informe de Problemas

Para solicitudes de informe explícitas, desviación del CLI, configuración no resuelta repetida o evidencia desconocida, activa threadwave-preflight en modo solo informe de problemas con metadatos saneados. Excluye el texto de la publicación y la dirección de la tarea. Indica que no se envió nada.

Formato de Retorno

Estado: <necesita aprobación de tarea | necesita aprobación de fuente | necesita aprobación de contenido | programado | completado | bloqueado | desconocido>
Modo: <tarea | acción exacta>
Número: <solicitados / válidos / aprobados / programados>
Revisión: <una revisión actual exacta>
Esperando tu decisión: <una decisión o acción de configuración>
你可以 / Puedes hacer: <de dos a cuatro opciones textuales válidas en la compuerta actual>
Siguiente: <una referencia/acción devuelta o detenerse>
Informe de problema: <copiar/pegar solo; nada enviado>

La línea 你可以 / Puedes hacer: lista solo opciones reales en la compuerta actual — decisiones numeradas exactas, referencias mostradas o la plantilla de tarea — redactadas para que el usuario pueda responder textualmente, localizadas al idioma seleccionado; nunca ofrece una acción más allá de la autoridad de la compuerta actual.

Skills relacionados