Agent Skills
返回列表
Genstory AI 故事生成

Genstory AI 故事生成

内容创作 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_25b4401b/genstory-ai-story-generator。

技能介绍

要解决什么问题

在自动化工作流里,你往往只需要两件事:一段可分享的故事页链接,以及封面图等元数据,而不是自己在本地拼页面或维护生成状态机。Genstory 提供托管故事页与异步任务 API;本技能把「鉴权 → 提交任务 → 轮询 → 结构化返回」收敛成一条可复用的调用约定,让 Agent 在对话或流水线里直接交付 story.url 与 story.cover_url。

技能如何工作

  1. 从环境变量或技能配置读取 GENSTORY_API_KEY(需用户在 Genstory 用户中心 创建)。
  2. 向 POST https://www.genstory.app/api/v1/story-tasks 提交任务,请求头使用 Authorization: Bearer ${GENSTORY_API_KEY};请求体至少满足最小 JSON,并建议带上 prompt、title、character_name、scenes_count 以及 generation_type / generation_mode、layout_mode、page_spec、public_visibility 等字段以控制生成形态。
  3. 对 GET https://www.genstory.app/api/v1/story-tasks/{task_id} 轮询:pending、processing 视为进行中;failed 时应把 API 错误信息明确抛出;success 时返回约定结构,优先包含 story.id、story.title、story.url、story.cover_url、story.locale,并引导用户打开托管页验收。

更完整的请求/响应示例见技能内 references/api.md。

适用边界与注意点

  • 本技能面向 调用 Genstory 远程 API 生成托管故事,不包含本地排版引擎或离线渲染。
  • 未配置有效 API Key 时不应静默失败;应在开始前提示用户配置 GENSTORY_API_KEY。
  • 生成耗时取决于任务队列与模型处理,轮询策略需容忍异步延迟;失败场景以 API 返回为准,不要臆造成功结果。

使用场景

  • 对话式 Agent 根据用户给出的 `prompt` 与角色名提交 Genstory 任务,生成完成后把可打开的 `story.url` 回传给用户。
  • 内容流水线在夜间批量调用故事任务 API,按 `scenes_count` 与 `layout_mode` 生成多页故事并收集 `cover_url` 做封面归档。
  • 集成测试或演示脚本需要验证 `GENSTORY_API_KEY` 鉴权、任务 `pending/processing` 轮询以及 `failed` 时错误信息是否可读。
  • 需要将生成结果写入工单或 CMS 的运营流程:只关心 `story.id`、`title`、`locale` 与公开可见性 `public_visibility` 等结构化字段。

适合人员

  • 在 Agent 工作流里要把用户创意落成 Genstory 托管页、又不想手写 POST/轮询逻辑的独立开发者
  • 负责儿童/互动内容产线,需按 `character_name` 与场景数批量出故事并回收封面链接的内容运营
  • 做企业内部创作工具集成,要把 Genstory 异步任务封装成统一输出契约(URL + cover + locale)的后端工程师
  • 编写技能或插件维护者,需要对照 `references/api.md` 约束请求体字段与成功态返回形状的技术写作者