Communitygithub.com

lizTheDeveloper/make-zines

一個 AI Agent 技能,能將主題、貼上內容或完整稿件轉化為完整的 zine,包括編輯計畫、稿件、頁面 JSON、渲染頁面以及可供印刷的 PDF。

make-zines 是什麼?

此技能專為需要將各種來源的素材自動化轉化為 zine 的開發者與 AI Agent 使用者設計。它能根據提供的素材類型(主題、任意內容、完整稿件、現有 JSON 或部分完成的 zine)選擇最合適的處理路徑,並引導使用者完成編輯、頁面規劃、JSON 生成與渲染。透過結構化的編輯流程,此技能能確保 zine 的一致性、連貫性與高品質,同時支援多種產出格式,包括頁面 JSON、圖片資產與可供印刷的 PDF。它與支援 markdown 與 JSON 的工具鏈無縫整合,並包含驗證與品質保證步驟,以確保最終產品的正確性與專業性。此技能的核心價值在於減少重複性手動工作,讓使用者能專注於創意與內容本身。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add lizTheDeveloper/make-zines

在你喜歡的 AI 中提問

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

說明文件

製作 Zine

將 zine 視為一個編輯與生產系統。將頁面 JSON 視為中間產物,而非必備輸入。

路由請求

選擇最簡便的路徑:

  • 主題或種子: 先引導使用者進行簡短的問答,然後撰寫並設計 zine。
  • 任意內容: 將其吸收,識別其論點與可用素材,提出頁面規劃,並在不需要使用者自行結構化的情況下進行轉換。
  • 完整稿件: 保留其意義與語調;僅按照要求的程度進行編輯;將其分頁並設計。
  • 現有 JSON: 驗證並修復,然後渲染或修訂。
  • 部分完成的 zine: 沿用其已建立的編輯語調與視覺系統。

不要詢問已由提供的素材或對話脈絡回答過的問題。

需求蒐集

當使用者要求協作,或所做的選擇會實質改變結果時,一次只問一個問題。否則,推斷合理的預設值並簡潔地說明。按順序解決:

  1. 目的與目標讀者
  2. 來源素材與必要的主張
  3. 期望的尺寸或大致頁數
  4. 語調、閱讀難度與編輯立場
  5. 視覺參考、格式與印刷/數位輸出目標
  6. 必須包含的、排除的內容、引用、致謝與行動呼籲

如果使用者說「讓我很驚喜」,就直接進行。如果未指定頁數,對於需要摺疊印刷的 zine,選擇 4 的倍數;否則選擇能支撐素材的最短長度。除非使用者另行指定,否則將封面視為頁面。

編輯流程

  1. 吸收所有素材。區分直接來源主張、詮釋與建議新增內容。
  2. 陳述 zine 的一句話承諾與編輯主軸。
  3. 建立頁面對照表,包含頁碼、任務、關鍵訊息、文案預算與視覺功能。
  4. 在進行視覺渲染之前,先撰寫完整的稿件。撰寫標題、內文、圖說、側邊欄、重點提示、致謝與封底文案。
  5. 檢查節奏:交替安排資訊密集與輕鬆的頁面;創造開場鉤子、逐步升溫、統整與令人滿意的結尾。
  6. 檢查忠實度:切勿編造引用、事實、引文或源自來源的主張。當需要或要求進行全新研究時,使用權威來源並在稿件與 JSON 中保留網址。
  7. 當使用者要求協作流程時,取得使用者對稿件/頁面對照表的核准。如果他們要求立即完成,則繼續自主進行。

保留既有作者語調。不要將挑釁、有趣、政治、技術性或獨特的素材扁平化為通用的行銷文案。

頁面 JSON

在建立或修復 JSON 之前,請閱讀 references/page-spec.md。產出有效的 JSON,而非 JavaScript 或類似 Markdown 的偽 JSON。將文案保留為語意欄位;切勿將版面指示烘焙到可見文案中。

建立兩個層級:

  • zine:出版品級別的中繼資料、編輯規則、視覺系統、連續性規則與匯出設定。
  • pages:有序的頁面物件,包含確切的文案、版面模組、美術指導、無障礙文字與連續性參考。

為重複出現的角色、圖示、貼紙與元件使用穩定的 ID。允許頁面特定的覆寫,而無需複製整個全域系統。

在渲染之前,對已儲存的 JSON 執行 scripts/validate_zine_json.py。修正每個錯誤;審慎檢視警告。

渲染策略

根據內容而非習慣選擇製作方法:

  • 對於文字密集的頁面與精確排版,使用確定性的 HTML/CSS、SVG、Canvas 或文件版面配置。
  • 對於插圖、紋理、封面、拼貼元素與以美術為主的頁面,使用圖片生成。
  • 對於結合長文與生成藝術的頁面,在不包含文字的情況下生成藝術,然後在確定性版面配置中合成確切的文字。
  • 不要依賴影像模型來再現段落、引文、網址、程式碼或精確的圖表。

當使用圖片生成時,請閱讀並遵循圖片生成技能。在不同呼叫之間保持角色表與視覺參考的一致性。僅在能夠檢查批次間連續性時,以小批次進行渲染。

預設生產順序:

  1. 建立聯絡單或風格框架。
  2. 核准或推斷視覺系統。
  3. 渲染代表性封面、文字密集與插圖密集的頁面。
  4. 修正系統性問題。
  5. 渲染其餘頁面。
  6. 按閱讀順序組裝,並在要求時,按印刷跨頁順序組裝。

品質保證

在交付前,驗證:

  • 每個規劃的頁面都恰好存在一次,且頁碼是連續的。
  • 所有已核准的文案都恰好出現一次,除非重複是故意的。
  • 沒有提示方向或隱藏筆記以可見文字形式出現。
  • 標題、內文、圖說與網址在最終尺寸下可讀。
  • 安全區域、出血、裁切、邊距、對比度與影像解析度符合輸出目標。
  • 重複出現的角色與圖形母題保持可識別。
  • 主張、引用、引文與致謝是可追溯的。
  • 空白頁、封面與印刷拼版是故意的。
  • JSON 驗證通過,且檔案名稱可自然排序。

對於可供印刷的 PDF,使用 PDF 技能進行組裝與視覺驗證。對於獨立的頁面圖片,在交付前以全解析度檢查代表性頁面。

交付成果

除非使用者縮小範圍,否則提供:

  1. 簡短的創意方向與假設
  2. 頁面對照表
  3. 最終稿件
  4. 經過驗證的 zine JSON
  5. 渲染後的頁面資產
  6. 閱讀順序 PDF,以及要求時的印刷就緒輸出

將可重複使用的成品儲存為使用者可見的檔案。保持檔案名稱專案通用性,例如 {slug}-manuscript.md、{slug}-pages.json、{slug}-p01-cover.png 與 {slug}-reading.pdf。

切勿宣稱未實際發生的渲染或驗證。如果某個生產工具無法滿足精確的文字或版面,請交付完成的稿件與 JSON,並清楚說明剩餘的生產限制。

相關技能