## 项目概述

`guizang-material-illustration` 是一个适配 Claude Code、Codex 等 Agent 环境的配图 Skill。它把文章、笔记、图表截图、产品概念、工作汇报、教学材料和人文观点，生成带中文标签的“歸藏材质插画”。项目的核心定位是解决“中间那张图”的问题：不是漂亮的装饰图，而是能把意思讲清楚的中心配图。它也是 `guizang-social-card-skill` 的配套项目。

## 核心功能

- **解释图生成**：把抽象概念、流程、机制、系统关系画成带短标签、箭头、图例的图。
- **图表美化**：从截图或原始数据中抽取图表类型、标题、坐标、单位、数值、误差线和结论，重新生成适合传播的材质化图表。
- **参考辅助出图**：遇到冷门概念、品牌、模型、科学装置、历史物件时，先查参考信息，再统一转为歸藏材质风格。
- **支持多种图解类型**：概念拆解图、流程图解、循环机制图、对比图、层级/架构图、场景解释图、科学机制图、人文意象图、材质化图表等。
- **图内可以有字**：中文短标签、数据标注直接生成在图片里。
- **QA 优先**：交付前检查中文标签、数据、裁切、参考准确性和社交卡片尺寸下的可读性。
- **主题色可扩展**：默认 IKB 蓝，也支持柠檬黄、柠檬绿、安全橙、石墨黑等方向。

## 适用与不适用场景

**适合**：文章配图 / 知识解释图 / 产品机制图 / 工作汇报配图 / 数据图表美化 / 教学材料配图 / 人文观点配图 / 社交卡片中心图 / PPT 中心插画 / 冷门概念视觉解释

**不适合**：完整小红书卡片排版 / 完整 PPT 结构设计 / 真实摄影修图 / 人像写真 / 长文海报排版 / 需要严格出版级数据制图的科研图

## 技术架构与依赖

仓库是一个 Agent Skill 包，主要包含：

- `SKILL.md`：主文件，定义触发条件、工作流和交付规则。
- `references/`：视觉风格、提示词模式、图表美化、参考收集和 QA 清单。
- `assets/prompt-template.md`：可复用图像提示词模板。
- `agents/openai.yaml`：Codex / OpenAI Skill 展示配置。
- `HANDOFF.md` / `PRODUCT.md`：交接文档和产品文档。

依赖方面，README 明确该 Skill 需要 Agent 具备 shell 权限，并调用图像生成能力（如 GPT-Image / imagegen）。除此之外的运行时依赖，仓库资料未提供。

## 安装与快速开始

一行命令安装：

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

手动克隆：

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

更新：

```bash
cd ~/.claude/skills/guizang-material-illustration && git pull
```

安装后直接让 Agent 说：

```text
用歸藏的材质插画 skill，帮我把这段产品说明做成一张带中文标签的机制图。
```

## 典型使用方法

- 长文章配图：先拆出 1-4 个核心概念，每个概念生成一张解释图。
- 产品/技术说明：先查参考信息，再做流程图、层级图、系统关系图。
- 图表截图美化：抽取数据和坐标语义，重新生成材质化图表。
- 工作汇报：用进展、风险、决策、下一步做四象限或流程配图。
- 内容生产：把选题、素材、草稿、发布、复盘画成工作流。
- 教育解释：明确部件、方向、关系和短标签，避免只画氛围。
- 人文观点：用意象 + 结构 + 少量标签，不伪造真实历史现场。
- 社交卡片联动：先生成中心图，再让 Social Card Skill 负责标题和版式。

示例请求：

```text
把这篇文章挑 3 个核心概念，各生成一张带字配图。
帮我把这张柱状图重新画成歸藏材质风格，数据和坐标不要改。
给这篇小学科学课文做一张杠杆原理图，图里标出支点、用力点、阻力点和力臂。
```

## 配置与部署要点

- 安装目录：默认克隆到 `~/.claude/skills/guizang-material-illustration`。
- 安装后应确认 `SKILL.md`、`assets/`、`references/` 存在。
- 触发方式：直接说“生成一张配图”“做一张带字解释图”“图表美化”“材质插画”等即可，Skill 内部会自动判断图类型。
- 参考搜索：冷门概念、品牌、科学装置、历史物件会先查参考信息，但只用于补事实和视觉线索，不复制外部图片。
- 配色：默认 IKB 蓝，可通过提示词切换柠檬黄、柠檬绿、安全橙、石墨黑等主题方向。
- 与 Social Card Skill 配合：先生成中心图，再由 `guizang-social-card-skill` 处理 3:4 / 1:1 / 21:9 的标题、正文、主题色和导出。
- 错误处理：图内中文字生成错时，优先缩短标签并重新生成，不建议用 HTML 贴字补救。

## 限制、风险与许可证

- 不负责完整卡片排版、PPT 结构设计、真实摄影修图、长文海报或出版级科研数据制图。
- 参考搜索只补事实，不保证外部视觉线索完全准确；交付前会做 QA 检查。
- 图片生成依赖当前 Agent 可用的图像生成能力，结果质量受模型限制。
- README 未提供许可证信息，仓库资料未提供。
- 仓库也未提供版本、release 或语言字段信息。

## 官方链接

- GitHub 仓库：https://github.com/op7418/guizang-material-illustration
- 配套项目（Social Card Skill）：https://github.com/op7418/guizang-social-card-skill

## 信息来源和分析时间

信息来源：GitHub 仓库 `op7418/guizang-material-illustration` 的 README、目录结构与文档清单。
分析时间：基于仓库现有资料整理；仓库未提供发布日期、更新时间或 release 信息。