Skill 原始素材能力：上传多模态素材并生成 Skill / 测试用例草稿

[shihao-Liiiii]

目标

让 Skill 拥有“原始素材”能力。用户可上传现实任务相关材料，并基于这些材料生成 PSOP Skill 草稿和测试用例草稿。

需求范围

• Skill 增加原始素材入口。
• 支持素材类型：
  • 文本
  • 图片
  • 音频
  • 视频
  • PDF
  • 日志或其他文件
• 素材归属于 Skill。
• 大文件进入对象存储，数据库只保存引用。
• 支持基于素材生成 Skill 草稿：
  • 目标
  • 适用边界
  • 阶段步骤
  • 证据要求
  • 安全约束
  • 完成标准
• 支持基于素材生成测试用例草稿：
  • 多信道输入事件
  • 阶段输出期望
  • 素材资源引用
• 生成链路必须经过 LLM Inference Gateway。
• 生成结果默认进入 draft，不自动发布、不自动编译、不覆盖用户已有内容。

接口 / 数据影响

• 新增 Skill Raw Material 数据对象或等价模型：
  • skill_definition_id
  • name
  • description
  • material_kind
  • mime_type
  • artifact_object_id
  • source_note
  • status
  • created_at
• 新增接口建议：
  • POST /api/skills/{skill_id}/raw-materials
  • GET /api/skills/{skill_id}/raw-materials
  • DELETE /api/skills/{skill_id}/raw-materials/{material_id}
  • POST /api/skills/{skill_id}/raw-materials/generate-skill-draft
  • POST /api/skills/{skill_id}/raw-materials/generate-test-scenario-draft
• 生成记录需要保存素材 id、prompt metadata、prompt hash、模型原始输出和生成理由。

前端范围

• Skill Detail 新增“原始素材”tab 或在 Source/Test 附近新增素材区。
• 支持上传、列表、删除。
• 支持选择素材后生成 Skill 草稿或测试场景草稿。
• 生成后进入可审阅、可继续编辑的 draft 状态。

验收标准

• 可上传并管理 Skill 原始素材。
• 可选择一个或多个素材生成 Skill 草稿。
• 可选择素材生成测试场景草稿。
• 生成的测试场景 timeline 引用素材资源，而不是内嵌二进制。
• 生成记录可追溯素材 id、prompt version/hash、模型输出和生成理由。

测试建议

• 后端测试覆盖素材上传/list/delete、生成 skill draft、生成 test scenario draft。
• 前端 Jest 覆盖素材入口、上传入口、生成按钮、生成结果跳转。
• 对象存储 mock 覆盖大文件只存引用的行为。

约束

• 生成结果不自动发布、不自动编译。
• 不覆盖用户已有内容，默认进入 draft。
• 生成链路必须经过 LLM Inference Gateway。

任务拆解

• 后端建模：定义 Skill Raw Material 与生成记录的数据结构、DTO、Repository 与 Service 边界。
• 素材管理 API：实现上传、列表、详情/内容读取、删除，并确保大文件只保存对象存储引用。
• 多模态素材处理：覆盖文本、图片、音频、视频、PDF、日志/其他文件的 metadata、提取结果与错误状态。
• Skill 草稿生成：基于选中素材经 LLM Inference Gateway 生成目标、边界、阶段步骤、证据要求、安全约束、完成标准。
• 生成记录追踪：保存素材 id、prompt metadata、prompt hash、模型原始输出与生成理由。
• 前端素材入口：在 Skill Detail 中增加原始素材区域，支持上传、列表、删除、预览与状态展示。
• 测试场景草稿生成：生成多信道输入事件、阶段输出期望，并通过素材资源引用而不是内嵌二进制。
• 前端生成流程：支持选择一个或多个素材生成 Skill 草稿/测试场景草稿，并进入可审阅、可继续编辑的 draft。
• 测试与文档：补充后端 pytest、前端 Jest、对象存储 mock 覆盖与设计文档说明。