guizang-material-illustration

环境要求

• 支持 npx 命令的 Node.js 环境
• 已安装 Claude Code / Codex 等 Agent 环境
• Agent 具备可用的图像生成能力（GPT-Image / imagegen）
• 本地 shell 权限（手动克隆安装时需要）

安装与启动步骤

1. 1一行命令安装

   在终端执行 npx 命令，把 guizang-material-illustration 这个 Skill 添加到当前 Agent 环境。

   npx skills add https://github.com/op7418/guizang-material-illustration --skill guizang-material-illustration

   复制

2. 2手动克隆安装

   如不使用 npx，可把仓库克隆到 Claude 的 skills 目录，路径需与 Agent 约定一致。

   git clone https://github.com/op7418/guizang-material-illustration ~/.claude/skills/guizang-material-illustration

   复制

3. 3检查安装文件

   确认 SKILL.md、assets/、references/ 三个关键内容是否存在，缺失说明安装不完整。

   ls ~/.claude/skills/guizang-material-illustration

   复制

4. 4更新已装版本

   已安装过的话进入目录执行 git pull，拉取最新版本并查看当前 commit。

   cd ~/.claude/skills/guizang-material-illustration && git pull && git log -1

   复制

5. 5向 Agent 发起请求

   安装后直接对 Agent 说出你的配图需求，它会自动判断图类型并生成带中文标签的插画。

如何确认成功

查看安装目录下 SKILL.md、assets/、references/ 是否存在；再让 Agent 画一张带中文标签的机制图，能出图即成功。

常见问题

注意事项

• 这是 guizang-social-card-skill 的配套项目，本 Skill 只负责卡片中心的配图部分。
• 详细执行规则见仓库内 SKILL.md，视觉风格、图表、参考搜索和 QA 规则在 references/*.md 中。
• 安装完成后建议用 git log -1 记录当前 commit，便于日后确认是否更新成功。