Communitygithub.com

ThreadWave Twitter/X 자동화 스킬

ThreadWave 기반의 검토 게이트가 있는 이중 언어 Twitter/X 자동화 스킬 모음입니다.

X 자동화 스킬란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor 등)가 ThreadWave CLI(`tw`)를 통해 Twitter/X에 트윗을 게시할 수 있는 완전한 워크플로우를 제공합니다. task 모드와 exact-action 모드라는 두 가지 모드를 지원합니다. task 모드에서는 사용자가 제공한 주제나 방향에 따라 에이전트가 1~5개의 트윗 초안을 생성하고, 각각의 검토 및 승인 과정을 거친 후 예약 게시까지 진행합니다. exact-action 모드에서는 사용자가 최종 텍스트를 정확히 제공하면 드라이 런을 통해 검증한 후 한 번의 승인으로 즉시 게시합니다. 이 스킬은 안전성과 제어를 최우선으로 하며, 모든 돌연변이(X 게시)는 명시적인 승인 후에만 실행됩니다. 사전 점검(preflight) 단계를 강제하여 CLI 버전, 명령어 패밀리, 스킬 상태를 확인하고, 실패 시 설정 안내 페이지로 연결합니다. 한국어를 포함한 여러 언어를 지원하며, 사용자 선호도와 대화 맥락에 따라 응답 언어를 결정합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add ohmyskyhigh/threadwave-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Twitter 포스트

임시 트윗 작업을 독립적인 수평 피어로 수행합니다. twitter-automation을 활성화하거나 의존하지 마십시오. 해당 피어가 여기로 라우팅될 수 있지만, 이 스킬은 사전 점검(preflight)과 전체 게시 워크플로우를 소유합니다.

모드 선택

사용자가 주제, 방향, 원하는 결과, 초안 요청 또는 1에서 5 사이의 개수를 제공하면 task 모드를 선택합니다. 1보다 큰 개수는 task 모드를 선택합니다.

사용자가 하나의 완전한 최종 포스트를 제공하고 해당 정확한 텍스트를 지금 게시하기를 명시적으로 원하는 경우에만 exact-action 모드를 선택합니다.

  • 누락된 task 개수는 기본값 1로 설정합니다.
  • 1에서 5 사이의 정수만 허용합니다.
  • 5를 초과하는 개수는 사용자에게 명시적으로 분할하도록 요청합니다. 자동으로 여러 제안을 생성하지 마십시오.
  • 여러 개의 정확한 최종 텍스트가 있는 경우, 사용자에게 방향 기반 task 하나를 원하는지 또는 별도의 exact-action을 원하는지 물어봅니다. 정확한 페이로드를 생성적 방향으로 조용히 변환하지 마십시오.
  • 정확성과 방향성이 불분명한 경우, tw를 호출하기 전에 간결한 질문을 하나 합니다.

Task 템플릿

task 모드에 진입할 때 — 그리고 요청이 방향을 형성하기에 너무 모호할 때마다 — 개방형 질문 대신 현지화된 채우기 템플릿을 하나 제공합니다.

포스트 task 템플릿:
주제/방향: <무엇에 대해 쓸지>, 개수 <1–5>
선택 사항: 어조, 대상, 반드시 포함/피해야 할 점
예시: 주제: 소규모 팀이 릴리스 노트를 자동화해야 하는 이유, 개수 3
발트윗 task 템플릿:
주제/방향: <무엇에 대해 쓸지>, 개수 <1–5>
선택 사항: 어조, 대상, 반드시 포함/피해야 할 점
예시: 주제: 소규모 팀이 릴리스 노트를 자동화해야 하는 이유, 개수 3

부족한 경우나 제안이 거부된 후 사용자가 다시 표현하려는 경우 동일한 템플릿을 재사용합니다.

언어

명시적 선호도, 최신 메시지, 대화 언어, 그 다음 영어 순서로 영어 또는 간체 중국어로 응답합니다. 정확한 포스트 텍스트를 번역하거나 정규화하지 마십시오. 요구 사항을 추가하지 않고 task 방향을 유지합니다.

필수 사전 점검 (Mandatory Preflight)

각 새 포스트 task 또는 에이전트 세션 시작 시, 그리고 계약에 정의된 준비 상태 무효화 후에 스킬 이름으로 threadwave-preflight를 활성화합니다. 이 스킬 이름, 선택된 모드, 변경되지 않은 요청, 필요한 기능 패밀리를 전달합니다. 변경되지 않은 검토 결정과 동일 세션 내 워크플로우 연속을 위해 해당 성공 결과를 재사용합니다. 검토 결정만을 위해 preflight를 다시 실행하지 마십시오. 현재 또는 재사용 가능한 준비 결과 없이 tw를 호출하지 마십시오.

