简诗 AI

解决 SEO 视觉资产的规模化生产难题

搜索引擎与社交平台的算法日益依赖富媒体内容，但高质量的 SEO 配图往往成为内容团队的瓶颈。手工寻找素材库图片难以保证品牌调性，且尺寸、清晰度和 Schema 标记常常不达标；而临时调用 AI 绘图工具生成的图片，往往缺乏结构化提示词（Prompt）约束，后期优化（如 WebP 压缩、Alt 文本编写）费时费力。此外，AI 生图的成本不透明，批量生成容易导致预算失控。

这个技能专为 Claude Code 设计，旨在通过标准化的流水线生成符合 SEO 规范的生产级图片。

核心能力：从需求映射到 SEO 交付

该技能构建于独立的 banana 扩展之上，采用双组件架构：

• 生图执行器（SKILL.md）：处理交互式的 /seo image-gen 命令。
• 审计规划 Agent：在运行 /seo audit 时被触发，仅对现有的 OG（Open Graph）或社交分享图片进行审计分析，并输出生成计划，不会自动生成图片。

1. 场景化参数预设
技能内置了八种常见的 SEO 场景映射，自动应用最佳实践参数：

• OG/社交分享图：16:9 比例，1K 分辨率，偏向产品或 UI/Web 模式，确保文字友好。
• 博客头图（Hero）：16:9，2K 分辨率，使用电影或编辑风格，强调氛围感。
• 信息图（Infographic）：2:3 竖屏，4K 分辨率，确保密集数据清晰可读。
• 其他还包括产品摄影（白底、棚拍灯光）、Schema 专用图、Favicon 图标等。

2. Creative Director 提示词引擎
每次生成不会直接调用模型，而是通过 banana 创意管线构建结构化的「推理简报」。系统会加载 prompt-engineering.md 中的六组件体系，并根据场景动态调整权重（例如：主体占 30%、风格 25%、上下文 15%）。指令强调「具象且有冲击力」的描述，让模型更准确地捕捉摄像机视角。

3. 模型路由与成本控制
技能实现了智能的模型路由策略，而非一刀切：

• 快速草稿/OG 图：使用验证过的 NANOBANANA_MODEL @ 1K/512，优先速度与成本。
• 高质量 Hero 图/产品图：调用 2K 分辨率，细节更丰富。
• 含大量文字的信息图：开启高思维链（thinking: high）模式，提升文字渲染精度。

生图前会展示预估费用，生成后通过 cost_tracker.py 记录日志，确保 API 消耗透明可控。

4. 自动化 SEO 后处理清单
这是区别于普通生图工具的关键。每次成功生成后，技能会引导用户完成以下优化步骤：

• Alt 文本：生成描述性、富含关键词的替代文本。
• 文件命名：重命名为 keyword-description-widthxheight.webp 格式。
• 性能优化：建议转码为 WebP 格式，并建议头图控制在 200KB 以内，缩略图在 100KB 以内。
• Schema 建议：自动提供 ImageObject 的结构化数据标记片段，便于搜索引擎抓取。

边界与注意事项

• 前置依赖：必须预先安装 banana 扩展。技能在启动前会检查 gemini_generate_image 等 MCP 工具的可用性，若未安装会提示用户。
• 安全与稳定性：若遇到 MCP 配置错误或限流（429），技能提供了降级方案，可通过命令行脚本（如 generate.py）直接执行。
• 跨技能协同：该技能通常作为工作流的一部分运行，接收 seo-images 的审计结果或向 seo-schema 输送图片资产。