Communitygithub.com

ohmyskyhigh/threadwave-skill

Suíte bilíngue de automação de postagens no Twitter/X, orientada a revisão, alimentada pelo ThreadWave.

O que é threadwave-skill?

Esta skill capacita agentes de IA a gerenciar de forma autônoma o fluxo completo de criação e publicação de posts no Twitter/X, desde a definição de direção até a confirmação de agendamento, sem depender de outras skills de automação de postagens. Ela opera em dois modos principais: modo tarefa (task), ideal quando o usuário fornece um tópico ou uma demanda geral (gerando de 1 a 5 rascunhos propostos), e modo ação exata (exact-action), utilizado quando o usuário já possui o texto final e deseja publicá-lo imediatamente e sem alterações. A skill é projetada para plataformas como Claude Code, Cursor e Codex, com integração direta via CLI do ThreadWave (versão 1.0.21+). Seu diferencial está no rigoroso ciclo de revisão: cada proposta de post, rascunho e agendamento é submetido a múltiplos gates de aprovação explícita (revisão da tarefa, revisão de fonte, revisão de conteúdo), garantindo que nenhuma ação seja tomada sem confirmação clara do usuário. Além disso, ela possui um sistema de pré-verificação obrigatório (preflight) que valida o estado da skill e do ambiente antes de qualquer operação, evitando erros de configuração e garantindo segurança e rastreabilidade completas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add ohmyskyhigh/threadwave-skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Post do Twitter

Trate o trabalho de tweets avulsos como um par independente e horizontal. Nunca ative ou dependa de twitter-automation; esse par pode rotear para cá, mas esta skill é responsável pela pré-verificação e pelo fluxo completo de postagem.

Selecione um Modo

Selecione o modo tarefa quando o usuário fornecer um tópico, direção, resultado desejado, solicitação de rascunho ou uma contagem de 1 a 5. Qualquer contagem acima de um seleciona o modo tarefa.

Selecione o modo ação exata apenas quando o usuário fornecer um post final completo e quiser explicitamente que esse texto exato seja publicado agora.

  • Para uma contagem de tarefa ausente, o padrão é 1.
  • Aceite apenas um número inteiro de 1 a 5.
  • Para uma contagem acima de 5, peça ao usuário para dividi-la explicitamente; nunca crie múltiplas propostas automaticamente.
  • Para vários textos finais exatos, pergunte se o usuário deseja uma tarefa baseada em direção ou ações exatas separadas. Nunca transforme silenciosamente cargas exatas em direções generativas.
  • Se não estiver claro entre exatidão ou direção, faça uma pergunta concisa antes de invocar tw.

Template de Tarefa

Ao entrar no modo tarefa – e sempre que a solicitação for muito vaga para formar uma direção – ofereça um template de preenchimento localizado em vez de perguntas abertas:

Template de tarefa de post:
Tópico/direção: <sobre o que escrever>, quantidade <1–5>
Opcional: tom, público, pontos obrigatórios ou a evitar
Exemplo: Tópico: por que pequenas equipes devem automatizar notas de versão, quantidade 3
发推任务模板:
主题/方向:<要写什么>,条数 <1–5>
可选:语气、受众、必须包含/避开的点
示例:主题:为什么小团队应该自动化 release notes,3 条

Reutilize o mesmo template se a tarefa for insuficiente ou após uma proposta rejeitada, quando o usuário quiser reformular.

Idioma

Responda em Inglês ou Chinês Simplificado, com base na preferência explícita, na última mensagem, no idioma da conversa e, por último, em Inglês. Nunca traduza ou normalize o texto exato do post. Preserve a direção da tarefa sem adicionar requisitos.

Pré-verificação Obrigatória

Ative threadwave-preflight pelo nome da skill no início de cada nova tarefa de post ou sessão de agente, e após qualquer invalidação de prontidão definida por seu contrato. Passe o nome desta skill, o modo selecionado, a requisição inalterada e as famílias de capacidade necessárias. Reutilize o resultado bem-sucedido para decisões de revisão inalteradas e continuação do fluxo de trabalho na mesma sessão; não reexecute a pré-verificação apenas para uma decisão de revisão. Não invoque tw sem um resultado atual ou reutilizável de prontidão.

