AI火花案例提交
将以下提示词粘贴到你的 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写通道与参数校验逻辑