Genstory AI 故事生成
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_25b4401b/genstory-ai-story-generator。
技能介绍
要解决什么问题
在自动化工作流里,你往往只需要两件事:一段可分享的故事页链接,以及封面图等元数据,而不是自己在本地拼页面或维护生成状态机。Genstory 提供托管故事页与异步任务 API;本技能把「鉴权 → 提交任务 → 轮询 → 结构化返回」收敛成一条可复用的调用约定,让 Agent 在对话或流水线里直接交付 story.url 与 story.cover_url。
技能如何工作
- 从环境变量或技能配置读取
GENSTORY_API_KEY(需用户在 Genstory 用户中心 创建)。 - 向
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等字段以控制生成形态。 - 对
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` 约束请求体字段与成功态返回形状的技术写作者