image-gen
xerrors/Yuxi · Agent Skill
根據文字描述生成影象、海報和插圖,並將其儲存到輸出。
前往安裝 ↓總覽
| 發布者 | |
|---|---|
| 儲存庫 | xerrors/Yuxi ↗ |
| 技能資料夾 | image-gen |
| 星 | 6,725 |
| 附帶檔案 | 1 |
| 授權 | MIT |
| 最近更新 | 2026年8月20日 |
| 連結 | 技能原始碼 ↗ · 儲存庫 ↗ |
Mozgi 檢查
我們在技能檔案中發現的內容。詳細資訊需訂閱。
安裝
技能就是一個含 SKILL.md 的資料夾。選擇你的代理,在專案根目錄的終端機(macOS、Linux 或 Windows 的 Git Bash)執行指令。
把提示貼到 Claude、Codex 或其他助理:它會自行檢查並安裝技能。
Install the “image-gen” skill from mozgi.io (https://mozgi.io/skills/image-gen/) for me. 1. Download the archive: https://mozgi.io/skills/image-gen/download If it fails, take the skill folder from the source: https://github.com/xerrors/Yuxi/tree/main/backend/package/yuxi/agents/skills/buildin/image-gen 2. Read SKILL.md and the other files. Check the skill is safe: no hidden commands, no sending data elsewhere, no scripts doing something other than described. If anything looks suspicious, stop and tell me. 3. Put the “image-gen” folder into your agent's skills folder: .claude/skills/ for Claude Code, .agents/skills/ for Codex, .cursor/skills/ for Cursor, .gemini/skills/ for Gemini CLI. Inside the project if we are in one, otherwise in the home folder (~/.claude/skills/ etc.). 4. Make sure <skills folder>/image-gen/SKILL.md exists. 5. Briefly tell me what this skill does and offer to try it on my task. If you cannot do a step yourself, tell me what to click or type.
git clone --depth 1 --branch main https://github.com/xerrors/Yuxi.git /tmp/Yuxi mkdir -p .claude/skills cp -r /tmp/Yuxi/backend/package/yuxi/agents/skills/buildin/image-gen .claude/skills/image-gen
重新啟動 Claude Code — 技能就會出現在清單中,手動呼叫:/image-gen。要套用到所有專案,請放在 ~/.claude/skills。
git clone --depth 1 --branch main https://github.com/xerrors/Yuxi.git /tmp/Yuxi mkdir -p .agents/skills cp -r /tmp/Yuxi/backend/package/yuxi/agents/skills/buildin/image-gen .agents/skills/image-gen
Codex 會從目前資料夾往上到儲存庫根目錄,在 .agents/skills 中尋找技能;用 /skills 或 $image-gen 呼叫。所有專案:~/.agents/skills。
git clone --depth 1 --branch main https://github.com/xerrors/Yuxi.git /tmp/Yuxi mkdir -p .cursor/skills cp -r /tmp/Yuxi/backend/package/yuxi/agents/skills/buildin/image-gen .cursor/skills/image-gen
Cursor 啟動時會載入技能;在 Agent 聊天輸入「/」呼叫。Cursor 也會讀取 .claude/skills 與 .agents/skills。所有專案:~/.cursor/skills。
git clone --depth 1 --branch main https://github.com/xerrors/Yuxi.git /tmp/Yuxi mkdir -p .gemini/skills cp -r /tmp/Yuxi/backend/package/yuxi/agents/skills/buildin/image-gen .gemini/skills/image-gen
任務符合時,Gemini CLI 會提議啟用技能,由你確認。所有專案:~/.gemini/skills。
安裝前請先檢視 SKILL.md 與相關檔案。點擊檔案即可預覽。
SKILL.md 內容
作者原文 · 唯讀图片生成技能
当用户要求生成图片、海报、插画、文生图,或明确提到 Qwen-Image 时,使用此技能组织图片生成流程。
默认生成接口
默认使用 SiliconFlow 的 Qwen-Image 接口:
- Endpoint:
POST https://api.siliconflow.cn/v1/images/generations - Model:
Qwen/Qwen-Image - 默认参数:
negative_prompt:""num_inference_steps:20guidance_scale:7.5
调用外部接口时,必须在 Agent 沙盒执行环境中读取 SILICONFLOW_API_KEY。不要依赖后端进程环境变量。
操作流程
1. 明确用户要生成的图片内容、风格、尺寸或约束;信息不足但不影响生成时,使用合理默认值,不要反复追问。
2. 使用可用的执行工具在沙盒中运行脚本,调用图片生成接口,传入用户需求整理后的 prompt,并按需传入 negative_prompt、num_inference_steps、guidance_scale。
3. 从生成接口响应中读取图片地址,默认路径为 images[0].url。
4. 在同一个沙盒脚本中用 Authorization: Bearer $SILICONFLOW_API_KEY 下载该图片地址;如果接口直接返回 base64,则直接解码保存。
5. 将最终图片保存到当前 Workdir 的 outputs/ 下,例如 outputs/generated-image.png。
6. 调用 present_artifacts,传入保存后的 outputs 虚拟路径,让前端展示图片产物。
7. 最终回复简要说明图片已生成,不要把外部临时 URL 当作最终结果展示。
脚本示例
可根据用户需求调整 prompt 和输出文件名:
import os
import requests
from pathlib import Path
api_key = os.environ["SILICONFLOW_API_KEY"]
prompt = "根据用户需求整理后的图片提示词"
response = requests.post(
"https://api.siliconflow.cn/v1/images/generations",
headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
json={
"model": "Qwen/Qwen-Image",
"prompt": prompt,
"negative_prompt": "",
"num_inference_steps": 20,
"guidance_scale": 7.5,
},
timeout=120,
)
response.raise_for_status()
image_url = response.json()["images"][0]["url"]
image_response = requests.get(
image_url,
headers={"Authorization": f"Bearer {api_key}"},
timeout=120,
)
image_response.raise_for_status()
output_path = Path("outputs/generated-image.png")
output_path.parent.mkdir(parents=True, exist_ok=True)
output_path.write_bytes(image_response.content)
print(output_path.as_posix())
多模型扩展
如果用户指定其它图片生成模型或兼容接口,可以按该接口的协议先生成图片。只要最终拿到图片 bytes 或 base64,就保存到当前 Workdir 的 outputs/,再调用 present_artifacts 展示。
关键约束
- 不要把外部生成接口返回的临时 URL 当作最终结果直接展示给用户。
- 不要调用后端 MinIO 上传工具;图片生成和下载都应在沙盒内完成。
- 如果
SILICONFLOW_API_KEY缺失,应明确提示用户需要在 Agent 沙盒环境变量中配置。 - 保存到 outputs 后必须调用
present_artifacts,否则前端不会自动展示生成图片。
常見問題
image-gen 技能有什麼用途?
根據文字描述生成影象、海報和插圖,並將其儲存到輸出。
如何安裝 image-gen?
打開本頁的「安裝」區塊並選擇你的代理 — Claude Code、Codex、Cursor 或 Gemini CLI:那裡有把技能資料夾複製到正確位置的現成指令。也可以複製「透過助理」分頁中的提示,讓助理自行檢查並安裝技能。
image-gen 適用哪些 AI 模型?
技能是純 Markdown 指示(Agent Skills 格式),因此 image-gen 適用任何讀取 SKILL.md 的代理:Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 等。只有在任務符合技能描述時,模型才會載入指示。
image-gen 是免費的嗎?
此技能由 xerrors 公開發布,採用 MIT 授權。技能本身免費 — 你只需向 AI 供應商支付實際使用的 token 費用。
安裝技能安全嗎?
技能是代理會遵循的指示,安裝前請閱讀 SKILL.md 及相關檔案。技能資料夾中的腳本只有在代理執行時才會運行 — 留意它的動作,不要授予多餘權限。
技能和 MCP 伺服器或外掛有何不同?
MCP 伺服器或外掛為模型提供新工具 — 會執行並回傳結果的程式碼。技能提供的是知識與流程:如何處理任務、要遵循哪些步驟、好的成果長什麼樣子。它不需要伺服器或 API 金鑰。