前言¶
在对话式 Agent 里出图,常见做法是接通用多模态接口或平台内置绘图。前者往往要自己在 SKILL 里封装鉴权、模型选择与参数;后者则容易和宿主产品的积分、配额绑在一起。若你已经在用 Agnes AI 的图片能力,或希望出图更偏自然真实、中文配文更稳,需要一个按 Agnes 模型规格写好、且能用自有 Key 的 Skill,agnes-image-gen 就是面向这一场景的社区技能。
这是什么¶
agnes-image-gen 是 SkillHub 上坐标为 @user_15292d5a/yjkj-agnes-image-gen 的社区 Skill(design-media 分类,当前版本 1.0.0)。发布者为 user_15292d5a,标签标明 requires_api_key=true,即运行前需配置 Agnes API Key。
它把 Agnes AI 的图片生成模型接到符合通用 SKILL.md 约定的 Agent 工作流里:用户用自然语言描述需求时,Agent 加载本 Skill,按规则调用 Agnes 完成文生图或图生图。官方说明中强调:调用 不消耗 WorkBuddy 积分,只消耗 Agnes API 额度。
核心功能¶
以下能力均来自 SkillHub 页面与已抓取简介,未单独列出的接口字段或脚本不在本文展开。
文生图¶
使用模型 agnes-image-2.1-flash,根据文本提示生成图片。
图生图¶
使用模型 agnes-image-2.0-flash,在参考图基础上按提示改写或延展画面。
自定义 API Key¶
支持配置用户自己的 Agnes Key,由用户在自有 Agnes 账户下计费与控量,而不是走宿主产品的绘图积分。
生成效果取向¶
Skill 简介中的优化重点包括:
- 降低画面「AI 感」,增强自然、真实感;
- 改善中文配文的逻辑连贯性、字体与排版;
- 减轻文字重影、重叠类常见问题。
何时加载本 Skill¶
当用户说出例如「用 Agnes 生成图片」「用 Agnes 画一张」「Agnes 生成」,或明确要求使用 Agnes API 做文生图 / 图生图时,Agent 应加载本 Skill。具体触发与参数约定以安装后的 SKILL.md 为准。
安装与启用¶
SkillHub 官方给出的安装方式有两类:让 AI 按安装文档操作,或在本机用 skillhub CLI 安装到当前 Agent 的 skills 目录。
方式一:提示词交给 AI¶
将下面意图发给支持 Skill 的客户端(表述以 SkillHub 页面为准):
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_15292d5a/yjkj-agnes-image-gen`。
方式二:skillhub CLI¶
1、若尚未安装 CLI,可先检查:
command -v skillhub && skillhub --version
2、未安装时,可按 SkillHub 安装文档执行完整安装或仅 CLI(文档地址:https://skillhub.cn/install/skillhub.md)。
3、安装本 Skill 时 必须 使用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被识别:
skillhub install @user_15292d5a/yjkj-agnes-image-gen --dir <skills 目录>
常见客户端 skills 路径(摘自 SkillHub 安装文档,以你本机实际为准):
| 客户端 | skills 目录 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安装完成后,按各客户端要求配置 Agnes API Key(Skill 标签要求 requires_api_key=true)。密钥字段名与示例以 Skill 包内 SKILL.md 为准;本文不臆造配置项名称。
典型用法¶
公开页面未提供独立 REST 示例或固定 prompt 模板,用法以 对话触发 + Skill 内说明 为主。可复现的入口如下。
1、确认 Skill 已装入对应 --dir,且 Agnes Key 已配置。
2、在对话中明确走 Agnes,例如:
用 Agnes 画一张:清晨城市天际线,薄雾,纪实摄影风格,不要夸张 HDR。
3、图生图场景下,在支持附件的客户端上传参考图,并说明意图,例如:
用 Agnes 生成:保持这张产品图的光影,把背景换成简约浅灰展台,中文标题「秋日限定」排版清晰、无重影。
Agent 加载 agnes-image-gen 后,应分别选用 agnes-image-2.1-flash(文生图)或 agnes-image-2.0-flash(图生图)。生成结果路径、格式以 Skill 实现与 Agnes API 返回为准。
适用场景与注意¶
适合谁
- 已在使用或计划使用 Agnes 图片 API,希望在 Cursor、Claude Code、Codex 等 Agent 里用同一套 Key 出图;
- 需要海报、配图等带 中文文案 的画面,且希望 Skill 侧针对「AI 感」与文字排版做过取向说明;
- 希望绘图计费与 WorkBuddy 积分 脱钩,只走 Agnes 额度。
限制与注意
- 必须自备并妥善保管 Agnes API Key;勿将 Key 写进公开仓库或聊天记录。
- SkillHub 统计(以脚本抓取为准):评分 100000,下载 1944;页面展示的安装次数为 0,可能与统计口径有关,不影响按上述命令安装。
- 社区来源(
community),升级与维护节奏取决于发布者;生产环境使用前建议在测试 Key 下验证效果与配额。 - 未在官方简介中出现的模型版本、价格、速率限制,请以 Agnes 官方文档为准。
结尾¶
agnes-image-gen 把 Agnes 的 agnes-image-2.1-flash 文生图与 agnes-image-2.0-flash 图生图封装成可安装的 Agent Skill,支持自有 Key,并针对更自然的画面与更稳的中文配文做了产品向说明。安装与坐标以 SkillHub 为准。
- SkillHub 页面:https://www.skillhub.cn/skills/user_15292d5a/yjkj-agnes-image-gen
- 资源地址:https://api.skillhub.cn/user_15292d5a/yjkj-agnes-image-gen
- 安装说明:https://skillhub.cn/install/skillhub.md