Communitygithub.com

cnlive860/microscape-poster-skill

一個智能體技能,能將每張照片轉化為高級 3:4 豎版海報:上方是經過展覽級調色的原始照片,下方是相同主題的 3D 厚塗油畫微觀風景,兩者以精確的 1:1 比例分割。

microscape-poster-skill 是什麼?

此技能是一個專門的 AI 代理工具,旨在為攝影作品創作出具有展覽品質的雙重風格海報。它將原始照片的色調分級與 AI 生成的 3D 厚塗油畫微觀風景相結合,以精確的 1:1 上下分割佈局呈現。技能的核心嚴格遵循 `references/original-prompt/zh-CN.md` 檔案中的美學權威,該檔案定義了所有創作決策,從構圖、色彩、紋理到文字邏輯,都不得被其他提示或運行時指令所取代或改寫。支援的平台包括 Claude Code 或類似具有文件操作和圖像生成能力的環境,執行流程包括解析變量、將其附加到完整的源簡報之後、調用圖像生成、並驗證結果。此外,技能提供了豐富的運行時參數,如模式(上下/左右對比或僅設計)、分割嚴格性、尺寸和文字處理方式,並支援高效的批量處理、記憶偏好、以及自適應的能力預檢,確保了用戶體驗的流暢與靈活性。

相容平台✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add cnlive860/microscape-poster-skill

在你喜歡的 AI 中提問

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

說明文件

微觀海報 (Microscape Poster)

以 references/original-prompt/zh-CN.md 作為唯一的創作和美學權威來創建全新的 PNG 藝術作品。此技能是一個運行時外殼:它解析交付變量,將其追加到完整的原始簡報主體之後,執行位圖生成,並驗證結果。它不得書寫第二個藝術方向。

權威邊界

  1. 在每次構建生成請求之前,立即完整閱讀 references/original-prompt/zh-CN.md。
  2. 其第一個 Markdown 標題是一個管理性文檔標籤,而非創作內容。在圖像生成請求中省略該標題,然後逐字複製其餘的整個源簡報主體。不得對該主體進行摘要、翻譯、潤飾、擴展、重新解釋或替換為此文件、README、範例、運行時適配器參考或 references/original-prompt/ 中的閱讀翻譯。該翻譯是為國際讀者和分享而存在;它永遠不是運行時提示的替代品。
  3. 源簡報擁有主體轉換、設計區域內的構圖、色彩衍生、材質、厚塗和顏料紋理、留白、文字數量、措辭邏輯、排版特徵以及禁止事項的決定權。
  4. 運行時指令只能更改:所選的輸出模式、分割嚴格性、最終畫布比例或像素、真實來源的放置或可見性、目標文本語言以及用戶的準確文本。
  5. 將所有運行時指令附在完整的源簡報主體之後。切勿將它們插入或改寫其美學段落。
  6. 源簡報指定了 3:4 的豎版畫布和嚴格的 1:1 上下分割。將這些視為簡報自身的呈現容器。僅當用戶明確要求時,模式或分割塊才能替換該容器;所有其他美學和轉換指令保持有效。
  7. 切勿創建通用調色板、提取額外顏色、鎖定色板集合、發明「美學動機」、預先組合標題、生成文案包或運行外部語義閱讀框架。如果源簡報本身要求執行這些操作,則讓圖像模型在那裡精確執行。
  8. 範例僅顯示成果。不要複製它們的主題、顏色、文字、佈局意外或寬高比。

在整個過程中使用以下角色:

現實視圖 = 上傳的照片,按源簡報指示進行輕微調色
轉換設計 = 源簡報的 3D 厚塗油畫微觀風景

模式名稱不是一個鬆散的提示。對於每個請求的資產,精確附加一個模式塊。切勿將未使用的模式替代方案發送給圖像模型。在選定的合約內,讓圖像模型決定內部比例、裁切、環境延伸、留白、重疊和佈局,除非用戶明確請求精確幾何形狀或源簡報已固定它。

