op7418 / guizang-material-illustration

op7418/guizang-material-illustration

open_in_new前往仓库

归藏的材质插画技能：生成带文字解释的插图、美化图表，并辅助参考配图。

项目概览

项目概述

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）。除此之外的运行时依赖，仓库资料未提供。

安装与快速开始

一行命令安装：

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

手动克隆：

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

更新：

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

安装后直接让 Agent 说：

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

典型使用方法

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

示例请求：

把这篇文章挑 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 仓库 op7418/guizang-material-illustration 的 README、目录结构与文档清单。 分析时间：基于仓库现有资料整理；仓库未提供发布日期、更新时间或 release 信息。