Communitygithub.com

cnlive860/microscape-poster-skill

一款AI智能体技能,可将每张照片转化为精美的3:4竖版海报:上方是未经处理的照片,经过展览级调色,下方是同一主题的3D厚涂油彩微景观,以严格的1:1比例分割。

microscape-poster-skill 是什么?

Microscape Poster 是一款专为AI代理(如Claude Code、Cursor、Codex等)设计的技能,旨在将用户上传的照片自动生成为高品质的3:4竖版海报。其核心设计严格遵循一个独立的创意简报(references/original-prompt/zh-CN.md),该简报是唯一的美学权威,定义了从构图、色彩、材质到文本逻辑的所有艺术细节。技能本身作为一个运行时外壳,仅负责解析用户提供的运行时变量(如输出模式、分割方式、尺寸、文本语言等),并将这些指令附加到完整的创意简报之后,然后调用图像生成模型执行。它支持多种输出模式,包括上下对照、左右对照和仅生成微景观,并提供严格或自由的分割比例,以及多种尺寸和文本选项。该技能特别强调了批量处理能力,可对目录中的所有图片统一应用相同的艺术风格,每个输出都是独立的生成任务。此外,它还具备记忆用户偏好、自适应不同平台UI能力以及通过记忆偏好文件(references/runtime-preferences.md)提供可配置的用户体验,旨在为摄影师、设计师和内容创作者提供高效、一致且可定制的海报生成工作流。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

微景观海报

以 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面板系列中共享,因为这些是公共的交付变量,而非美学选择。当前显式要求始终获胜。永远不要记住确切的副本、源路径、生成的内容、模型路由、凭据或机密。一旦当前设置完全解析,通过 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。
  • 精确像素覆盖比例。
  • 每个不同的宽高比都是一个独立的完整画布构图,源自同一源和同一逐字的样式简报。切勿从一个比例裁剪出另一个比例。共享同一宽高比的多个分辨率可以从最高质量的批准构图中导出。
  • 除非用户将尺寸映射到每个模式,否则一个尺寸集适用于每个选定的普通模式。
  • 在生成之前,声明已解析的模式、分割严格性、具体尺寸、文本模式和区域设置,以及该批次的总输出数量。

相关技能