僅解析運行時變量

除非用戶明確要求檢查、編輯、繼續或重複使用已命名的結果,否則每次調用都是一個新任務。重複相同的請求需要重新生成並建立新的任務文件夾;舊的匹配文件永遠不會完成新請求。記住的交付偏好可能會減少重複問題,但永遠不會授權重用舊的源、結果、提示或任務目錄。

默認情況下完全指定

源簡報已經固定了畫布比例(3:4 豎版)、分割關係(嚴格 1:1)、現實來源處理(輕度展覽級調色)和文字邏輯(一個短標題加上最少註釋)。因此,默認交付變量已經完整:

變量當用戶未指定時的默認值
--modetop-bottom
--splitstrict (精確 1:1, 50% / 50%)
--size3:4,根據源轉換為具體像素
--textprompt (圖像模型根據簡報自身的邏輯書寫標題)
--locale用戶當前請求的語言,僅在真正不明確時確認

因此,一個簡單的調用,例如 /microscape-poster <photo> 或 /microscape-poster <directory>,將立即生成,無需設置問卷。僅在變量真正未解決或矛盾時才提問。不要要求用戶重述源簡報已決定的內容。

內聯快速路徑

在調用和輸入之後的任何位置解析參數:

/microscape-poster <source-or-directory> --mode top-bottom,design-only \
  --split strict --size 3:4,2160x2880 \
  --text prompt --locale zh-CN
  • --mode: 一個或多個 top-bottom, left-right, design-only。重複的標誌和逗號分隔的值會累積;接受自然語言等價物和 all / 全部。
  • --split: strict 或 fluid。strict 強制執行源簡報中精確的 1:1 中點;fluid 釋放中點,讓圖像模型平衡兩部分。適用於 top-bottom 和 left-right,對 design-only 忽略。
  • --size: 一個或多個 auto, source, 1:1, 3:4, 4:3, 4:5, 5:4, 2:3, 3:2, 9:16, 16:9, 21:9, 5:7, 7:5,任何自定義比例,或精確的 WIDTHxHEIGHT。重複的標誌會累積;接受 ×。
  • --text: prompt, exact, 或 none。接受舊別名 auto → prompt 和 custom → exact,但不要向用戶顯示舊標籤。
  • --copy "...": 用戶的精確文本;隱含 --text exact。不要改寫或翻譯它。
  • --locale: 可見文本的目標語言、市場或地區。
  • --out: 明確的輸出根目錄。
  • --prefs: last, edit, new, off, 或 clear;控制此次調用是否重用、編輯、忽略、禁止或清除整個家族範圍內記住的交付偏好。

明確的參數覆蓋模糊的散文。多值參數按用戶順序累積並去重;單值參數使用最後一個明確的值。如果每個必需的變量都已解析,跳過預檢並生成。如果值不完整,僅詢問未解析的變量。如果存在直接矛盾(例如 --text none 與 --copy),則需要詢問。

記憶偏好閘道

在解析當前散文和內聯參數之後,完整閱讀 references/runtime-preferences.md 並在通常的預檢之前遵循它。當未解決的設置仍然存在且存在有效的先前記錄時,提供恰好三個清晰的路徑:重用、重用並編輯,或全新配置。一個完全指定的當前調用仍然是一個真正的快速路徑,並跳過此問題。

記住的記錄在整個 XXD Panel 家族中共享,因為這些是常見的交付變量,而不是美學選擇。當前的明確要求始終獲勝。永遠不要記住精確的複製內容、源路徑、生成的內容、模型路由、憑證或秘密。一旦當前設置完全解析,僅通過 scripts/panel_preferences.py 保存安全的交付字段,除非用戶選擇了 --prefs off 或要求不記住此次調用。

目錄批次處理

