القائمة
图像生成工作流总览：何时出图、如何选用后端子技能、与提示词技能配合。 在用户需要配图/示意图、选择 UCloud 或 OpenRouter 等 API 出图、或询问本仓库「出图技能怎么组合」时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
指导在终端用 @baklib/baklib-cli（baklib 命令）通过 Baklib Open API 管理站点、知识库、DAM、成员与用户，以及主题拉取/预览上传与本地 theme dev；含鉴权配置、--json 脚本输出与执行规范。在用户已安装或可安装 baklib CLI、要用命令行/脚本/CI 读写 Baklib 线上数据时使用；Liquid 模版语法见 baklib-theme-dev（需另行安装）。
Baklib 专用：根据 CHANGELOG/更新说明撰写面向用户的对外发布日志（Markdown 正文 + 封面图提示词）， 用于 release.baklib.cn 等站点页；含标题规范、help.baklib.cn/术语表内链、DaisyUI baklib 品牌与 Liquid Glass 封面。 在用户要写 Baklib 发布日志、release note、版本更新文章、或从 CHANGELOG 生成对外稿时使用；出图与 MCP 写入须先确认。
Baklib 站点主题（模板）开发：Liquid 目录与命名、`config/settings_schema.json` 与模板 `{% schema %}`、多语言 `locales`、对象与指令/过滤器、静态页 URL、seeds 与迁移；站点表单 `form_tag`/`form_field_tag` 全量说明见 references/forms.md。并含「新建主题脚手架」「参考站复刻工作流」、本地 `baklib theme dev` 预览，以及 CLI 初始化 manifest（template.json，见 references/theme-init-template-manifest.md）。新建或迭代主题起步模版、写 template.json、theme init/apply 时必读该文档；完成主题开发后应把过程沉淀进 manifest 的 developmentNotes/workflow。页面预览参数用 `baklib theme preview set`（theme-preview-page-config.md），勿让用户手填面板。在用户编写 .liquid、配置 schema、新建模板、复刻参考站或排查模板与变量时使用；详规见 references/。
本地 MinerU 将 PDF/Office/图片转为 Markdown（含 images/ 图文、表格与公式识别）。复杂版式、扫描件、长书须先确认页范围与后端。用户要转 PDF、提取表格、OCR、或问「这篇 PDF 讲了什么」时使用。
通过 Playwright CDP 连接用户本机 Chrome，提供页面感知 JSON（链接、输入框、按钮等）与类人操作（点击、填写、滚动、截图）。 业务逻辑由消费该技能的 AI 决策，脚本不做站点硬编码。用于网页调研、表单填写、可控交互抓取； 涉及发布评论、点赞、关注、私信、表单提交等写入外部系统的操作前须先向用户确认执行计划。
Self-contained guide for writing Baklib BKE Markdown (L1/L2, DAM dam-id, file colon-syntax, link cards, fragments, embeds, tables). Use when authoring or importing BKE Markdown, inserting DAM assets, or resolving DAM ids via MCP; not for editor implementation or maintaining product docs repos.
| name | image-generation |
| description | 图像生成工作流总览：何时出图、如何选用后端子技能、与提示词技能配合。 在用户需要配图/示意图、选择 UCloud 或 OpenRouter 等 API 出图、或询问本仓库「出图技能怎么组合」时使用。 |
本总技能不能单独完成「调 API、运行脚本、产出图像」；只说明工作流、组合方式与密钥检查原则，不包含任一服务商的完整端点、请求体与可执行命令。
image-generation-<服务商> 子技能同时使用（当前为 image-generation-ucloud、image-generation-openrouter；以后仓库若增加其它供应商，命名约定见下表）。实际出图时以对应子技能的 SKILL.md 与目录内脚本为准。nano-banana-pro-prompting）可与总技能、服务商子技能组合，但不能替代服务商子技能完成鉴权与请求。本仓库将「出图」拆成 1 个总技能 + 若干后端子技能，避免把某一云厂商或某一账号流程写死为唯一路径。
| 类型 | 目录名（name） | 何时阅读 |
|---|---|---|
| 总览 | image-generation | 工作流、授权、与提示词技能配合、选哪个后端 |
| UCloud ModelVerse | image-generation-ucloud | 使用 UCloud 文档中的 ModelVerse 图像 API |
| OpenRouter | image-generation-openrouter | 使用 OpenRouter 调用 Gemini 等图像能力 |
约定：以后若增加其他供应商，使用同一前缀 image-generation- + 短后缀（如 image-generation-xxx），并在本文件表格中补充一行。
image-generation-* 服务商子技能为准，本文件不重复罗列以免与子技能脱节。nano-banana-pro-prompting；单次 API 请求的提示词须自包含，勿假设模型能「记住上一张图」（见该技能与 AGENTS.md）。image-generation-ucloud 或 image-generation-openrouter；二者与提示词技能正交，可任意组合。在运行各服务商脚本或替用户发起出图请求之前，先确认对应密钥是否已配置；若未配置，不要静默失败，应提示用户优先在项目根目录下创建 .config/ 内密钥文件（再备选环境变量）：
| 后端 | 优先（项目根） | 备选（环境变量） |
|---|---|---|
| UCloud | .config/UCLOUD_API_KEY | UCLOUD_API_KEY |
| OpenRouter | .config/OPENROUTER_API_KEY | OPENROUTER_API_KEY |
文件内容为单行密钥文本，UTF-8 编码；勿将密钥写入仓库或技能正文。脚本会从项目根向上查找含 .config 的目录（详见各子技能说明）。
image-generation-ucloud；若使用 OpenRouter 则读 image-generation-openrouter。各云厂商的 模型 ID、参数、请求体 差异大，本仓库将 Python 示例脚本放在对应子技能目录，避免一个脚本里堆满互斥逻辑：
| 服务商 | 脚本路径 | 依赖 |
|---|---|---|
| UCloud ModelVerse | generate_ucloud_image.py | requests |
| OpenRouter | generate_openrouter_image.py | requests |
将对应技能目录安装到你项目中的技能路径（以所用工具文档为准）后，在项目根执行；脚本通过向上查找含 .config 的目录定位密钥文件，详见各脚本 --help。本仓库不提供本地离线出图示例脚本（能力因环境差异大，由用户自行选用工具链）。
总技能目录不再提供「三合一」聚合脚本；换后端时换目录与脚本即可。