返回文档中心快速上手

上传 Skill 包与启动提示词

解释如何上传压缩包、复制启动提示词,并让 Agent 先完成安装验证和 dry-run。

上传 Skill 包与启动提示词

下载 Skill 后,最推荐的使用方式是上传压缩包并复制启动提示词。这样 Agent 能自己读取包内说明,而不是让用户手动理解所有文件结构。

上传前检查

  • 确认下载包来自 IC Hub 授权链接。
  • 保存包名、版本和 SHA256。
  • 确认当前会话可以上传 zip 或解压目录。
  • 先准备不涉密的样例资料。

启动提示词模板

请先读取我上传的 IC Hub Skill 包。
1. 说明你读到了哪些文件。
2. 复述本次任务目标和适用边界。
3. 列出还需要我补充的 FPGA 项目资料。
4. 先给出安装验证和 dry-run 计划,不要直接修改工程文件。

Agent 应先输出什么

Agent 读取 Skill 后,应先输出四类信息:

  1. 它理解的任务目标。
  2. 当前资料是否足够。
  3. 使用本 Skill 的执行计划。
  4. 风险点和需要人工确认的动作。

什么时候继续执行

只有当 Agent 的计划清楚、输入资料足够、风险边界明确时,才继续提供真实项目资料。涉及烧录、联网、删除文件、写入硬件、客户资料或最终签核时,必须人工确认。

常见失败原因

  • Agent 没有读取 zip 包。
  • 没有复制启动提示词。
  • 输入资料不足。
  • Skill 场景与项目不匹配。
  • 上传目录或文件权限异常。