kilaslab/kilas-content

內容：規劃與創作

規劃一個品牌的內容並從頭到尾產出：經過研究的故事、能吸引注意力的鉤子、沒有人工智慧痕跡的文案、以品牌設計為基礎的建置，以及每個頻道的發布表。所有品牌特有的內容都存放在 品牌資料包 中；此方法適用於任何品牌。框架可在 Figma 中建置，或寫成 HTML 再轉換為 PNG，端看品牌在設定時的選擇。

文字決定人們是否會停下來觀看。 大部分的心力應投入在研究和寫作上，然後才進入 Figma 或相機。在開始寫作之前，請先閱讀 references/writing-craft.md 以及兩個實作範例：references/examples/linux-7.4-carousel.md（新聞紀錄）和 references/examples/ai-cost-js-carousel.md（他人的實驗）。每個範例都列出了被淘汰的草稿及其原因；模仿其手法，而非句子。

每次執行都從這裡開始

scripts/、references/、templates/ 和 brands/ 的路徑位於此技能資料夾內；content/ 則位於你工作的專案中。請從專案根目錄執行指令，並使用技能的路徑，例如 python3 <skill>/scripts/new_item.py content ...（<skill> 是此檔案所在的資料夾）。使用 Pillow 的腳本（contact_sheet.py、slides_to_pdf.py、artefact_marks.py、ref_sheets.py）執行時不需加上 python3 -I。

0. 設定檢查。 讀取專案中的 content/setup.md。如果該檔案不存在，表示這是首次執行：請先執行 setup-content 技能（已一同安裝；在此儲存庫的 ../setup-content/SKILL.md 中；請叫用該技能，或手動按照指示操作），然後再進行其他步驟。它會詢問品牌名稱，在獲得許可後從其網站和個人檔案收集該品牌自有資產，選擇渲染器（Figma 或 HTML → PNG），然後寫入品牌資料包。
1. 尋找品牌資料包（brands/README.md）：專案中的 content/brand/，否則為此技能中的 brands/<name>/。讀取 brand.md、design.md，以及 content/brand/assets/README.md（如果有的話，該品牌自己的照片和圖示優先於圖庫素材）。任何標示為 (proposed) 的項目都尚未定案；如果計劃需要依賴它，請先提問。
2. 盤點工具並使用每一項有幫助的工具（references/research-tools.md）：網路搜尋、網頁擷取、真實瀏覽器（ego-browser）、社群媒體 MCP 或內建的 X 存取功能、Figma MCP，以及圖片生成：如果你有自己的圖片工具（Grok Bot 的 Grok Imagine、Codex、ChatGPT、Antigravity），則優先使用；否則使用 python3 <skill>/scripts/gen_image.py detect（agy、OpenAI、Gemini、xAI 金鑰）。記錄缺少了哪些工具。
3. 尋找工作區（templates/workspace.md）：content/ 包含 plan/、items/、reviews/、ideas.md、design-log.md。首次使用時請建立它。
4. 選擇下列模式。

使用者想要	模式
一份計劃、一份行事曆、「這個月的內容規劃」	規劃
單一作品：輪播、單圖、串文、Reels 腳本、LinkedIn 貼文、文章	創作
從單一來源製作多個作品	改寫
了解哪些有效、哪些需要改變	審查
設定新品牌、變更渲染器或更新資產	設定（setup-content 技能）

規劃

1. 讀取輸入（references/planning.md 第 1 節）：品牌資料包、上次審查結果、ideas.md、該月的重點時刻（驗證日期）、產能、擁有者的目標。
2. 從 templates/plan-month.md 寫入 content/plan/YYYY-MM.md：各支柱主題的佔比、各系列的節奏、約四分之一的位置保留給反應式內容、每個強項作品切割成 3 到 5 種格式並分散在不同日期。
3. 執行 python3 <skill>/scripts/check_plan.py content/plan/YYYY-MM.md --brand <pack>/brand.md，直到沒有 FAIL 為止；對於你在計劃備註中保留的任何警告，請予以說明。
4. 回報：用三行描述該月份、哪些項目為提案且需要確認、以及缺口。

創作

