Communitygithub.com

ohmylskyhigh/threadwave-skill

雙語、附審查機制的 Twitter/X 自動化技能套件,由 ThreadWave 驅動。

threadwave-skill 是什麼?

此技能為開發者與 AI 代理(如 Claude Code、Cursor 等)提供一套嚴謹的 Twitter/X 發文工作流程。它將操作分為兩種截然不同的模式:任務模式(根據使用者提供的方向,透過 CLI 生成 1-5 個草稿提案)與精確操作模式(直接發佈使用者提供的確切最終貼文)。關鍵在於,該技能強制執行強制的預檢程序(由 threadwave-preflight 處理),驗證 CLI 版本 (1.0.21+) 與命令系列,然後才允許任何發文行為。工作流程包含詳盡的審查步驟(任務審查、來源審查、內容審查),代理必須明確遵循這些步驟,不得擅自假設。它會處理邊際情況,例如方向變更或草稿不足,使用特定的 CLI 指令(如 retask、redraft、restart)並需要使用者明確確認。此技能主要透過 CLI 工具 tw 運行,支援「發起/審查/核准/排程/發送」的封閉迴圈,防止未經授權的變異操作(如回覆、按讚)。它專為需要精細控制、審計追蹤及防止意外發文的團隊或個人設計。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add ohmyskyhigh/threadwave-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Twitter Post

將臨時的推文工作視為獨立且對等的任務來執行。切勿啟用或依賴 twitter-automation;該技能可能會將任務路由至此,但此技能擁有預檢與完整的發文工作流程的所有權。

選擇一種模式

當使用者提供主題、方向、期望結果、草稿請求或一個介於 1 到 5 的數字時,選擇任務模式。任何大於一的數字都會選中任務模式。

僅當使用者提供一個完整的終稿,並明確表示要立即發佈該確切文字時,才選擇精確操作模式。

  • 預設缺失的任務數量為 1。
  • 只接受 1 到 5 的整數。
  • 對於大於 5 的數量,要求使用者明確拆分;切勿自動建立多個提案。
  • 對於多個確切的最終文字,詢問使用者是想要一個基於方向的任務,還是多個獨立的精確操作。切勿將確切的內容靜默地轉化為生成式方向。
  • 如果不確定是精確操作還是方向型任務,在呼叫 tw 之前,先簡潔地提出一個問題。

任務模板

當進入任務模式時,以及每當請求過於模糊而無法形成方向時,需提供一個本地化的填空模板,而不是提出開放式問題:

發文任務模板:
主題/方向:<要寫什麼>,條數 <1–5>
可選:語氣、目標受眾、必須包含/避開的要點
範例:主題:為什麼小團隊應該自動化 release notes,3 條

當使用者想要重新表述時,在提案不足或被拒絕後,可再次使用相同的模板。

語言

根據明確偏好、最新訊息、對話語言,然後是英文,來決定使用英文或簡體中文回應。切勿翻譯或標準化確切的貼文文字。保留任務方向,不要新增需求。

強制預檢

在每個新的發文任務或代理工作階段開始時,以及在技能合約定義的就緒狀態失效後,請透過技能名稱啟動 threadwave-preflight。向其傳遞此技能名稱、選定模式、未經變更的請求以及所需的功能系列。在相同工作階段中,對於未變更的審查決策和工作流程延續,應重複使用該成功的結果;不要僅為審查決策而重新執行預檢。在沒有目前可用的或可重複使用的就緒結果時,請勿呼叫 tw。

要求 CLI 版本為 1.0.21,並包含 task、draft、plan、scheduler 和 action 命令系列。若缺少技能、CLI 或擴充功能狀態,請將請求引導至 https://www.threadwave.xyz/cli/setup/agent.md,同時保留原始請求。

任務模式

1. 建立一個有範圍的提案

將方向作為一個安全的參數傳遞;切勿將使用者內容串接到 shell 語法中。執行以下指令的語意等價操作:

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

要求返回 schema_version=tw_cli_harness_v1、ok=true,以及 manual_request_ref、task_blueprint_proposal_ref 和 review_ref。任務建立不授權任何 X 平台變異操作,且不得聲明草稿或排程貼文已存在。

2. 審查任務提案

僅檢查返回的審查參考:使用 tw task review show <review_ref> --json。向使用者呈現表面資訊、方向、數量、獲取途徑和安全範圍。等待明確批准。