Exija CLI 1.0.21 mais as famílias de comandos task, draft, plan, scheduler e action. A falta de skill, CLI ou estado de extensão redireciona para https://www.threadwave.xyz/cli/setup/agent.md preservando a requisição.

Modo Tarefa

1. Criar uma Proposta Delimitada

Passe a direção como um argumento seguro; nunca concatene conteúdo do usuário em sintaxe de shell. Execute o equivalente semântico de:

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

Exija schema_version=tw_cli_harness_v1, ok=true e os retornos manual_request_ref, task_blueprint_proposal_ref e review_ref. A criação de tarefa não autoriza nenhuma mutação no X e não deve afirmar que rascunhos ou posts agendados já existem.

2. Revisar a Proposta da Tarefa

Inspecione apenas o review_ref retornado com tw task review show <review_ref> --json. Apresente a superfície, direção, quantidade, rota de aquisição e escopo seguro. Pare para aprovação explícita.

Após a aprovação, invoque tw task review approve <mesmo_review_ref> --json uma vez, sob o mesmo resultado de pré-verificação da tarefa reutilizável. Rejeite ou pule apenas após uma decisão explícita e correspondente do usuário. Nunca transfira a aprovação para uma direção, quantidade, ref ou hash de proposta alterados.

Se a saída da aprovação estiver em branco, parcial ou não analisável, trate-a como indeterminada e não invoque a aprovação novamente ainda: execute tw task review show <mesmo_review_ref> --json uma vez como uma recuperação somente leitura. Continue apenas quando retornar ok=true, data.review.status=approved e o task_blueprint_ref retornado. Quando retornar conclusivamente data.review.status=pending para o mesmo review_ref e escopo inalterados, a aprovação nunca chegou ao servidor: informe ao usuário e ofereça uma escolha explícita de sim/não para tentar a aprovação uma vez para esse mesmo ref inalterado; um segundo resultado indeterminado interrompe o fluxo. Quando a leitura de recuperação falhar ou for inconclusiva, pare como desvio de contrato da CLI.

Capture cada task_blueprint_ref exato retornado por essa aprovação. Inicie um prazo fixo de 180 segundos, inspecione imediatamente cada um com tw task show <task_blueprint_ref> --json e repita apenas enquanto seu source_status=awaiting_selection; antes de cada nova tentativa, aguarde mínimo(15 segundos, tempo restante) para que o prazo receba uma leitura final. Nunca use tw task review list, uma lista global de revisões ou uma revisão mais recente para descobrir as revisões de origem desta tarefa.

Quando source_status=source_reviews_created, siga apenas source_review_refs_by_status.pending. Se pending estiver vazio, mas approved ou archived não estiverem vazios, essa tarefa não tem nenhuma decisão de origem pendente. Se todos os três buckets estiverem vazios, trate a resposta como desvio de contrato da CLI e pare. Lide com no_valid_targets_found como uma insuficiência e siga os refs retornados pela CLI diretamente para qualquer outro status de origem terminal.

3. Seguir os Refs do Fluxo de Trabalho Retornados

Use apenas refs e próximas ações retornados pela CLI:

  • inspecione e decida qualquer revisão task_proposal ou source_selection manual através de tw task review;
  • inspecione artefatos gerados através de tw draft show <artifact_ref> --json;
  • inspecione cada revisão de conteúdo através de tw plan review show <review_ref> --json;
  • aprove, rejeite ou pule cada revisão de conteúdo de forma independente;
  • inspecione cada mutação agendada retornada através de tw scheduler show e tw scheduler evidence.

Não adivinhe a próxima revisão, artefato, destino ou tarefa agendada. Não colapse múltiplas revisões de rascunho em "aprovar todas". Cada aprovação de conteúdo pode autorizar apenas uma mutação exata agendada no X.

