将 MiniMax H3 案例库与 Prompt 教程接入 Codex/Claude Code 作为 Agent Skill 可查证调用

方案简介

本仓库是一个 MiniMax H3（又称 Hailuo H3、海螺 H3）的案例与实战教程库，收录 2020 个可播放视频、651 条完整公开 Prompt 和 25 篇教程。除了作为网页浏览的案例站，它还把核心能力封装为三个 Agent Skill，通过 npx skills add 一条命令同时安装到 Codex 与 Claude Code，让 AI 编程助手可以直接查询真实案例、获取逐字 Prompt、按系统与硬件推荐核验过的教程路线。

这套方案的核心差异化在于「来源可追溯」：只有来源完整公开的 Prompt 才按原文展示，本站绝不反推、补写、改写或伪造缺失 Prompt。因此它特别适合希望让 Agent 基于可信资料回答 MiniMax H3 相关问题的开发者，以及想按自己硬件（NVIDIA、Apple Silicon、8–12GB 显存）入门 H3 视频生成的创作者。

亮点与能力

• 查真实案例：来源完整公开时返回逐字 Prompt
• 根据系统、GPU、显存、时间和目标选择核验教程路线
• 把案例或教程材料整理成可提交的 Issue 草稿
• 不生成、不改写、不翻译、不反推 Prompt
• 不猜命令、版本或兼容性
• 两个读取型 Skill 都带可独立运行的查询脚本，默认读取本站公开目录
• 网络不可用时明确失败，不生成虚构内容
• 支持隔离目录验证安装结果

组成与分工

• Codex / Claude Code：Skill 的运行宿主 Agent，通过一条 npx 命令同时安装三个 Skill；
• minimax-h3-prompt-library：查真实案例，来源完整公开时返回逐字 Prompt；
• minimax-h3-tutorial-guide：根据系统、GPU、显存、时间和目标选择核验路线；
• minimax-h3-submission-helper：把案例或教程材料整理成可提交的 Issue 草稿；
• Node：本地运行与 Skill 查询脚本的运行环境（参考构建 Node 22.23.1）；
• 对象存储：站内 /media/ 视频播放需自配兼容对象存储；
• NVIDIA / Apple Silicon：教程路线按本地硬件区分推荐。

前置要求

• Node 环境（参考构建为 Node 22.23.1）
• 安装了 Codex 或 Claude Code 的 Agent 宿主
• 验证安装结果：

bash
npm run skills:install:verify

该命令会在隔离目录使用仓库自有离线样例验证安装结果。

实施步骤

1. 安装三个 Skill

一条命令把三个 Skill 同时安装到 Codex 与 Claude Code：

bash
npx skills add https://github.com/SkyNotSilent/awesome-minimax-h3-cases \
--skill minimax-h3-prompt-library minimax-h3-tutorial-guide minimax-h3-submission-helper \
--agent codex claude-code

2. 在 Agent 中调用

• 用 prompt-library 查询真实案例，来源完整公开时会返回逐字 Prompt；
• 用 tutorial-guide 根据自己的系统、GPU、显存、时间和目标获取核验路线；
• 用 submission-helper 整理投稿 Issue 草稿。

3. 验证安装

运行 npm run skills:install:verify，在隔离目录使用仓库自有离线样例验证安装结果。

使用与配置要点

• prompt-library：查真实案例；来源完整公开时返回逐字 Prompt，不生成、不改写、不翻译、不反推；
• tutorial-guide：根据系统、GPU、显存、时间和目标选择核验路线，不猜命令、版本或兼容性；
• submission-helper：把案例或教程材料整理成可提交的 Issue 草稿，不声称已经核验、接受或拥有发布权限；
• 查询脚本默认读取本站公开目录，网络不可用时明确失败；
• 每个 Agent 每次使用都会强制先检查上游最新 README。

注意事项与常见问题

• 读取型 Skill 在网络不可用时会明确失败，不生成虚构内容；
• 站内 /media/ 播放需要配置自己的兼容对象存储，没有存储时仍可打开原始来源；
• 每篇教程都强制要求 Agent 先检查上游最新 README，禁止猜测缺失命令或兼容性。

优缺点

• ✓ 技能带独立查询脚本可离线验证
• ✓ 来源可追溯不伪造 Prompt
• ✕ 站内播放需自配对象存储
• ✕ 读取型 Skill 网络不可用时直接失败

出处

本方案挖掘自开源项目 SkyNotSilent/awesome-MiniMax-H3-cases，方案内容与实施命令均来自其 README 原文。