social-post skill

一個可安裝到 Codex 或 Claude Code 的社群內容 Skill：學習本機聲線、規劃內容、撰寫平台化貼文、經確認後發布，以已登入 Chrome 受控管理 FB／IG／Threads 留言，並把跨平台洞察保存成可驗證的結構化資料。

目前穩定標籤：v2.5.0；main 已同步 Unreleased candidate。

Unreleased candidate 有封閉 JavaScript 模組清單、固定 browser-runtime revision／雜湊、架構自校準與單次送出／異常恢復的回歸測試。另已完成一次 IG 真實單次送出、原生子回覆查證與唯讀 recovery 對帳；這些證據不代表三平台 live Meta 回覆已解鎖。

main 已分開掃描與送出開關：受控、指定 scope 的來源綁定掃描可用；live_browser_actuation_enabled 仍預設為 false。真實送出／結果回讀未完成三平台 canary，不能宣稱全面自動回覆已完成。

本候選版尚未通過嚴格完成檢查：Cleanup 仍有 12 項過長文件／模組／函式的 REVIEW，且跨語言、私版 Git 與更新來源覆蓋保留 NOT_CHECKED。發布候選程式不等於解除這些項目；穩定標籤仍為 v2.5.0，沒有新建正式 Release 或升級 production capability。

Unreleased on main

• 新增 observeTargetComment：只回填一則指定原生留言，保留完整作者／本文與來源憑證，不冒充整篇掃描完成。

• 新增獨立的單則 IG executeCanaryReply 候選入口：只能使用已核准 action、最長 300 秒且限一次的來源綁定 lease；正式送出開關維持關閉，不因 canary 自動升級三平台能力。

• 一次真實 IG 執行已驗證「單次送出 → 即時回讀不足而停止 → 新 session 唯讀 recovery → 原帳本確認 sent」，沒有重送；真實本文、帳號與回覆連結只保留在私人帳本。

• 修正原生 textarea 以目前 value 綁定節點，並在刻意選擇父留言後綁定選中的編輯器；填字與後續 claim 前的穩定節點檢查仍嚴格保留。

• IG 原生回覆保留平台自動產生的 @mention，先確認完整回覆串與零自己回覆；以實際頁面連續核對處理巢狀展開與延後載入，不假造瀏覽器未提供的 document epoch。未知結果停止並進入唯讀對帳。

• 新增 default-only executeApprovedReply 候選入口與 read-only recovery，拒絕 caller tab／action／selector／callback；原核准文字、帳號、貼文、留言及原 attempt 都必須一致。

• 更新 Codex Chrome runtime 固定版本至 26.825.51511，保留 bytes／SHA-256 驗證。

• Threads 的指定樣本已核對原留言、完整本文、帳號、零回覆與回覆視窗；未實際送出。FB 已辨識既有自己回覆，但完整展開與編輯器選定父層尚未驗證。IG 新增原生留言頁的帳號、完整本文、父子留言、正數回覆展開及原生 mention 編輯器驗證，錯帳號／作者／截短本文均拒絕；真實送出仍限獨立 canary，不代表泛用路徑已開放。

• 修正 Facebook story query 身分保留與完整度判定；支援 Instagram 同一 shortcode 的 p/reel/reels/tv 網址及 /p/S/c/P 留言，拒絕跨貼文、重複或矛盾識別欄位。IG 內顯示的 Facebook 留言數不得混入 IG 掃描。

• 公開版本只含通用程式與匿名測試。真實留言、草稿、帳號洞察、原文、照片與私人憑證不在發布範圍內。

• 結構化分析不只保存成效數字，也保存原文 SHA、確定性長度、版型／黑底白字屬性、關鍵字、實體、數字語言、voice、CTA、完整 Unicode 標點，以及日期、星期、HH:mm 與 daypart。