源簡報要求每張照片生成一個獨立的海報,因此批次是一個首選路徑。一個可讀取的目錄作為源提供是明確的批次意圖。立即進入批次處理;不要詢問用戶是否想要批次處理,也不要在庫存清單顯示之前顯示不相關的模式選單。

  1. 遞迴庫存支持的點陣圖文件(.png, .jpg, .jpeg, .webp, .heic, .heif, .avif, .tif, .tiff, .bmp),不區分大小寫。尊重明確的僅限頂層請求或用戶排除項。
  2. 忽略隱藏文件和隱藏目錄、非圖像文件、此技能生成的任務文件夾以及提供的目錄樹內的輸出根目錄。不要跟隨解析目標逃逸出提供的目錄的符號連結。
  3. 按相對路徑使用穩定的自然排序。在生成之前報告發現的數量和遞迴範圍。識別不可讀或無法解碼的候選項;絕不會靜默跳過它們。如果找不到支持的圖像,則停止,不創建空任務目錄。
  4. 為每個發現的源構建一個隊列項。每個項使用相同的、不變的風格簡報;永遠不要在批次期間選擇、混合或切換到另一種風格。
  5. 一次為整個批次解析共享的模式、分割、尺寸、文字和區域設置。參數和清晰的散文仍然可以跳過問題。為每個圖像解析 auto 和 source,因為方向可能不同。在執行之前,說明輸入數量、共享設置、每個圖像的例外情況以及預期的總輸出數量。
  6. 將每個源視為邏輯上獨立的生成工作:重新閱讀源簡報,獨立構建其提示,並且永遠不要將另一個圖像的內容、推斷的含義、措辭、提示或結果帶入其中。每個海報是獨立的;永遠不要將多個源合併到一張紙上。
  7. --text prompt 為每個圖像獨立生成基於源的措辭。--text none 應用於所有圖像。單個 --copy 故意將相同的精確文本應用於每個圖像;當精確文本不同時,接受一個明確的相對路徑或文件名到精確文本的映射,並在生成之前驗證每個預期的源。永遠不要將一個映射的標題用於另一個源。
  8. 失敗的源或資產必須被命名和報告,而不會靜默丟棄後續的隊列項。僅對失敗的輸出應用正常的單資產重試規則,繼續處理其餘隊列,並以成功/失敗的計數和路徑結束。

一個批次調用是一個物理任務目錄,即使其隊列項在邏輯上是獨立的。不要為每個源創建一個任務目錄。

能力自適應預檢

不要僅僅為了獲得提問界面而將用戶的會話切換到計劃模式。技能可以描述行為,但無法創建主機未公開的 UI 能力。檢測實際的提問工具架構,並遵循以下順序:

  1. 可以使用真正的多選工具——例如 Claude Code 的 AskUserQuestion 且 multiSelect: true: 對模式和尺寸使用真正的複選框問題。對分割嚴格性和文字模式使用單選問題。不要在顯示表單後列印冗餘的編號菜單。
    • 第一個表單:模式 (top-bottom, left-right, design-only) 使用 multiSelect: true;分割 (嚴格 1:1, 自由比例) 作為單選;文字模式作為單選。
    • 當真正需要尺寸問題時,提供 3:4(簡報默認), 跟隨原圖, 常用比例, 自定義。當選擇 常用比例 時,為所有具體比例顯示真正的複選框組,僅根據主機選項限制進行分割:正方形 1:1;豎版 3:4, 4:5, 2:3, 9:16, 5:7;橫版 4:3, 5:4, 3:2, 16:9, 21:9, 7:5。跨組累積選擇。當選擇 自定義 時,通過主機的自由輸入/其他路徑收集一個或多個比例或精確像素目標。
  2. 僅可使用互斥選擇工具——例如 Codex 的 request_user_input: 僅將其用於真正的單選字段,如文字模式、分割嚴格性或尺寸輸入路徑。當用戶可能選擇多個時,切勿將模式或具體尺寸表示為單選。使用下面的兩輪組合輸入收集那些多值字段。不要聲稱單選卡片是複選框。
  3. 沒有可用的交互式提問工具: 使用相同的下面兩輪組合輸入。它是鍵入的多值輸入,而不是可點擊的表單。切勿繪製 Markdown - [ ] 框或其他虛假控件。

