创作 Skills（标准 Agent Skills）

创作 Skill 是一个标准 Agent Skill 包：一个文件夹，里面至少有一份 SKILL.md（可以再带 references 等附件）。不用改软件本体，就能自定义剧集 / 角色 / 场次 / 分镜怎么写，或替换角色多视角、分镜静帧风格等生图策略。包格式只有这一种，不需要额外的清单文件。

先按最快上手把云端模型跑通，再来装 Skill。装包成功不等于已经出了内容。

在哪里管理

打开 设置 → 创作智能体，里面有两个页签：

Skills 库：导入、启用 / 停用、编辑、卸载技能。
创作 MCP：让你自己的智能体（Cursor、Codex 等）调用比格熊开放的创作工具，见本章最后一节。

开箱怎么用

打开 设置 → 创作智能体 → Skills 库。
点打开随包案例，把 user-examples\agent-skills\ 里想用的案例文件夹复制到文档等可写位置（不要在 Program Files 里直接改）。
点导入 ZIP / SKILL.md（选 zip 或单个 SKILL.md）或导入文件夹。一个文件夹或 zip 里有多个技能时，会先列出全部并提示「将处理 N 个技能：导入…个，跳过…个，…个不能导入」，确认后再装。
看导入预览：格式符合标准才能装；本机已有同名技能时按钮是替换安装，确认后才会替换；内容完全相同则不会有任何变化。点安装完成。
导入只安装文件，不会触发任何生成。要让技能参与创作，到对应的生成入口去选它（见下一节）。

作者建议：SKILL.md 开头说明头里的 name 与所在文件夹同名，使用小写英文字母、数字和连字符；description 必填。名称大小写或目录不一致会收到警告，危险名称和缺少必填字段会阻止导入。

导入以后怎么生效（L1 / L2 / L3）

L1 已装到本机：导入成功就是这一层。
L2 已选用 / 已绑定：编排类技能在生成入口的「编排方式」里选（默认「内置编排」）；生图策略要在定妆等工作台里选用；场次级技能在场次工作台按场绑定。
L3 真正生成：点开始生成之后才算出了内容。

场次工作台按场绑定

每个场次可以单独绑定三种技能，只影响这一场，不会因为安装就接管所有场：

本场故事板 Skill：控制本场分镜的返回格式（默认官方）。
本场分镜优化 Skill（可选）、本场片段优化 Skill（可选）：点「AI 优化提示词」时使用。

单次优化时，还可以在「本次优化使用」里选官方默认格式、按本场绑定（未绑定=官方）或某个优化技能。

版本固定：绑定会固定在你选择时的那个版本。技能内容更新后，界面会提示「绑定的技能内容已更新。确认后才会改用新版本，系统不会自动替换。」，点更新到当前版本才会改用新版。绑定的技能被卸载或停用时，作品内容不受影响，但要重新选择技能后才能再生成。

格式不合格时

模型返回不符合技能格式时，软件按同一格式自动修一次；仍不合格则这一场停下，出现挂起卡片，三个选择：

放弃并重新生成
保存草稿并自己改：改完、满足条件后再保存为正式分镜。
继续写入已保留的分镜

已完成的场次会保留。选了技能却失败时，软件不会偷偷改回内置编排假装成功。

管理技能

筛选：用状态下拉选全部、已启用、已停用或需要处理，也可以搜索名称。
每张卡片：启用 / 停用、编辑、卸载；拖动卡片可调整顺序。
卸载不会取消已经在跑的任务；已绑定它的场次会提示技能不可用，需要重新选择。
内置技能：打开技能库时自动安装，来源显示为「内置」。角色多视角三份：character-multi-angle-reference、character-expression-nine-grid、character-costume-reference。视频提示词格式五份：generic-video-prompt-writing、kling-prompt-writing、seedance-prompt-writing、wan-prompt-writing、h3-prompt-writing。视频工作台里选「提示词格式」时用后面这五份，不在随包案例目录里。

用途：库里有，工作台里不一定有

每个技能可以声明它能用在哪些工作台。不声明，或声明被清空，技能仍在技能库里，但任何一个工作台的选择器都不会列出它。这不是默认全开。

在技能库卡片上改「用途」。改过之后以你改的为准；要回到包里原来的名称和用途，点卡片上的「重置」。

用途	会出现在
`multi-view`	多视角定妆
`scene-storyboard`	生成分镜
`optimize-storyboard-shot`	优化分镜
`optimize-segment`	优化片段
`content-plan`	编排
`video-photography-style`	摄影风格
`storyboard-still-style`	静帧风格
`video-prompt-projection`	提示词格式

库里能看到、工作台选不着：先打开该技能的用途，看里面有没有这个工作台。随包案例和起步模板都要带合法用途，导入后才能按声明出现在对应选择器。

视频提示词格式怎么扩展

上面五份视频提示词格式是内置包，不在 user-examples\agent-skills\ 案例里。要改一份写法：在技能库导出对应内置包，改副本后再导入。不要把案例目录理解成已经包含这些格式。

h3-prompt-writing 是本项目编写的 h3@1 兼容方法，随软件内置，也可以从技能库导出后在本机编辑。MiniMax 和 H3 名称只用于标识目标模型；安装包不包含 MiniMax-H3 仓库中的官方 Skill 原文。