批准後,在可重複使用的同任務預檢結果下,執行一次 tw task review approve <same_review_ref> --json。僅在收到使用者明確的匹配決策後,才能拒絕或跳過。切勿將批准轉移到已變更的方向、數量、參考、提案雜湊值上。

如果批准輸出為空白、部分內容或無法解析,則將其視為不確定狀態,此時請勿再次呼叫批准:應執行一次 tw task review show <same_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、全域審查清單或最新的審查來發現此任務的來源審查。

當 source_status=source_reviews_created 時,僅跟隨 source_review_refs_by_status.pending。如果 pending 為空但 approved 或 archived 非空,則該任務沒有待處理的來源決策。如果所有三個儲存桶都為空,則將回應視為 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 檢查每個返回的排程變異操作。

不要猜測下一個審查、成品、目標或排程任務。不要將多個草稿審查折疊成「全部批准」。每個內容批准只能授權一個精確的排程 X 變異操作。

4. 處理變更與不足情況

  • 方向/來源/觀點變更:在顯示精確範圍後,使用一次明確的 tw task retask --task 或 --batch 請求。
  • 同系列用詞變更:使用 tw draft redraft 並提供精確反饋,然後要求進行新的內容審查。
  • 有效輸出少於請求數量:報告實際有效數量;切勿憑空創造或複製項目。
  • 已批准的任務卡在 source_status=awaiting_selection 並超過固定的任務顯示截止時間:提供精確的 task_blueprint_ref,並提供一個明確的使用者選擇:「透過 tw task restart <task_blueprint_ref>--json 重新啟動一次」(驗證 ok=true 及返回的新執行狀態,然後針對相同參考恢復固定的任務顯示截止時間;重新啟動是一次全新的預變異執行,而不是重複任務或聲明舊的探索已被取消)或停止並報告確切的阻礙。失敗的重新啟動呼叫或持續卡住的參考計為一次失敗回合;在同一工作階段中經過兩次失敗回合後,停止並報告阻礙。
  • 未知的排程器或變異證據:停止,不要重試。提供精確的參考及其持久分類,並等待使用者做出明確決定:繼續監控、跳過(確認 outcome unknown 並結束監控;不授權重試或替換)、透過 tw scheduler cancel 取消使用者指定的 scheduled_task_ref(需驗證返回狀態)或請求一份經過清理的議題報告。

精確操作模式

要求提供一個確切的最終貼文。不要改寫、翻譯、縮短、擴充、標準化空白、修正拼寫、加入標籤或變更標點符號。

  1. 透過安全的 argv/stdin 處理方式,執行 tw action tweet --text <exact_text> --dry-run --json。
  2. 完整顯示確切文字、模擬執行結果以及語意操作;要求明確批准。
  3. 任何字元變更都視為新的內容,需要新的模擬執行和批准。
  4. 批准後,重複使用同任務的預檢結果,並執行一次 tw action tweet --text <same_exact_text> --json。
  5. 要求返回 ok=true、一個 action_ref 和決定性證據,然後才能報告完成。切勿重試未知結果,或發送第二則貼文作為驗證。

邊界

  • 任務模式建立一個包含 1..5 個獨立可能草稿項目的提案;它不授予批量變異操作的批准權限。
  • 精確操作模式僅控制一則貼文,且不屬於任務/計劃的範疇。
  • 不得進行回覆、引用、按讚、儲存、追蹤或直接操作瀏覽器 UI。
  • 不得在診斷訊息中洩露使用者內容、原始有效載荷、私有參考或本地路徑。

議題報告

對於明確的報告請求、CLI 合約偏差、重複發生的未解決設定問題或未知證據,請以僅報告議題模式啟動 threadwave-preflight,並附上經過清理的元資料。排除貼文文字和任務方向。說明尚未發送任何內容。

回傳格式

狀態:<等待任務批准 | 等待來源批准 | 等待內容批准 | 已排程 | 完成 | 受阻 | 未知>
模式:<任務 | 精確操作>
數量:<請求數 / 有效數 / 已批准數 / 已排程數>
審查:<一個精確的當前審查>
等待您:<一個決策或設定動作>
你可以 / You can: <當前關卡有效的二至四個可逐字說出的選項>
下一步:<一個返回的參考/動作或停止>
議題報告:<複製/貼上即可;尚未發送任何內容>

你可以 / You can: 這一行僅列出當前關卡真實存在的選項——精確的編號決策、顯示的參考或任務模板——其用詞應讓使用者能逐字回覆,並根據所選語言進行本地化;它永遠不會提供超出當前關卡權限範圍的動作。

相關技能