內聯參數和清晰的自然語言始終優先。跳過每個已解析的字段。當所有必需的值都存在時,跳過所有問題並立即生成。

兩輪組合輸入後備方案

第一輪——模式和分割:

請選擇一個或多個成品類型:

1. 上下對照(原圖在上,厚塗微景觀在下)
2. 左右對照(原圖在左,厚塗微景觀在右)
3. 只要微景觀(原圖僅作參考,不出現在成品中)

上下/左右採用哪種分割?
A. 嚴格 1:1(各佔 50%,原始簡報的默認要求)
B. 自由比例(由畫面自行平衡兩部分)

可回復:1,A|1+3,B|全部,A

第二輪——僅當尺寸真正未解決時,同時詢問尺寸和文字:

請選擇尺寸,可多選:

1. 3:4 豎版(原始簡報的默認構圖)
2. 跟隨原圖
3. 常用比例(可直接寫 4:5、9:16 等一個或多個比例)
4. 自定義(輸入一個或多個比例/準確像素)

請選擇文字方式:

A. 模型根據原始簡報生成標題與極少量註釋(註明語言)
B. 使用我的準確文字(發送原文並註明語言)
C. 不要文字

可回復:尺寸 1;文字 A,簡體中文
可回復:尺寸 4:5、16:9;文字 B,準確文字「……」,簡體中文

不要在源簡報之外決定措辭。對於選項 A,僅向圖像模型提供目標語言;圖像模型遵循源簡報現有的文字邏輯。對於選項 B,逐字傳遞用戶的字符,不添加其他文案。對於選項 C,禁止所有可見文字和偽文字。

不要從一個人的外表、名字、服裝、場景、文件名、元數據、標誌或用於操作技能的語言來推斷語言或市場。每當請求文字時,明確解析它。使用自然的目標語言形狀、方向、標點、間距和換行。對於阿拉伯語,保留連接形式和從右到左的文字流,而不是不加區別地鏡像藝術品。

尺寸解析

  • 源簡報指定了 3:4 豎版,因此 3:4 是默認值,而不是一個靜默的後備。將其解析為來自源的具體像素並說明結果。沒有單獨的「推薦比例」步驟。
  • auto 意味著:遵循源簡報的 3:4 默認值,除非源方向和用戶陳述的用途使另一個比例明顯更好;然後推薦並說明該比例及其像素。
  • source 意味著整個請求的普通輸出的寬高比與源照片相同,覆蓋簡報的 3:4。
  • 精確像素覆蓋比例。
  • 每個不同的寬高比都是來自相同源和相同逐字風格簡報的獨立完整畫布構圖。切勿從一個比例裁剪出另一個比例。共享一個寬高比的多個分辨率可以從最高質量的批准構圖中導出。
  • 除非用戶將尺寸按模式映射,否則一個尺寸集應用於每個選定的普通模式。
  • 在生成之前,說明解析後的模式、分割嚴格性、具體尺寸、文字模式和區域設置,以及總輸出數量。

…”中的內容。不要生成包括 YAML 前置元數據在內的完整 Markdown。不要編寫任何新的部分。確保程式碼、CLI 命令、檔案路徑、環境變數名稱、URL 和內聯程式碼區塊保持不變(不要翻譯)。輸出翻譯後的 Markdown 主體,不要用額外的程式碼區塊包裹。僅輸出單個 skillMarkdown 字串,不要在其前後添加其他文字或 JSON 包裝。在輸出之前,驗證您正確處理了低於此處提供的完整 SKILL.md 內容的最多 100000 個字符。此處提供的是截斷的版本,因此請僅翻譯提供的部分;不要發明遺失的部分。對於遺失的部分,您可以用註釋 [已截斷進行翻譯] 來取代。

相關技能