本章没有写成已完整可用的能力

分类、标签，以及用外部智能体完整管理技能库（导入以外的全套管理），还没有写成可以跟着操作的用户说明。本章不把它们写成已经完整可用。文字写入以本章最后一节「现在能做 / 现在还不能」为准。

旧版技能包怎么办

早期版本的旧格式技能包已不再直接使用。点升级旧版技能包…，预览后点确认升级（N 个），旧包会先备份再转换成标准包。旧的场次绑定和排序可以用确认迁移绑定和排序一并迁移。升级前，旧格式技能不能被选用。

随包案例

安装目录 user-examples\agent-skills\，每个子文件夹是一个可导入的包。案例只演示包格式与写法。

类别	案例	说明
编排	`chapters-only`、`bible-roles-chapters`、`staged-to-shots`、`scenes-only-wuxia-budget`、`bgx-screenwriter`	在「编排方式」里选用，控制先写什么、写到哪一层。
固定分镜格式	`shots-six-fixed-schema`	固定镜头数和固定写法，适合先熟悉格式约束。
戏种分镜	`storyboard-action-fight`	打斗节拍，偏低机位 / 手持。
	`storyboard-micro-expression`	对白、微表情：近景 / 特写，运镜偏静止。
	`storyboard-performance`	表演节拍（可见动作调度），同包还带单镜提示词优化规则。
	`mixed-scene-bind-guide`	混绑验收说明，不要拿它代替打斗或微表情包。
优化	`optimize-storyboard-fight`、`optimize-storyboard-micro-cu`、`optimize-segment-continuity`	绑到「本场分镜优化 / 片段优化」。
生图策略	`character-expression-nine-grid`、`character-costume-reference`、`character-multi-angle-reference`、`generation-policy-*`	多视角定妆或静帧风格；策略包不会自己创建生图任务，仍要在工作台点生成。同名角色包与软件内置不是同一份字节，用途都是多视角。
视频提示词格式	不在案例目录	只用内置五份。要改，从技能库导出后再导入。见上文。

戏种分镜与混戏

武打动作戏 → storyboard-action-fight；对白、微表情近景 → storyboard-micro-expression；强调可见动作调度 → storyboard-performance。
产品按场分绑，不会半场混装。同一场又有打斗又有文戏时，拆成两场分别绑定，或自己写一个混场技能。

不要一场挂两个互斥格式（例如又要全景手持武打，又要只许特写静镜的微表情）。绑错戏种会导致格式检查不通过。

给作者的文档（随安装包）

安装目录 user-examples\agent-skills-authoring\：

CONTENT_SKILL（中文 / 英文分开）：字段与写法说明。
AUTHORING_SPEC、AUTHORING_PROMPT_PACK（中文 / 英文）：可整份交给编程智能体或其它 LLM 照着写。
agent-skill\：起步模板，复制后改名（文件夹名要和 name 一致），并保留合法用途。
hosts-closure.zh-CN.md / hosts-closure.en.md：用途闭集。机器可读列表是 agent-skill-hosts.snapshot.json。

和「提示词规范」是什么关系

设置里的提示词规范与分镜优化 / 片段优化技能不是重复设计，点「AI 优化提示词」时会叠两层：

提示词规范：项目级写法，启用后每次优化都会注入。
优化技能：这次优化的返回格式和戏种规则；未选则用官方默认格式。

长篇写作规矩放规范里，技能只写戏种差异，不要两边抄同一段长文。

创作 MCP：让你的智能体写进比格熊

本地智能体通过创作 MCP（bgxiong-creator，本机 127.0.0.1:18451）使用和软件内助手同一套工具。可以创建故事，也可以改已有剧集的标题、文学剧本和 AI 提示词。本地修改不再要求四档确认。旧的文字 MCP 端口 18450 已退役。

保持比格熊在运行。没有文本模型也可以做本地读写。需要软件代为调用付费模型时，仍使用你在软件里选好的服务和真实授权。
打开 设置 → 创作智能体 → 创作 MCP，点打开创作 MCP 口。按你用的客户端复制 Cursor 配置或 Codex 配置，不要把 Cursor 的 JSON 贴进所有客户端。
智能体连上后读取 bgxiong-creator://docs/handbook/zh-CN。安装版在程序旁的 creator-client 目录里有同一份手册、合同和轻量客户端。
口令只在 HTTP 连接时使用，stdio 配置里不要写口令，也不要提交到 git。

图片和视频的新增生成规则还没有定稿，所以没有对应的新工具。已经发布的媒体读取和管理工具仍然可用。厂商插件开发用的是另一套适配器 SDK，不是这里的 MCP 客户端。

常见误会

导入成功 ≠ 已经生成剧集 / 分镜；导入 ≠ 立刻接管所有分镜。
只装生图策略包不会自动出图，还要在工作台选用并手动生成。
装了戏种分镜包不会全局生效：只作用于已绑定的场。
提示「绑定的技能内容已更新」不是出错：确认后点「更新到当前版本」即可。

软件内「学习专栏（帮助）」的「Skills 库（Agent Skills）与创作 MCP」一节也有同主题说明。第三方厂牌插件见第三方适配器。