• 新增 coverage gate，逐篇證明完整原文、長度、版型、關鍵字、語氣、標點、發文時間與 outcome 確實進入 feature matrix；每個適用的平台 analytics 子樹另有 exact-compare 維度，未被固定 schema 命名的新欄位也會進 extended_analytics，低信心 placeholder 不會混入規律。

• P0 規劃與 P2 撰稿必須先讀 canonical comparables／context；只有同平台、同 maturity、同 content type 與同 surface 才能比較 outcome。

• 發文分鐘只作候選變因，causal_claim_allowed:false；不會因兩篇同時發文就把流量差歸因於時間。

• FB／IG／Threads localhost Browser E2E 已通過：每平台各掃描兩則、只接受一次送出、正確 parent 與 exact reply 均可驗證。證據仍是 localhost_test_only_candidate、in_memory_test_only，promotion 與 live actuation 都保持 false。

• 修正 contenteditable readback、跨 realm submit schema、導頁後平台／帳號／貼文 readiness gate，以及每次 attempt 明示 test_only。

• 唯一核准的 browser-client lazy import 現在會在載入前驗證固定 revision、bytes 與 SHA-256，並寫入 architecture receipt；缺檔、重複 import、eager import 或任一欄漂移都 fail closed。

v2.5.0

• 新增模組化 live-DOM actuator contract：薄 facade 分離 scan、send 與本機 durable claim bridge，掃描、preflight、單次送出、送後驗證與重新對帳都有可執行負向測試。
• 核准文字會重算 SHA-256，action、fresh locator plan、強留言 anchor、同一父層 reply controls 與零 exact-own baseline 全部綁入 preparation；可變 locator expected 不能覆蓋核准證據。
• 不再接受裸字串 WRITE_OK。browser-begin 必須先原子寫入 append-only ledger，才輸出逐欄綁定的 SUBMIT_CLAIM；process-wide reservation 與 durable ledger 共同阻擋併發、actor 重建及跨程序重播。
• 送後只有完整展開、所有 reply item 可檢查、正確父層從 0 變成恰好 1 份 own-account exact reply，而且總回覆數至少為送出前基線＋1 才能成功；回覆總數倒退、pre-existing、hidden、malformed 或 duplicate evidence 都 fail closed。
• fixture receipt 明示 test_only:true，Python live ledger 直接拒絕；URL 也拒絕 credentials、非預設 port、不同 host／path／query。
• browser-scan 現在持久化 completion event，可區分「request 還沒執行」與「已完整掃描但零留言」。
• 任一同 session／同平台／帳號／貼文的回覆進入 needs_reconcile，後續 action 與 preflight 都會被 circuit breaker 阻擋，直到完成對帳。
• FB／IG／Threads fixture 改為真實互動頁面：驗證 exact own reply、正確 parent、一次 accepted submit、composer 清空與 submit disabled。
• 新增 closed-world capability ledger，明確分開 contract 綠燈、真瀏覽器 fixture 與 live Meta canary；缺 Browser backend 或登入授權時不冒充完成。

v2.4.0

• P5 從操作手冊升級成可執行的 Chrome action／receipt bridge：browser-scan-request → browser-scan → browser-action → browser-begin → browser-finish → browser-reconcile。
• 掃描 scope 會先寫入有 session 與期限的 append-only request；Chrome 不能從目前頁面自行決定帳號或貼文，每則 comment anchor 也必須綁定核准貼文。
• 每次送出會綁定 action、一次性 permit、session、平台／帳號／貼文／留言、本文 fingerprint 與最終 reply hash。
• 送出前驗證貼文 URL、空白 composer、填入後 exact text 與 60 秒 freshness；送出後只有六項畫面證據全成立才記為 sent_verified。
• 任何 timeout、導頁、矛盾狀態或不明結果一律 needs_reconcile，不自動重點；重新檢視仍不確定就保持 NO_CHANGE。
• 正式 ledger 會拒絕可繞過 bridge 的 raw begin／finish／reconcile；三平台匿名 fixture 與負向測試可安全開源。

安裝