CLI 1.0.21 이상과 task, draft, plan, scheduler, action 명령어 패밀리가 필요합니다. 누락된 스킬, CLI 또는 확장 상태는 요청을 유지하면서 https://www.threadwave.xyz/cli/setup/agent.md로 라우팅됩니다.

Task 모드

1. 하나의 경계 있는 제안 생성

방향을 하나의 안전한 인수로 전달합니다. 사용자 콘텐츠를 셸 구문에 연결하지 마십시오. 다음의 의미론적 동등 작업을 실행합니다.

tw task create --surface tweet --direction <정확한_사용자_방향> --count <1..5> --json

schema_version=tw_cli_harness_v1, ok=true, 반환된 manual_request_ref, task_blueprint_proposal_ref, review_ref를 요구합니다. task 생성은 X 돌연변이를 승인하지 않으며 초안이나 예약된 포스트가 이미 존재한다고 주장해서는 안 됩니다.

2. Task 제안 검토

반환된 검토 참조만 tw task review show <review_ref> --json으로 검사합니다. 표면, 방향, 개수, 획득 경로, 안전한 범위를 표시합니다. 명시적 승인을 위해 중지합니다.

승인 후, 재사용 가능한 동일 task preflight 결과 하에서 tw task review approve <동일한_review_ref> --json을 한 번 호출합니다. 명시적인 일치하는 사용자 결정 후에만 거부하거나 건너뜁니다. 변경된 방향, 개수, 참조 또는 제안 해시로 승인을 이전하지 마십시오.

승인 출력이 비어 있거나, 부분적이거나, 구문 분석할 수 없는 경우, 이를 불확정 상태로 간주하고 아직 승인을 다시 호출하지 마십시오. tw task review show <동일한_review_ref> --json을 읽기 전용 복구로 한 번 실행합니다. ok=true, data.review.status=approved, 반환된 task_blueprint_ref가 반환될 때만 계속합니다. 동일한 변경되지 않은 review_ref와 범위에 대해 data.review.status=pending이 확정적으로 반환되면 승인이 서버에 도달하지 않은 것입니다. 사용자에게 알리고 해당 변경되지 않은 참조에 대한 승인을 한 번 재시도할지 명시적인 예/아니오 선택을 제공합니다. 두 번째 불확정 결과는 흐름을 중단합니다. 복구 읽기 자체가 실패하거나 불확실하면 CLI 계약 드리프트로 중단합니다.

해당 승인에 의해 반환된 모든 정확한 task_blueprint_ref를 캡처합니다. 고정된 180초 마감 시간을 시작하고, 즉시 각각을 tw task show <task_blueprint_ref> --json으로 검사하고 source_status=awaiting_selection인 동안에만 반복합니다. 각 재시도 전에 min(15초, 남은 시간)을 기다려 마감 시간이 최종 읽기를 한 번 받을 수 있도록 합니다. tw task review list, 전체 검토 목록 또는 최신 검토를 사용하여 이 task의 소스 검토를 발견하지 마십시오.

source_status=source_reviews_created인 경우 source_review_refs_by_status.pending만 따릅니다. pending이 비어 있지만 approved 또는 archived가 비어 있지 않으면 해당 task에 대기 중인 소스 결정이 없는 것입니다. 세 버킷이 모두 비어 있으면 응답을 CLI 계약 드리프트로 처리하고 중단합니다. no_valid_targets_found를 부족 상태로 처리하고 다른 터미널 소스 상태에 대해 CLI가 반환한 참조를 직접 따릅니다.

3. 반환된 워크플로우 참조 따르기

CLI가 반환한 참조와 다음 작업만 사용합니다.

  • tw task review를 통해 수동 task_proposal 또는 source_selection 검토를 검사하고 결정합니다.
  • tw draft show <artifact_ref> --json을 통해 생성된 아티팩트를 검사합니다.
  • tw plan review show <review_ref> --json을 통해 각 콘텐츠 검토를 검사합니다.
  • 각 콘텐츠 검토를 독립적으로 승인, 거부 또는 건너뜁니다.
  • 반환된 각 예약된 돌연변이를 tw scheduler show 및 tw scheduler evidence를 통해 검사합니다.

다음 검토, 아티팩트, 대상 또는 예약된 task를 추측하지 마십시오. 여러 초안 검토를 "모두 승인"으로 축소하지 마십시오. 각 콘텐츠 승인은 하나의 정확한 예약된 X 돌연변이만 승인할 수 있습니다.

