gc-minimal-zine-poster Mac 安装教程:Codex Skill 怎么装、怎么用和常见报错
gc-minimal-zine-poster 是一个跑在 Codex(及其他兼容 Skill 运行时)上的海报生成 Skill:给它一个主题、一句话、一篇文章想法、一种情绪、一张照片,它就能产出一张「极简杂志风」的纸质感海报,或者一条可以直接复用的图像生成提示词。
这个 Skill 最近热度很高,但中文圈基本没有一篇像样的教程,很多人只能到处翻安装命令——尤其是老版本 v0-1 的装法。这篇一次性讲清楚。
它能做出什么效果
- 默认 3:5 竖版做旧纸张画布,70%~90% 留白
- 画面只有一个视觉主体 + 一处高饱和色点缀
- 字体走衬线、打字机、等宽路线,拒绝商业广告排版
- 自带复印、Risograph、半调网点、活版印刷等「纸感瑕疵」
- 整体气质:日韩独立杂志、极简编辑风
一句话:适合做封面图、文章配图、社媒海报,不适合做电商促销图。
Mac 安装前准备:打开终端、检查 Git 和 Codex 目录
下面命令适用于 macOS。先按 Command + 空格,搜索并打开“终端(Terminal)”;也可以使用 iTerm2。命令中的 ~ 代表你的 Mac 用户主目录,例如 /Users/你的用户名。
先检查 Mac 是否已安装 Git:
git --version
如果能看到类似 git version 2.x.x 的结果,说明可以继续。若提示找不到命令,macOS 通常会弹出安装 Command Line Tools 的提示,按提示完成安装后重新打开终端,再执行一次上面的命令。
然后创建 Codex Skills 目录。即使目录已经存在,重复执行也不会影响已有 Skill:
mkdir -p ~/.codex/skills
Mac 安装(当前最新版 v0.3.1)
在终端完整复制执行下面命令:
git clone https://github.com/LiamGvchi/gc-minimal-zine-poster.git \
~/.codex/skills/gc-minimal-zine-poster-v0-3
安装完成后,可以用下面命令确认文件已经放进 Mac 的 Codex Skills 目录:
ls ~/.codex/skills/gc-minimal-zine-poster-v0-3
如果能看到 SKILL.md 等文件,说明安装成功。随后完全退出并重新打开 Codex;重启后技能一般会出现在可用 Skills 列表中。
在找 v0-1 老版本安装命令?
很多旧教程里复制到的是这条(v0.1 老版本):
git clone --branch v0.1.0 \
https://github.com/LiamGvchi/gc-minimal-zine-poster.git \
~/.codex/skills/gc-minimal-zine-poster-v0-1
两点注意:
- 不要把 v0.3.1 直接 pull 到 v0-1 的目录里,目录名和 Skill 声明名必须一致,混装会出问题
- 想从 v0.3.0 升级到 v0.3.1(目录不变,可平滑升级)用这条:
git -C ~/.codex/skills/gc-minimal-zine-poster-v0-3 pull --ff-only
五种使用模式(附提示词示例)
- 直接生成海报:「用 $gc-minimal-zine-poster-v0-3 做一张关于雨夜旧书店的海报。」
- 只出提示词:「用 $gc-minimal-zine-poster-v0-3 只返回一张深夜打烊旧书店的最终图像生成提示词,不要生成图。」
- 照片改版:「用 $gc-minimal-zine-poster-v0-3 把这张人像做成海报,保留人物身份和服装,只改排版和纸面处理。」
- 参考图分析:「用 $gc-minimal-zine-poster-v0-3 分析这个图片文件夹,拆出固定规则和可变规则,返回可复用提示词。」
- 先分析再生成:先从参考图提取视觉体系,再按体系出图。
相关阅读
常见问题
Mac 上装完不显示怎么办?
按顺序检查三件事:
Mac 终端提示 `git: command not found` 怎么办?
这表示 Git 尚未安装。先执行 `xcode-select --install`,按 macOS 弹窗完成 Command Line Tools 安装;安装完成后重新打开终端,运行 `git --version` 确认成功,再继续安装 Skill。若公司设备限制安装,请按 IT 规范处理,不要下载来源不明的 Git 安装包。
能用 OpenClaw 或其他客户端吗?
README 声明支持「Codex 或其他兼容 Skill 运行时」,按你所用客户端的 skills 目录约定安装即可。
对模型有要求吗?
生成和质检依赖宿主环境的图像生成与图像识别能力,模型不行效果就打折。Skill 包本身不含脚本、字体、密钥。
v0.3.1 更新了什么?
主要改进了构图措辞(明确「视觉载体」必须在提示词里点名)、增加了对未要求的海洋符号和通用图标的质检。

京ICP备2024094994号-29