Agent Skills
返回列表
AI火花案例提交

AI火花案例提交

AI Agent 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_811f78a5/awe-ai-spark。

技能介绍

解决的工程痛点与核心能力

在 AI 辅助研发过程中,工程师常积累大量碎片化的对话记录与实操经验。将这些经验沉淀为结构化、可复用的案例资产时,往往面临几个具体的工程痛点:直接调用后端 REST 接口写数据会被网关拦截返回 403,封面图缺乏标准化的生成与托管链路,以及鉴权 Token 在工具间传递繁琐。

该技能专为 ai-spark 案例广场设计,通过 MCP 通道安全地完成案例的新建与覆盖更新,核心能力包括:

  • 结构化内容提炼:从当前会话中自动提取 title、summary、content(Markdown 正文)及 tagIds 等核心字段,省略繁琐的表单填写。
  • 封面图全链路闭环:优先调用图像生成能力,或使用自带的 scripts/generate_cover.py 脚本生成 SVG 封面;强制要求通过 upload_file 上传至文件服务器换取公网 URL,避免本地路径导致的展示失败。
  • 安全鉴权提交:调用 submit_case 时,直接从 MCP 上下文读取已注入的 Bearer Token 并显式传入,无需额外查询连接配置。

工作流与适用边界

核心工作流分为四步:提炼字段 → 生成并上传封面 → 调用 submit_case 提交 → 按需传入 caseId 覆盖更新。在使用过程中需注意以下边界与约束:

  • 严格限制写入口:后端网关在 REST 层按 HTTP 方法拦截所有写操作。必须路由至 MCP 通道(submit_case),任何直连 REST 的写请求均会失败。
  • 草稿状态限制:提交后的案例默认创建为 draft 状态,系统不会自动发布。需登录 ai-spark Web 端(案例广场 → 我的 → 草稿)手动执行发布。
  • 参数契约严格:submit_case 工具声明了 additionalProperties: false,调用时只能传契约定义的字段,禁止塞入多余参数。

使用场景

  • 在AI辅助完成的调研结束后,将本次使用的工具、流程与成果总结成案例发布到ai-spark广场
  • 修改已提交的ai-spark案例的封面与正文,直接传入caseId覆盖更新,避免重建
  • 为团队沉淀AI实践经验时,生成并上传符合规范的封面图,再提交完整的Markdown正文
  • 批量整理内部AI应用案例,通过同一个submit_case接口新建或覆盖多条记录

适合人员

  • 研发工程师:需要把AI项目经验沉淀为团队可复用的案例模板
  • 技术运营:负责整理内部AI实践案例并统一发布到案例广场
  • 产品设计师:想把AI辅助设计的过程记录成结构化案例供他人参考
  • 后端开发者:对接AI案例系统时,需要安全的MCP写通道与参数校验逻辑