4. Lidar com Mudanças e Insuficiências

  • Mudança de direção/fonte/ângulo: use uma requisição explícita tw task retask --task ou --batch após mostrar o escopo exato.
  • Mudança de redação na mesma linhagem: use tw draft redraft com feedback exato e, em seguida, exija uma nova revisão de conteúdo.
  • Menos saídas válidas do que solicitado: relate a quantidade real válida; nunca invente ou duplique itens.
  • Tarefa aprovada paralisada em source_status=awaiting_selection após o prazo fixo de task-show: apresente o task_blueprint_ref exato e ofereça uma escolha explícita do usuário – reiniciar via tw task restart <task_blueprint_ref> --json uma vez (verifique ok=true e o estado de execução atualizado retornado, então retome o prazo fixo de task-show contra o mesmo ref; reinicializar é uma nova execução pré-mutação, nunca uma tarefa duplicada ou uma afirmação de que a descoberta antiga foi cancelada), ou pare e relate o bloqueador exato. Uma invocação de reinício falhada ou um ref que continua paralisado conta como uma rodada falhada; após duas rodadas falhadas na mesma sessão, pare e relate o bloqueador.
  • Evidência de scheduler ou mutação desconhecida: pare sem repetir. Apresente o ref exato e sua classificação durável e pare para uma decisão explícita do usuário: continuar monitorando, pular (reconhecer resultado desconhecido e encerrar o monitoramento; não autoriza repetição ou substituição), cancelar esse scheduled_task_ref nomeado pelo usuário via tw scheduler cancel uma vez com verificação de status retornado, ou solicitar um relatório de problema sanitizado.

Modo Ação Exata

Exija um post final exato. Não melhore, traduza, encurte, expanda, normalize espaços em branco, corrija ortografia, adicione hashtags ou altere pontuação.

  1. Execute tw action tweet --text <texto_exato> --dry-run --json através de manipulação segura argv/stdin.
  2. Mostre o texto exato na íntegra, o resultado do dry-run e a operação semântica; peça aprovação explícita.
  3. Trate qualquer alteração de caractere como uma nova carga que exige um novo dry-run e aprovação.
  4. Após a aprovação, reutilize o resultado da pré-verificação da mesma tarefa e envie tw action tweet --text <mesmo_texto_exato> --json uma vez.
  5. Exija ok=true, um action_ref e evidência conclusiva antes de relatar como concluído. Nunca repita um resultado desconhecido ou envie um segundo post como verificação.

Limites

  • O modo tarefa cria uma proposta com 1..5 itens de rascunho possíveis e independentes; não concede aprovação de mutação em lote.
  • O modo ação exata controla apenas um post e permanece fora da linhagem tarefa/plano.
  • Não responda, quote, curta, salve, siga ou opere a interface do navegador diretamente.
  • Não exponha conteúdo do usuário, cargas brutas, refs privados ou caminhos locais em diagnósticos.

Relatório de Problema

Para solicitações explícitas de relatório, desvios de CLI, configuração não resolvida repetidamente ou evidência desconhecida, ative threadwave-preflight no modo somente relatório de problema com metadados sanitizados. Exclua o texto do post e a direção da tarefa. Afirme que nada foi enviado.

Formato de Retorno

Estado: <precisa de aprovação de tarefa | precisa de aprovação de fonte | precisa de aprovação de conteúdo | agendado | concluído | bloqueado | desconhecido>
Modo: <tarefa | ação exata>
Quantidade: <solicitada / válida / aprovada / agendada>
Revisão: <uma revisão atual exata>
Aguardando você: <uma decisão ou ação de configuração>
Você pode: <duas a quatro opções válidas e dizíveis literalmente no portão atual>
Próximo: <um ref/ação retornado ou parar>
Relatório de problema: <copiar/colar apenas; nada enviado>

A linha Você pode: lista apenas opções reais no portão atual – decisões numeradas exatas, refs exibidos ou o template de tarefa – redigidas para que o usuário possa responder literalmente, localizadas no idioma selecionado; nunca oferece uma ação além da autoridade do portão atual.

Habilidades Relacionadas