62656456/ai-film-skills

这套技能解决什么问题

你可以拿着点子、小说、剧本、参考图或已经确定的镜头开始。这里把创作工作分成可以单独使用、也能相互交接的职责：

• 故事与导演：把人物目的、行动、对白和场景因果写成可读剧本，再确定表演、视觉、声音与剪辑方向。
• 视觉与资产：选择与故事相称的视觉语言，设计能反复使用的人物、场景和道具，保住身份、空间与状态。
• 分镜与摄影：决定观众先看什么、从哪里看、看多近，安排调度、机位、光色、运镜、节奏与切点。
• 提示词与制作：保留已选镜头，编译生成提示词；明确进入实际制作后，组织生成、选片、剪辑、声音与完整看片修复。
• 研究与辅助：按需研究市场、审核知识写入、检查 3D 机位与走位，或设计创作工具的界面。

已有材料直接接续。 只改对白，就交对白修改；只要分镜，就交分镜；已有批准的导演方案或资产，就继承它们。每次交付都以本次请求为准。

这里的 Skill 是给宿主代理读取和执行的创作指令包，不内置视频模型、账户、额度或全部制作软件。实际图片、视频与预演需要宿主具备相应工具和执行条件。

全部 21 个技能：什么时候用，拿到什么

下列 18 项常规包和 3 项实验包都在仓库中。每一项均可单独选择，链接直接打开对应中文说明；完整源码与版本目录和英文说明另列。

编剧与导演 · 2 项

人物、场景与道具资产 · 3 项

类型视觉与美术 · 8 项

这些技能把题材要求落实到光色、空间、材质、构图和动作。它们服务于已有故事、资产与镜头，输出当前任务需要的视觉方案或提示词参数；实际出图按请求和工具条件进入。

制作与短剧控制 · 2 项

研究与知识审核 · 2 项

网页与创作工具界面 · 1 项

实验包 · 3 项

实验包另行选择安装，具体能力和验证范围写在各包说明中。

外部仙侠入口：xianxia-visual-director用于仙侠世界、天宫巨构与写实摄影。本仓库只链接上游，不分发它的源码或 ZIP。它不计入上述 21 个包和 42 份指南；仓库本身是 20 项影视相关技能 + 1 项网页辅助技能。

怎样配合：把已确认的决定交给下一步

flowchart TB
    A["点子、小说、剧本或已有素材"] --> B["剧本与导演方案"]
    B --> C["视觉方向、人物场景道具"]
    C --> D["分镜与摄影"]
    D --> E["按请求编译视频提示词"]
    E --> F["明确进入实际视频制作"]
    F --> G["剪辑、声音、完整看片与修复交付"]
    E -. "明确需要时" .-> P["3D白模预演"]
    P -. "修订具体机位与走位" .-> D

已有剧本可以直接进入导演或资产阶段；已有导演方案可以直接做分镜；已有分镜可以直接编译提示词。创意思路、分镜、提示词、实际生成分别进入，不自动升级阶段。 重要创意先作为备选，采用后才写入正式镜头。

短剧控制技能把已有决定组织成生产合同；市场研究先交报告和候选，知识写入等待明确批准；网页技能在有独立界面任务时使用。各阶段的完整职责与返回关系

功能怎样落到实际创作里

把故事写成行动，再让画面承担信息

导演 Agent 处理人物为什么行动、对白改变什么、场景怎样把状态传到下一场。分镜导演处理观众从哪里看、先知道什么、何时看见关键变化。已有的表演、情绪或镜头被认可后，局部改稿继续保留它们。

当前分镜 5.8.6 先比较同剧情下的起点、转折和终点：对象在框内多大，哪些关系同时可见，空区和遮挡怎样影响信息。选定观看方案后，才安排摄影机制；包内 115 个 FCML 机制用于按需检索与绑定，不代替创作选择。

让人物、场景、道具在不同镜头中仍属于同一个世界

人物参考保留身份和服装；场景参考保留布局、出入口、光源与材料；道具参考保留结构、持用和状态。分镜接收这些决定，再推导当前机位看到的左右、纵深、遮挡与受光。美术参考、风格参考、指定首帧和末帧各自承担明确职责。

把电影质感写成能观察的选择

光色、材质、取景和运动在设计阶段共同决定，再进入分镜和提示词。手持写出晃动由何产生、怎样变化与收稳；人物速度、摄影机速度、播放速度和剪辑密度分别组织。打戏保留应答、接触、持物、支撑和共同空间，实际光形来自同一世界中的光源、遮挡和反射。

从文字进入实际媒体，用可播放结果检查

视频生产技能继承已选方案，组织实际生成与后期。白模用于明确范围内的机位、视差、走位或已实现动作检查；视频制作还要看完整动作、声音和前后连续。失败时修复最早失效的故事、资产、摄影或执行环节，继续保留有效内容。

已有作品与研究：原图、原视频和状态都能查看

下面是已有成果的代表图，点击查看完整原图。它们分别属于对应的历史批次，保留原接受范围；静帧和界面截图不承担视频执行或全库稳定性的证明。

已接受的视觉与界面作品

历史展示共 21 张：19 张原创生成静帧、2 张原创界面截图。全部原图、来源与对应的用户接受记录保留在下面的完整展示中。

六种视觉风格：人物、环境和材质共同变化

胶片诗意写实、东方岩彩、铜版线刻、纸雕剧场、羊毛毡定格感与釉彩瓷偶，围绕相近题材进行探索。研究得到的具体方法是：风格规则必须覆盖人物和环境；羊毛毡版本针对水面进行了单独修订，避免真实液体与纤维世界混杂。六图为静态研究候选。完整图、可复制提示词与风格规则

