mcpField
Q
q-infographics

q-infographics

github.com/tyrealq设计与 UI10950 次安装5 周前更新
代码仓库

关于 q-infographics

Q-Infographics 是将源文档转为商业故事和信息图图片的技能。分阶段流程使用 Gemini 生成故事，并以 GPT Image 2 或 Gemini 制作图片，每步都设有审核环节。

主要功能

  1. 01将文档转换为 Markdown
  2. 02使用 Gemini 生成商业故事
  3. 03使用 GPT Image 2 或 Gemini 制作信息图
  4. 04每步完成后暂停审核
  5. 05叠加可自定义的 Logo

适用场景

  1. 01将报告转为信息图
  2. 02在生成图片前审核故事
  3. 03为信息图添加 Logo

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tyrealq/q-skills --skill q-infographics

安装后在 Claude Code 中输入/q-infographics确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
image.txt
prompts_reference.md
story.txt
scripts/
gen_image.py
gen_story.py

详细介绍

Q-Infographics

将源文档转化为商业故事和信息图图片。

如果处于计划模式： 编写简短计划 — “运行 q-infographics 技能：将源文档转换为 Markdown，通过 Gemini 生成商业故事，生成信息图图片。” — 然后立即退出计划模式。计划模式下不得尝试转换文档、生成故事或生成图片。

脚本目录

Agent 执行说明：

  1. 确定此 SKILL.md 文件所在目录的路径，并将其设为 SKILL_DIR。
  2. 脚本路径 = ${SKILL_DIR}/scripts/<script-name>。
  3. 提示词路径 = ${SKILL_DIR}/references/<prompt-name>。
资源用途
scripts/gen_story.py通过 Gemini API 根据文档生成商业故事
scripts/gen_image.py通过 GPT Image 2（默认）或 Gemini 生成信息图图片
references/story.txt故事生成提示词模板
references/image.txt信息图生成提示词模板

依赖项

openai
google-genai
Pillow
markitdown

安装：pip install openai google-genai Pillow markitdown

默认信息图模型为 gpt-image-2（需要 OPENAI_API_KEY）。设置 IMAGE_MODEL=gemini 或向 gen_image.py 传递 --model gemini，即可使用 gemini-3-pro-image-preview（需要 GEMINI_API_KEY）。故事生成（gen_story.py）始终使用 Gemini。

从 .env 加载密钥：

PowerShell（Windows）：

$env:GEMINI_API_KEY = (Get-Content path\to\.env | Where-Object { $_ -match '^GEMINI_API_KEY=' } | Select-Object -First 1).Split('=',2)[1]

Bash（macOS/Linux）：

export $(cat /path/to/.env | xargs)

参考资料

  • references/prompts_reference.md — 故事和图片提示词说明及关键要素

核心原则

  • 每个步骤后设置审核检查点 — 显示输出，并在继续前征得用户确认
  • 输出文件使用源文件名并添加 _INFO 后缀（例如，MY_REPORT.pdf → MY_REPORT_INFO.jpg）
  • 自动在右下角叠加 Logo（约占图片宽度的 6%）；可通过 assets/Logo_Q.png 自定义

工作流

步骤操作命令 / 参考资料
1将源文档转换为 Markdown；显示前约 50 行以供确认markitdown <input_file> -o <OUTPUT.md>
2生成商业故事；显示提示词和完整输出以供审核python "${SKILL_DIR}/scripts/gen_story.py" <INPUT.md> "${SKILL_DIR}/references/story.txt" > STORY_OUTPUT.md
3生成信息图图片；显示结果以供审核python "${SKILL_DIR}/scripts/gen_image.py" STORY_OUTPUT.md "${SKILL_DIR}/references/image.txt" <SOURCE_NAME>_INFO

自定义

  • 故事风格：编辑 ${SKILL_DIR}/references/story.txt — 参见 references/prompts_reference.md
  • 信息图风格：编辑 ${SKILL_DIR}/references/image.txt — 参见 references/prompts_reference.md

范围

包含： 文档转故事、信息图生成、Logo 品牌标识。 不包含： 幻灯片演示文稿（使用 q-presentations）、数据可视化、图表生成。

评论

支持 Markdown