4. 변경 및 부족 처리

  • 방향/소스/관점 변경: 정확한 범위를 표시한 후 하나의 명시적인 tw task retask --task 또는 --batch 요청을 사용합니다.
  • 동일 계열 표현 변경: 정확한 피드백과 함께 tw draft redraft를 사용한 다음 새 콘텐츠 검토를 요구합니다.
  • 요청된 것보다 적은 유효 출력: 실제 유효 개수를 보고합니다. 항목을 발명하거나 복제하지 마십시오.
  • 승인된 task가 고정된 task 표시 마감 시간을 초과하여 source_status=awaiting_selection에서 멈춤: 정확한 task_blueprint_ref를 제시하고 사용자에게 명시적인 선택을 하나 제공합니다 — tw task restart <task_blueprint_ref> --json을 한 번 통해 재시작(ok=true`와 반환된 새로운 실행 상태를 확인한 다음 동일한 참조에 대해 고정된 task 표시 마감 시간을 재개합니다. 재시작은 새로운 사전 돌연변이 실행이며, 중복 task나 이전 발견이 취소되었다는 주장이 아닙니다)하거나, 중단하고 정확한 차단자를 보고합니다. 실패한 재시작 호출 또는 계속 지연되는 참조는 한 번의 실패로 간주됩니다. 동일 세션에서 두 번 실패한 후 중단하고 차단자를 보고합니다.
  • 알 수 없는 스케줄러 또는 돌연변이 증거: 재시도 없이 중단합니다. 정확한 참조와 내구성 있는 분류를 제시하고 사용자의 명시적인 결정을 위해 중단합니다: 계속 모니터링, 건너뛰기(outcome unknown을 인정하고 모니터링 종료, 재시도 또는 교체 승인하지 않음), 해당 정확한 사용자 명명 scheduled_task_ref를 tw scheduler cancel을 통해 한 번 취소(반환된 상태 확인 포함) 또는 삭제된 이슈 보고서 요청.

Exact-Action 모드

하나의 정확한 최종 포스트가 필요합니다. 개선, 번역, 단축, 확장, 공백 정규화, 맞춤법 수정, 해시태그 추가 또는 구두점 변경을 하지 마십시오.

  1. 안전한 argv/stdin 처리를 통해 tw action tweet --text <정확한_텍스트> --dry-run --json을 실행합니다.
  2. 정확한 텍스트 전체, 드라이 런 결과 및 의미론적 작업을 표시합니다. 명시적 승인을 요청합니다.
  3. 문자 변경은 새 페이로드로 간주하여 새 드라이 런과 승인이 필요합니다.
  4. 승인 후, 동일 task preflight 결과를 재사용하고 tw action tweet --text <동일한_정확한_텍스트> --json을 한 번 전송합니다.
  5. ok=true, action_ref 및 확정적인 증거가 필요합니다. 알 수 없는 결과를 재시도하거나 확인을 위해 두 번째 포스트를 보내지 마십시오.

경계

  • Task 모드는 1..5개의 독립적인 가능한 초안 항목으로 하나의 제안을 생성합니다. 배치 돌연변이 승인을 부여하지 않습니다.
  • Exact-action 모드는 하나의 포스트만 제어하며 task/계획 계열 외부에 있습니다.
  • 답글, 인용, 좋아요, 저장, 팔로우 또는 브라우저 UI를 직접 조작하지 마십시오.
  • 진단에 사용자 콘텐츠, 원시 페이로드, 개인 참조 또는 로컬 경로를 노출하지 마십시오.

이슈 보고서

명시적 보고 요청, CLI 드리프트, 반복적인 미해결 설정 또는 알 수 없는 증거가 있는 경우, 삭제된 메타데이터로 threadwave-preflight를 이슈 보고서 전용 모드로 활성화합니다. 포스트 텍스트와 task 방향을 제외합니다. 아무것도 전송되지 않았음을 명시합니다.

반환 형식

상태: <task 승인 필요 | 소스 승인 필요 | 콘텐츠 승인 필요 | 예약됨 | 완료 | 차단됨 | 알 수 없음>
모드: <task | exact action>
개수: <요청됨 / 유효함 / 승인됨 / 예약됨>
검토: <하나의 정확한 현재 검토>
당신의 결정을 기다리는 중: <하나의 결정 또는 설정 작업>
당신이 할 수 있는 것 / You can: <현재 게이트에서 유효한 두 개에서 네 개의 그대로 말할 수 있는 옵션>
다음: <하나의 반환된 참조/작업 또는 중단>
이슈 보고서: <복사/붙여넣기 전용, 전송된 것 없음>

당신이 할 수 있는 것 / You can: 행은 현재 게이트에서 실제로 유효한 옵션만 나열합니다 — 정확한 번호 선택, 표시된 참조 또는 task 템플릿 — 사용자가 그대로 답변할 수 있도록 표현되며, 선택된 언어로 현지화됩니다. 현재 게이트의 권한을 넘어서는 작업을 제공하지 않습니다.

관련 스킬