git clone https://github.com/Hao0321/claude-skill-social-post.git

Codex（Windows PowerShell）：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills" | Out-Null
Copy-Item -Recurse ".\claude-skill-social-post\social-post" "$env:USERPROFILE\.codex\skills\social-post"

Claude Code：把目的地改成 .claude\skills\social-post。macOS／Linux 可複製到 ~/.codex/skills/social-post/ 或 ~/.claude/skills/social-post/。

首次使用先建立只存在本機的個人檔：

cd social-post
Copy-Item style_profile.example.md style_profile.md
Copy-Item content_plan.example.md content_plan.md

再把 voice_quick.md 與 current_brief.md 的 placeholder 換成自己的方向。

六個 Mode

Comment Ops 快速開始

P5 不串 Meta API，也不匯出 Chrome Cookie 或 session。預設是 batch_confirm，不提供 24/7 背景監聽或無邊界全自動模式。main 的受控掃描與送出採獨立政策；核准回覆不會繞過 default-off 送出開關。實際 Chrome 操作需要 chrome:control-chrome、使用者既有登入狀態與來源綁定 adapter。已驗證的單則 IG canary 不代表其他留言、平台或批次路徑已驗證。

Codex 與 Claude Code 都能使用 P0–P4、P5 的離線草稿／政策／ledger／測試功能。現有 existing-session Chrome runtime 則固定依賴 Codex bundled Chrome revision；Claude Code 或獨立公開 clone 找不到精確 runtime 時會 fail closed，不會改走未審核的瀏覽器路徑，也不代表 Claude 安裝已具備 live Meta 控制能力。

$env:PYTHONUTF8='1'
python scripts/comment_assistant.py validate
python scripts/comment_assistant.py queue --format json
python scripts/comment_self_test.py
python scripts/comment_capability_gate.py
node scripts/comment_chrome_actuator_test.mjs
node scripts/comment_chrome_claim_bridge_test.mjs
node scripts/comment_chrome_claim_integration_test.mjs
node scripts/comment_js_architecture_gate.mjs --self-test

實際流程與停損條件見 comment-operations.md，JSON bridge contract 見 chrome-comment-adapter.md。定位依當下可見 DOM／accessibility state 建立，不使用一組長期寫死的 Meta selector。所有 ledger command 預設 dry-run，明確加上 --write 才會寫入本機。

Outcome 快速開始

$env:PYTHONUTF8='1'
python scripts/log_outcome.py references/outcome-bundle.example.json
python scripts/self_test.py
python scripts/social_data.py validate
python scripts/social_data.py coverage
python scripts/social_data.py summary --series demo-series

正式寫入時才加 --write。修正既有 event 可參考 correction-bundle.example.json。

隱私邊界

公開 repo 只收 schema、工具、匿名規則與明示為 fictional 的例子。不要提交：

• style_profile.md、content_plan.md、drafts/；
• data/*.jsonl 的真實 outcome／correction；
• comment_events.jsonl、reply_events.jsonl、browser_scan_requests.jsonl 的真實留言、作者、貼文、回覆與掃描目標；
• 原始洞察截圖、caption archive、帳號名稱、個人路徑；
• 私人 JSONL 貼文／成效／correction／帳號資料與 .rd receipts／canonical ledger；
• Cookie、session、access token、瀏覽器 profile、登入資料；
• 從私人數據升級出的規則、公式或案例。

驗證

python social-post/scripts/self_test.py
python social-post/scripts/social_data.py validate
python social-post/scripts/social_data.py coverage
python social-post/scripts/comment_assistant.py validate
python social-post/scripts/comment_capability_gate.py
node social-post/scripts/comment_chrome_actuator_test.mjs
node social-post/scripts/comment_chrome_claim_bridge_test.mjs
node social-post/scripts/comment_chrome_claim_integration_test.mjs
node social-post/scripts/comment_js_architecture_gate.mjs --self-test

License

MIT。Copyright holder：Hao0321 contributors。