1. 項目資料夾：python3 <skill>/scripts/new_item.py content <date> <slug> <format>。
2. 研究（research-tools.md）：主要來源、向下探索一層連結、發布後的更正、具名人物自己的話、本地觀點、每個數字至少一個次要來源。
3. 在 brief.md 中撰寫故事（writing-craft.md 第 1–4 節）：五個問題、轉折點、階梯（新聞、測試、參考清單，或來自 copy-playbook.md 的評分量表）、值得儲存的投影片或貼文、五個鉤子（至少三種形式，並經過門檻與對決篩選）、一個隱喻家族及其動詞行。
4. 針對該格式在 copy.md 中撰寫文案（references/formats/：carousel.md、single-post.md、x.md、threads.md、linkedin.md、reels-tiktok.md、long-form.md），並在每個數字、姓名和引用下方加上 > 來源註記。每個標題都必須通過「然後呢？」的考驗，且隱喻至少出現在三個標題中；免責聲明應放在 writing-craft.md 第 7b 節所規定的位置；行動呼籲必須通過「誰、用什麼、何時」的檢驗。接著執行 python3 <skill>/scripts/lint_copy.py <item>/copy.md --format <format> --brand <pack>/brand.md，必須回傳 0（new_item.py 會印出正確的 --format：thread 會以 x 格式進行檢查，document 會以 linkedin 格式進行檢查）。閱讀其警告和僅標題的閱讀報告；將該報告寫入 brief.md，並大聲朗讀一次文案。
5. 圖片（image-sourcing.md）：證據框架使用真實的製品；對於隱喻框架，優先使用品牌自己的照片，然後是自動生成的圖片（你的圖片工具優先，接著是 agy，最後只有在 content/setup.md 允許的情況下才使用付費 API），最後是 Unsplash；保持視覺同一性，並從資訊清單中保存出處。擁有者可以隨時切換圖片工具或停止生成。
6. 選擇配色方案與版面配置（design-variety.md）：該系列的配色方案，或者對於單一作品，選擇先前作品未使用過的配色方案；然後根據每張投影片的任務以及 content/design-log.md 中記錄的近期使用情況，為每張投影片選擇一個變體，確保沒有兩個作品看起來相似。將它們寫入 brief.md 的「設計」表格中，包含一個標題標記樣式和一個打破模式的投影片。品牌資料包的圖庫頁面（Figma）或 content/setup-gallery/*.jpg（HTML），以及 refs/（如果資料包中有），會顯示可用的選項。
7. 使用 content/setup.md 中指定的渲染器進行建置（design-system.md）；當它指定兩者時，請遵循其規則決定哪些作品使用哪種渲染器，否則請詢問：
   • Figma（figma-mechanics.md）：使用 scripts/figma-helpers.js 中的版面配置函數，該函數由 scripts/figma_bundle.py --brand <pack>/design.md --page "<name>" --scheme <scheme> --n <frames>（工具接受 50,000 個字元）與資料包的 BRAND 區塊捆綁，放置在品牌 Figma 檔案的一個新頁面上；切勿觸及其他頁面。上傳圖片，然後使用配色方案的配對（duotone(id, 'light' | 'dark')）在第二次呼叫中調整色調。
   • HTML → PNG（html-render.md）：scripts/new_html.py 會在項目的 html/ 資料夾中設定所需的套件和品牌的 CSS；使用套件的版面配置、將選定的照片和生成的圖片複製到 html/img/ 中來撰寫 slides.html；scripts/render_slides.py 會為每張投影片渲染一個 PNG。 Reels：storyboard.md + 一個 1080×1920 的封面框架（Figma，或按照 html-render.md 第 4 節所述作為獨立的 HTML 頁面）。
8. 廉價驗證：先檢查版面配置（Figma 中的 layoutCheck()，HTML 中 render_slides.py 列印的問題）並修正其回報的內容；然後查看封面、資料框架以及變更的部分（在 Figma 中一次截圖一個；在 HTML 中則檢視 PNG）。如果使用者停止截圖，請停止並告知哪些框架未經檢查。
9. 發布表：publish.md，包含每個頻道的文字、在限制內的 hashtag、替代文字、時間、連結、出處；在 content/design-log.md 中新增一行。發布是擁有者的步驟，除非他們明確要求你透過已連接的工具發布特定作品；請先確認。
10. 回報：位置、兩行摘要說明的方向、選擇的版面配置、哪些已驗證及未驗證、你擁有及缺少哪些研究工具，以及說明文字。

改寫

一起規劃要切割的內容（planning.md 第 6 節），一個項目資料夾，計劃中每個切割內容一行。每個切割內容都需根據其格式重新撰寫（references/formats/），能獨立表達完整意思，並連結回原始內容。輪播框架可同時作為 LinkedIn 文件（scripts/slides_to_pdf.py）和 Threads/TikTok 的圖片貼文。

審查

從 templates/review-month.md 寫入 content/reviews/YYYY-MM.md：僅從平台或擁有者取得數據，並標註日期；將每個作品與該品牌在其格式上的中位數進行比較；針對每個系列決定繼續、修正或停止；將這些決定帶入下個月的計劃中。如果沒有共享數據：列出需要收集的項目，然後停止。

最重要的寫作規則

完整方法在 writing-craft.md 中，規則在 copy-playbook.md 中，語言在 language/<lang>.md 中。

• 鉤子 = 精確數字 + 場景 + 利害關係，或者 writing-craft.md 第 3b 節中六種形狀之一。寫出五個鉤子（三種形狀），通過門檻（≤30 字、平實、無免責聲明、誠實、保留答案、有張力），讓倖存者進行對決，並說明每個失敗者為何失敗。不要為它們評分：自我評分會產生成績相同的結果。
• 標題是帶有後果的主張：每個標題都必須通過「然後呢？」的考驗。主題詞放在眉標中。標記出承載主張的一到兩個字。
• 一個隱喻家族，只說一次，然後在至少三個標題的動詞中體現。
• 在故事後期放一個轉折點；一個值得儲存的框架或貼文。
• 回到受眾身上：受眾自己的價格、日期、地點、公司或行動。
• 數字要公平比較，圖表從零開始，保留原文的模糊用語，第一人稱僅用於品牌實際做過的事。
• 模糊用語留在句子中；免責聲明有預算：封面或標題中不使用免責聲明，數據投影片一個，意見投影片一個，其餘放在說明文字中。
• 意見需要標示，並以一個通過「誰、用什麼、何時」檢驗的行動作為結尾。
• 一個行動呼籲來自品牌資料包；承諾描述該作品剛才達成的效果。
• 語言來自品牌資料包；僅在使用者明確要求該作品使用另一種語言時，才能使用其他語言。
• 無陳腔濫調的開場白，無人工智慧痕跡；檢查工具會捕捉大部分問題。

品質檢查清單

• 已讀取品牌資料包；未經詢問，不得將任何標示為 (proposed) 的項目視為已定案使用。
• 每個可用的研究工具，只要有所幫助都已使用；已回報缺少的工具。
• 五個故事問題已回答，並包含本地觀點；已放置轉折點。
• 已進行鉤子工作坊，包含門檻和對決；封面文字不超過 30 字，無免責聲明，且能獨立運作。
• 僅標題的閱讀報告已寫入 brief.md 並能講述故事；隱喻出現在至少三個標題中；有一個值得儲存的作品，並已命名。
• 行動呼籲通過「誰、用什麼、何時」的檢驗。
• lint_copy.py 針對該格式回傳 0；每個數字、姓名和引用都有來源註記。
• 已遵守平台限制（formats/specs.md）：hashtag、字元數、安全區域。
• 已在 brief.md 中為每張投影片選擇版面配置；封面和標題標記與 content/design-log.md 中先前的作品不同；有一張投影片打破模式。
• 已套用一種配色方案；在合適的地方使用了品牌自己的照片；已調整照片色調；螢幕截圖為彩色、未經修改、保留出處，並以螢光筆標記。
• 版面配置檢查通過（Figma 中的 layoutCheck()，HTML 中的 render_slides.py）或已說明每個註記；已查看封面和資料框架（或已回報缺少的部分）。
• 結尾：一個行動呼籲，所有來源和出處；生成的圖片已標示為插圖。
• publish.md 已完成，並在 content/design-log.md 中新增了一行；未經明確同意，不得發布、按讚或追蹤任何內容。
• 計劃已通過 check_plan.py 檢查。

檔案對應表

檔案	何時讀取
brands/README.md、brands/<brand>/brand.md、design.md	每次執行
../setup-content/SKILL.md、references/brand-onboarding.md	首次執行（無 content/setup.md）、新品牌、新渲染器
references/planning.md	規劃、改寫、審查
references/writing-craft.md、references/examples/*.md（兩個已完成的輪播範例，包含被拒絕的草稿）	在開始寫作之前
references/copy-playbook.md	框架、copy.md 格式、行動呼籲、說明文字
references/language/id.md、en.md	品牌的語言
references/formats/*.md	正在製作的格式；specs.md 用於限制
references/design-system.md、design-variety.md、design-references.md	在建置框架之前：角色、版面配置變體及如何選擇、來自其他帳號的模式
references/figma-mechanics.md	在首次使用 use_figma 之前；上傳、雙色調、螢幕截圖
references/html-render.md、templates/html/	HTML → PNG 渲染器：設定、類別參考、渲染、檢查
references/image-sourcing.md、research-tools.md	研究和圖片
references/patterns-from-data.md	規則為何如此制定
references/prerequisites.md	安裝輔助工具和可選工具
templates/	工作區、設定、計劃、簡報、發布、審查、想法、設計記錄；html/（投影片套件和範例）
scripts/	lint_copy.py、check_plan.py、new_item.py、figma-helpers.js（版面配置、配色方案）、figma_bundle.py、figma-gallery.js + figma-gallery-2.js、figma-gallery-schemes.js、brand_css.py、new_html.py、render_slides.py、crawl_site.py、capture_profile.sh、artefact_marks.py、ref_sheets.py、slides_to_pdf.py、capture_artefact.sh、x_post.py、scan_site_tokens.sh、unsplash_search.py、gen_image.py、agy_image.sh、contact_sheet.py、export_oss.sh

何時不使用此技能

不適用於投影片簡報或簡報（請使用投影片技能），不適用於建立網站，也不適用於修正現有貼文中的一個字（請直接編輯該貼文）。