| name | threads-write-post |
| description | Use when the user wants to write a Threads post end-to-end after the angle is locked — pick framework, plan thread skeleton, map algorithm mechanisms, design interaction, draft, review, publish. Triggers: user says 「幫我寫貼文」/「從 angle 寫到發文」/「跑 advisor pipeline」/「我有 angle.md 了下一步是」, asks to continue from an existing drafts/*.angle.md, or wants the full Stage 1→7 workflow. PREREQUISITE: angle.md must exist (run `threads-angle-gate` first if it doesn't). Do NOT use for Stage 0 angle decisions — that is `threads-angle-gate`'s job. Do NOT use for pure CLI ops (publish/list/insights) — that is `threads-cli`. Do NOT use for analytics-only queries — that is `threads-advisor analyze`. |
threads-write-post — Threads 貼文寫作 pipeline（Stage 1→7）
這個 skill 是什麼
從一份已銳利的 angle.md 出發，把貼文寫到能發出去。Stage 0（想清楚切入點）由 threads-angle-gate 處理；本 skill 接 Stage 1–7：選框架 → 規畫骨架 → 演算法機制對應 → 互動設計 → 寫稿 → 讀稿 → 發文。
檔名規範：每個 stage 的 artifact 寫在 drafts/<slug>.<stage>.md。<slug> 跨 stage 一致，由 Stage 0 的 angle.md 決定。
為什麼需要這個 skill：寫貼文流程曾經完全依賴 docs/dev/advisor-pipeline-schema.md 這份契約文件。0428 端到端測試發現 schema 在 Stage 5 入口邏輯卡死——它規定要讀三份不存在的檔，每次都靠人臨時繞過。本 skill 把那份 schema 的規範重組成「skill 內建 reference + 律定何時讀」的結構，schema 文件 deprecate 成歷史紀錄。
前置條件（必）：drafts/<slug>.angle.md 存在且 Gate 0→1 PASS。沒有 angle.md 不要進 Stage 1，回去跑 threads-angle-gate。
Pipeline Iron Law（凌駕全文件，跨 stage 適用）
NO STAGE PROGRESSION WITHOUT FRESH GATE EVIDENCE.
If you haven't checked the Gate checklist in this message, you cannot claim Stage N is complete. Spirit over letter — finding a loophole in the wording is still a violation.
Gate Function（每進下一 Stage 前必跑）
- IDENTIFY：上一 Stage 的 Gate 是哪一條（Gate N→N+1）？
- CHECK：Gate checklist 全部 checkbox 是否在「本訊息」中逐條跑過？
- READ：每個 checkbox 對應的 artifact 欄位是否真的存在於檔案（不是 stale memory）？
- VERIFY：User align 是否已在「本 session」明確發生（不是「之前 align 過」）？
- ANNOUNCE：明確聲明 Gate 結果（PASS / FAIL + 缺什麼）
Common Failures
| Claim | Requires | Not Sufficient |
|---|
| Stage 1 done | framework.md 含 chosen_framework + chosen_reason 非空 + user 本 session 確認 | 「user 0424 選過 PREP」 |
| Stage 2 done | plan.md 6 章節齊 + 字數 ≤ 3500 + user align | 「骨架方向已 align」 |
| Stage 5 reference 讀過 | references_read_in_order: true 寫進 frontmatter + stage-5-draft.md 與 angle.md source_quotes 都讀於本 session | 「我有印象讀過」 |
| Gate PASS | 本訊息逐條跑 checklist + 對 artifact 欄位實檢 | 「應該 OK」「差不多」 |
Rationalization Prevention
| 藉口 | 現實 |
|---|
| 「user 之前 align 過了」 | 重新驗 — 之前的 align 是不同 stage 不同 artifact |
| 「我記得內容差不多」 | 記憶 ≠ artifact，重看檔案 |
| 「先進下個 stage 之後補」 | 永遠不會補；現在不過 Gate = 永遠不過 |
| 「auto mode 要快」 | auto mode 不豁免 Iron Law |
| 「mimic 不是正規 CLI 不算」 | mimic 仍要過 Gate；mimic 不是免責標籤 |
| 「這條 checkbox 不重要」 | checkbox 不分輕重，全勾才 PASS |
Red Flags — STOP
- 任何 Stage 完成宣告未列具體 evidence
- 「應該」「大概」「我印象中」這類字眼出現在 Gate 評估
- Skip 一個 checkbox 想「事後補」
- 用 user 的 align 替代 artifact 存在
- 把不同 Stage 的 align 拿來 cross-reference
Stage Entry Template（每進一 stage 必跑）
每進入一個 Stage，第一個訊息必須以下列格式 announce（不可省略；省略 = 跳 Stage = Iron Law violation）：
I'm entering Stage N — <stage name>.
- Upstream artifact: <path to upstream artifact>
- Upstream Gate status: <PASS / FAIL — 評估結果摘要>
- This stage produces: <path to this stage's artifact>
- Schema requirements: <列出本 stage 所有必填欄位>
- Required references to read (if any): <列出檔名 + 順序>
並在本 stage 產出的 artifact frontmatter 加：
stage_entry_announced: true
upstream_gate_passed: true
references_read_in_order: true
未做 announce 視為「跳 Stage」。stage_entry_announced 欄位是強制 audit trail，不可省略。
Stage 0 — Angle（delegated）
本 skill 不處理 Stage 0。執行 threads-angle-gate skill，產出 drafts/<slug>.angle.md，Gate 0→1 PASS 後再回來。
Gate 0→1 沒 PASS（angle.md 缺 sharpness / source_quotes 空 / user 沒明確 align）= 不准進 Stage 1。
Stage 1 — Framework pick
Artifact：drafts/<slug>.framework.md
進入時必讀（v2 升級為兩份）：
- When entering Stage 1, read
references/stage-1-framework.md in full BEFORE producing the artifact. Do not summarize from memory — 16+1 框架（含 v2 新增 Narrative-arc / Thesis-argumentation）名稱與公式必須引用 reference 原文。
- 同時讀
references/writing-philosophy.md in full — 軸心擺位 default orientation。框架選擇要對齊 writing-philosophy 軸心（show, don't tell）。
簡要 schema（complete spec 在 reference；v2 新增 (a) Narrative-arc / (b) Thesis-argumentation 兩型 process-driven 框架，跟既有 16+1 並列）：
considered_frameworks：3 個框架（不少不多），每個含 id / name / formula / why_fitchosen_framework：使用者選定（單一），含 id / name / chosen_reason
Gate 1→2 提醒：考慮數 ≠ 3、chosen_framework.id 不在 16+1 清單、chosen_reason 為空（「順手選」也算空）= Gate FAIL。完整 checklist 見 reference 末尾。
Stage 2 — Plan
Artifact：drafts/<slug>.plan.md
進入時必讀：When entering Stage 2, read references/stage-2-plan.md in full BEFORE producing the artifact. Do not summarize from memory — 6 章節結構與字數預算必須對齊 reference。
簡要 schema（complete spec 在 reference）：
- 6 個必填章節（依序）：頭部 / 受眾 / 起承轉合 mapping / 骨架 / 互動設計 / 風險提示
- 骨架每條含【鉤子類型】【字數建議】【內容方向】【情緒】
- 總長 ≤ 3500 字
Gate 2→3 提醒：缺章節、骨架欄位漏、起承轉合 mapping 隱在骨架內未顯式列出、字數超過 = Gate FAIL。
對應 CLI：advisor plan --framework N --overwrite（feat/advisor-plan branch 未 merge）。CLI 不可用時 mimic，但必須符合 reference schema。
Stage 3 — Algo mapping
Artifact：drafts/<slug>.algo.md
進入時必讀：When entering Stage 3, read references/stage-3-algo.md in full BEFORE producing the artifact. Do not summarize from memory。
另需 consult：global threads-algorithm-skill 的 26 機制清單（散在 5 份 reference，非單一份；reference 路徑見 stage-3-algo.md）。不准編造機制名稱——機制名必須引用 reference 原文，artifact 必須聲明 source 路徑。
簡要 schema（complete spec 在 reference）：
algo_skill_source：列出實際 Read 過的 threads-algorithm-skill reference 路徑- 每條 post 對應 ≥ 1 個機制：
post_position / mechanism / mechanism_source（檔名）/ why_applies / risk
- 整體：
dominant_mechanisms（2–3 個）/ avoid_mechanisms（如 Low Signal）
Gate 3→4 提醒：機制名未引用 reference 原文、mechanism_source / algo_skill_source 為空、why_applies / risk 為空 = Gate FAIL。
Stage 4 — Interaction design
Artifact：drafts/<slug>.interaction.md
進入時必讀：When entering Stage 4, read references/stage-4-interaction.md in full BEFORE producing the artifact. Do not summarize from memory。
簡要 schema（complete spec 在 reference）：
chosen_types：5 類型中選 2–3 個（不接受 1 個或 4+）- 5 類型：開放式問題 / 爭議觀點 / 個人經驗邀請 / 投票選擇題 / 標記朋友
- 每個 chosen type 含
post_position / why_this_post / example_phrasing
Gate 4→5 提醒：chosen_types 數量 ∉ {2, 3}、example_phrasing 為空（Stage 5 將無從寫起）、自創類型 = Gate FAIL。
Stage 5 — Draft（CRITICAL — 嚴格 loading guarantee）
Artifact：drafts/<slug>.draft.md
進入時必做三件事（缺一 = Gate 5→6 FAIL）
(a) 進 Stage 5 後才 Read 兩份 in full——
references/stage-5-draft.md：voice patterns、Voice Hard Lint、7 條寫作技巧筆記、末尾 Read Evidence Phrase、字句層 Lint（v2 新增）references/writing-philosophy.md（v2 新增）：軸心擺位（show, don't tell）
「之前讀過」不算（fresh evidence 條件）。Voice Hard Lint 是 pipeline 內唯一的 binary 機械擋條件。
(b) 進 Stage 5 後才 Read drafts/<slug>.angle.md frontmatter 的 source_quotes——這是 user 本篇貼文的真實聲音。stage-5-draft.md 提供的 voice patterns 是 scaffolding，特定本篇的 voice 真理在 source_quotes。
(c) 在 draft.md frontmatter 寫兩個欄位：
references_read_in_order: true（audit trail）read_evidence: "<逐字引用 stage-5-draft.md 末尾 Read Evidence Phrase>"（grep-able anti-cheat 證據；該 phrase 只在 stage-5-draft.md 末尾出現）
任一缺 = 默認沒讀 = Gate FAIL。
為什麼 Stage 5 特別嚴
0427 schema v1 在 Stage 5 入口要求「依序讀三份檔」（philosophy / content / voice），但那三份檔當時不存在。0428 跑 fresh session 時 AI 直接違規寫稿、frontmatter 硬填讀過了。這個 skill 設計時把那次 incident 內化為強化版 loading guarantee——三件事缺一即 FAIL，不是 nice-to-have。
簡要 schema（complete spec 在 reference）
posts：N 條完整文字，每條 position / text / char_countreferences_read_in_order：true（audit trail）read_evidence：逐字引用 stage-5-draft.md 末尾的 Read Evidence Phrase（grep-able 證據）voice_self_check_results：reference 內的 self-check checklist 通過記錄lint_passed：true（v2 新增；字句層 Lint 3 條 hard rule 全過——細則見 stage-5-draft.md「字句層 Lint」段）- 字數：每條 80–300 / 整串 ≤ 2000
Gate 5→6 提醒
references_read_in_order 缺、read_evidence 缺或不符 phrase、lint_passed 缺或 false（v2 新增）、字數超範圍、整串字數 > 2000、結構名（PREP / 鉤子 / SCQA / Hook / P1/P2 ⋯）漏出正文 = Gate FAIL。寫作品味問題（贅詞 / 評論體 / 教訓體 / self-deprecation / AI 整齊感）不是 Gate FAIL，由 user 在 Stage 5/6 用編輯眼光審。
Stage 6 — Review（CLI inline）
Artifact：drafts/<slug>.review.md
步驟
- 跑 CLI：
threads-advisor review drafts/<slug>.draft.md
- CLI 吐出 6 維度建議（鉤子 / 焦點 / 收穫 / position 一致性 / 受眾匹配 / 結構）
- 把 CLI 原始建議完整貼進
review.md 的 cli_suggestions 欄位
- 跟 user 一起決定採納哪幾條，寫進
user_accepted 欄位
- 採納的修改套回
draft.md，applied_to_draft: true
Gate 6→7 提醒
cli_suggestions 為空（CLI 沒跑或 output 沒貼）user_accepted 未明確列出哪幾條applied_to_draft: true 但 draft.md 未實際更新- 跳過
advisor review CLI 直接宣告 review 完成
任一 = Gate FAIL。
Stage 7 — Publish（CLI inline）
Artifact：drafts/<slug>.published.md
步驟
- dry-run 預覽：
threads post publish-chain drafts/<slug>.draft.md --dry-run
- user 看 dry-run 輸出，**user 必須在本 session 明確說「發」**才能進下一步
- 真發：
threads post publish-chain drafts/<slug>.draft.md --confirm --yes
- 寫
published.md：post_id / published_at / dry_run_confirmed_by_user: true
Gate 7（發文前最後一道）
--dry-run 預覽完成- user 看過 dry-run 輸出
- **user 明確說「發」**才執行
--confirm --yes
- 發文後
post_id 寫進 published.md
未跑 dry-run 直接 --confirm --yes / dry_run_confirmed_by_user: false 卻 publish / post_id 為空 = 違規。
什麼時候不要用這個 skill
- Stage 0 angle 還沒鎖定 → 用
threads-angle-gate。本 skill 拒絕在沒有 Gate 0→1 PASS 的 angle.md 上開工。
- 要修現有 draft、不重寫 → 直接
threads-advisor review drafts/<slug>.draft.md，不必跑全 pipeline。
- 純 CLI ops（發、查、刪、insights） → 用
threads-cli。
- 要看歷史數據做決策 → 用
threads-advisor analyze。
- 要重想角度（推翻現有 angle.md） → 退回
threads-angle-gate 重跑 Stage 0，不要在本 skill 內 patch。
Reference files
本 skill 採 conditional loading——進入 Stage N 時讀對應 reference，不要一次全載：
| Reference | 何時讀 | 涵蓋 |
|---|
references/writing-philosophy.md（v2 新增） | 進入 Stage 1 + Stage 5 時 | 軸心擺位（show, don't tell）+ 5 個延伸 + 三篇範例引用 |
references/stage-1-framework.md | 進入 Stage 1（選框架）時 | 16+1 框架公式 + (a)(b) process-driven 兩型（v2 新增）+ 4 類結尾 + 選擇指南 + Gate 1→2 checklist |
references/stage-2-plan.md | 進入 Stage 2（規畫骨架）時 | 6 章節結構 + 字數預算 + 骨架欄位規範 + Gate 2→3 checklist |
references/stage-3-algo.md | 進入 Stage 3（演算法 mapping）時 | mapping 規則 + 主訴/避開機制 + 指向 threads-algorithm-skill + Gate 3→4 checklist |
references/stage-4-interaction.md | 進入 Stage 4（互動設計）時 | 5 類型 + 數量規則（2–3） + example_phrasing 規範 + Gate 4→5 checklist |
references/stage-5-draft.md | 進入 Stage 5（寫稿）時 — 強制讀 in full | voice patterns + Voice Hard Lint + 7 條寫作技巧筆記 + 字句層 Lint（v2 新增）+ voice_self_check checklist + Gate 5→6 checklist |
Stage 6 / Stage 7 步驟 inline 在本 SKILL.md 裡（CLI 命令很短，抽 reference 反而空殼）。
跟其他 skill 的關係
threads-angle-gate（Stage 0）：本 skill 的前置。沒有它的 angle.md 不准開工。threads-algorithm-skill（global）：Stage 3 必 consult，提供 26 機制清單。不要編造機制名稱。threads-cli：Stage 7 publish 透過它的 threads post publish-chain 命令；Stage 6 review 透過 threads-advisor review（advisor 在 threads-cli 旁的姊妹 binary）。threads-advisor analyze：跟本 skill 平行——分析既有發文表現、不寫新貼文。
變更歷史
- 2026-04-30 v1：取代
docs/dev/advisor-pipeline-schema.md 作為 Stage 1–7 的 source of truth。把 schema 規範重組成 skill body + 5 份 reference + conditional loading。Stage 5 reference 從「依序讀三份不存在的檔」改成「讀 stage-5-draft.md + angle.md source_quotes」（修補 schema 0427 v1 的 reference broken 缺口）。
- 2026-04-30 v1.1：subagent fresh-context 驗證後修補兩個 audit-trail 缺口。Stage 3 加
algo_skill_source + mechanism_source 欄位（指出 26 機制散在 5 份 reference，要求 artifact 聲明 source 路徑，擋「engagement chain（推測延伸）」這類腦補）。Stage 5 加 read_evidence 欄位 + 末尾 Read Evidence Phrase（讓 references_read_in_order: true 從純自報 boolean 升級為 grep-able 證據）。「先 1 後 2」順序改成「進 Stage 5 後才 Read」（fresh evidence，擋「之前讀過」鑽法）。
- 2026-05-04 v2：寫作哲學 + 軸心 reference 落地。新增
references/writing-philosophy.md（軸心 show, don't tell + 5 延伸 + 三篇範例引用，描述性 reference 不 gate）。Stage 1 框架庫加 (a) Narrative-arc / (b) Thesis-argumentation 兩型 process-driven 框架（不刪舊的 16+1）。Stage 5 加字句層 Lint hard rule（採範例 3 的 13 條裡的條 7/9/13：字短料多 / 刪雜質 / 一篇一個重點），新增 lint_passed: true frontmatter 欄位 + Gate 5→6 checklist 項目。threads-angle-gate skill 不動（避免訪談紀律 overload）。Spec：docs/superpowers/specs/2026-05-04-threads-write-post-v2-design.md。
