Katib — 網站文案撰寫技能
改編自「AI 市場研究衝刺」（為 ChatGPT 對話撰寫）為代理工作流程。
每個步驟的核心規則：論點優先，文字在後 — 在步驟 1 之前閱讀 references/argument-first.md。
固定順序（絕不跳過，絕不重新排序）
0 初步輸入 → 1 參考頁面審查 → 2 研究 → 3 客戶畫像 → 4 提案摘要 → 5 信念 → 6 網站文案 → 7 最終檢查
路徑
- 技能檔案：相對於此技能的基礎目錄（技能載入時會顯示）。Reddit 工具位於該目錄中的
tools/reddit_fetch.py— 請將其實際的絕對路徑提供給研究人員。 - 客戶資料夾：
<當前專案根目錄>/katib-clients/<客戶代號>/，包含：00-input.md · 01-reference-review.md · 02-research.md · research-raw/ · 03-avatar.md · 04-offer-brief.md · 05-beliefs.md · 06-website-copy.md
每個步驟會讀取它之前的檔案。如果資料夾已存在，讀取它並從第一個遺失的檔案繼續執行（或僅重做使用者指定的步驟）。
步驟
設定（第一次執行，以及執行失敗時） — 檢查 PinchTab：pinchtab --version 和 pinchtab health。
缺失或未登入 → 引導使用者逐步完成 references/setup-pinchtab.md，然後再進行研究。
已正常運作 → 不說話，繼續進行。
0. 初步輸入 — 在一次訊息中詢問任何遺失的資訊：
產品（它是什麼，價格如果已知）、受眾、市場/國家、輸出語言（阿拉伯灣方言 / 現代標準阿拉伯語 / 英語 / 兩者）、
參考頁面截圖（或 URL）、品牌已有的任何資訊（評論、證明、保證、故事）。
寫入 00-input.md。
1. 參考頁面審查 — 遵循 references/sales-page-review.md。寫入 01-reference-review.md。
⏸ 檢查點：顯示結論 + 區塊地圖 + 可借鑒的內容。等待同意。
2. 研究 — 遵循 references/research-method.md 和 references/research-agents.md。
同時啟動 5 個研究代理（R1–R4 + R5 Reddit），合併到 templates/research-doc.md → 02-research.md。
Instagram、TikTok 和已登入的 Reddit 透過 PinchTab 的 research 設定檔讀取（唯讀）；備用方案：使用者的已登入 Chrome（自己的分頁），然後是 Scrapling。如果本地市場資料稀少，R1 和 R5 會擴大到全球相同類型的企業，並用國家標記那些引用。
然後為使用者撰寫 02-research-summary.md：使用使用者的語言，簡短章節搭配表情符號標題
（目標客群 / 夢想 / 痛點 / 責怪對象 / 信念 / 最佳案例 / 競爭對手 / 機制候選 / 警告 / 資訊缺口），每個 1–3 個關鍵引用並標示 [S#]。
⏸ 檢查點：顯示摘要區塊和資訊不足的章節。等待同意（使用者可能會要求深入挖掘）。
3. 客戶畫像 — 僅從 02-research.md 填入 templates/avatar.md → 03-avatar.md。
企業買家 → 「月營業額」；消費者 → 「收入 / 消費能力」。無檢查點；與步驟 4 一起顯示。
超過一個客群 → 每個客群一個畫像檔案（03-avatar-<客群>.md）；使用者決定哪個主導文案。
定位選項（選擇性，當使用者要求時） — 對品牌執行 creator-toolkit:personal-brand-expert 技能
（它也適用於企業），使用 02-research.md 和畫像。寫入 03b-positioning.md，提供多個選項；
使用者的選擇會饋入步驟 4 的大創意。
4. 提案摘要 — 遵循 references/offer-brief-guide.md，按順序填入 templates/offer-brief.md → 04-offer-brief.md。
⏸ 檢查點在欄位 6 之後：為 UMP、UMS、大創意各提供 3 個選項。使用者選擇。然後完成欄位 7–20。
5. 信念 — 遵循 references/beliefs.md → 05-beliefs.md。
⏸ 檢查點：使用者在任何文案撰寫之前批准這些信念。
6. 網站文案 — 遵循 references/website-copy.md，填入 templates/website-copy.md → 06-website-copy.md。
7. 最終檢查 — 執行 references/website-copy.md 的第 4 遍，然後顯示文案、「需要品牌提供證明」清單和未解決的問題。⏸ 使用者批准或要求修改。
嚴格規則
- 絕不編造 引用、評論、數字、研究、人物、價格或保證。遺失 → 詢問或標記。
- 每個研究引用必須逐字引用，並附上已開啟的 URL。客戶畫像引用必須從研究文件中引用
[S#]。 - 絕不複製參考頁面的句子；僅借用結構。
- 以使用者要求的語言撰寫文案。使用平實的文字、簡短的句子。
- 標記涉及健康、金融和法律的主張以進行合規性檢查。
- 使用使用者的語言（通常是海灣阿拉伯語），簡短明瞭地與使用者對話。技能檔案保持為英文。
後續：廣告
尚未建立。當被詢問時，重複使用 04-offer-brief.md 和 05-beliefs.md（每個廣告使用一個信念或大創意）。不需要新的研究。