古风真实感：让人物与环境处在同一束光里

从“色彩与故事感成立、真实感不足”的六朝首图出发，继续修订肤色、照明与材质，再以窗边家书、田埂递秧、檐下挑货验证新的生活场景。新图仍待审阅。六朝原图→修订对照与三张新场景 · 古风技能 0.1.1 候选源码

可直接播放的基础预演证据

历史预演证据展示了可观看的机位、走位与短动作门，保留原验收范围：

白模执行器现作为源码中的独立实验包列出；这些历史片段证明有限预演与动作门，不证明任意完整打斗、最终AI成片或新的用户接受。媒体清单

旧5.4.4文字行为案例和历史视觉参考墙仍可查看，保留各自日期与原状态，不与历史21张接受视觉成果混记。

安装与调用：先选一个当前需要的技能

安装当前源码

git clone https://github.com/62656456/ai-film-skills.git
cd ai-film-skills
python scripts/install_skill.py --list
python scripts/install_skill.py director-agent --platform codex

把最后一行的 director-agent 换成上方需要的技能名。安装器支持 codex、claude-code、trae、codebuddy；也可使用 --target 指定项目目录。实验包需要额外明确选择，例如：

python scripts/install_skill.py hard-sci-fi-visual-director --platform codex --experimental

也可以使用 Skills CLI 发现仓库中的技能：

npx --yes skills@latest add 62656456/ai-film-skills --list
npx --yes skills@latest add 62656456/ai-film-skills --skill ai-storyboard-director --agent codex --copy --yes

完整安装说明 · 宿主兼容与实际验证范围 · 42份中英指南

三种常见起点

从故事开始：

使用 $director-agent，把下面的故事写成可读剧本。
保留已确认的人物、情节与结局，重点写清行动、对白和场景因果。
本次先交剧本；有需要澄清的事实就明确标出。
[粘贴故事与已有要求]

从资产开始：

使用 $scene-asset，为下面的场景设计主图和一张独立反打。
保持同一空间布局、出入口、光源和物件状态。
本次先交完整图像提示词与空间说明。
[粘贴剧情、场景信息与已有参考]

从已定导演方案开始：

使用 $ai-storyboard-director，根据下面的剧本与导演方案编排30秒分镜。
保留原动作、台词、空间和结局，写清时间、机位、摄影、画面和声音。
本次只要可读分镜；另有拍法思路时单列作用和取舍。
[粘贴剧本、导演方案与锁定项]

需要提示词时，再请求把已选分镜编译为完整母提示词；明确要实际视频或3D预演时，再进入对应制作。宿主能否自动发现、加载和调用技能，以实际安装与运行结果为准。

当前能确认什么

常规与实验是分发类别。安装成功、文字成立、媒体执行和用户接受分别记录；市场分析保留来源和日期，知识写入需要明确批准。短剧控制包的实际视频效果尚待验证；FCML机制库的实际模型效果未由程序检查替代。白模需要兼容运行环境，新打斗规格不能借用旧动作门的通过状态。

研究总览 · 共同审核逻辑 · 历史CLI验证 · skills.sh目录

English overview

Open Film Skills is a repository of 21 independent Agent Skills: 18 regular and 3 experimental, with 42 English/Simplified Chinese guides. It covers screenplay writing and directing, reusable character/scene/prop assets, eight genre visual routes, cinematography and prompts, actual video production, short-drama control, market research, approved knowledge updates, web interfaces, hard science fiction, guofeng and bounded 3D previs.

Choose a Skill by the task and deliverable listed above. Existing approved decisions pass to the next stage. Current Storyboard Director source and the new release are 5.8.6; the frozen v1.4.0 archive still contains 5.7.2. Native host support, actual media execution and user acceptance are verified separately. External xianxia is linked upstream and is not part of the 21 redistributed packages.

English guides · Installation · Source catalog

许可、来源与参与

原创技能、脚本、文档、提示词和明确授权的原创示例按仓库许可及各自来源说明使用。第三方参考和外部上游保留各自许可与范围；私人项目、账户凭证和本机状态不进入公开资料。

Apache License 2.0 · 原创版权与商用 · 第三方说明 · 公开范围 · 贡献说明 · 安全反馈 · 讨论 · 问题反馈

版本更新与历史下载

2026-10-15 · GitHub首页介绍全面重整

本次按整个仓库重写README：前置21个技能的适用任务和直接交付，补齐阶段交接与三种调用示例；完整作品与研究重新分组，保留原图、视频和验收状态。当前介绍由本仓库首页直接承载。

2026-10-18 · 分镜导演5.8.6与专业光学默认选型

六模块保持，视觉风格放第二；生成任务具体写媒介、风格参照与摄影方式且不限一句，第二模块再次强化同一摄影方向，末尾集中负面提示词。按观看需要主动选择普通微距、探针/潜望、分焦、移轴、变焦或具体镜组，专业名称与实际画面过程一起表达；不固定三镜、不将所有微距套成探针。制作编译入口同步，场景设计本轮不改。

版本与验证记录 · 当前发布下载

2026-10-14 · 分镜导演5.8.3与导演Agent同步

以完整5.7.7为基础，合入5.8.2的FCML离线镜头库、观看距离与起中终画框设计、可选设计保存和编译保全。原电影摄影、四种速度、真实光影、对招、持物、共同空间及格式规则保留；导演Agent的场景交接、观看方案比较和编译复核同步。

合并、检查与版本保全记录 · Git中的完整5.7.7回退快照