Skip to main content

check-video

查询已登记视频任务、下载完成视频,或处理需要授权重试与创作修正的失败。

الانتقال إلى التثبيت

معلومات المصدر

المستودع
wddxh/ShortVideoDirector
آخر نشاط في المصدر
١٦ سبتمبر ٢٠٢٦ في ١٥:٠٦
لغة SKILL.md المكتشفة
الصينية
النجوم
٢١
التفرعات
٣

خيارات التثبيت

يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.

مراجعة ملفات المصدر

اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.

عرض SKILL.md

SKILL.md
تعليمات المصدر · معاينة للقراءة فقط
name
check-video
description
查询已登记视频任务、下载完成视频,或处理需要授权重试与创作修正的失败。
user-invocable
false
argument-hint
自然语言查询目标、镜头范围或无人值守检查委托
# Codex 适配器 这是生成的 Codex 适配层。源 skill 仍是唯一事实来源,位置为 `${CLAUDE_PLUGIN_ROOT}/skills/check-video/SKILL.md`。 不要手动编辑这个适配层。只有在确实需要改变 Claude 行为时才修改源 skill,然后运行 `python3 .codex/build-codex-skills.py` 重新生成适配层。 ## 运行时映射 # Codex 运行时映射 `skills/` 是跨平台知识的源。Codex 加载 `.codex/skills/` 下生成的适配层;适配层应用本映射,再按当前委托读取源 skill。 ## 文件和 Shell 工具 - Claude `Read` 表示读取当前工作区中的本地文件。 - Claude `Write` 表示在受托路径创建或覆盖本地文件;审核允许指定临时目录内的 helper STATE、payload 和必要预览。 - Claude `Edit` 表示对本地文件进行定向修改。 - Claude `Glob` 表示按模式查找文件。 - Claude `Grep` 表示搜索文件内容,优先使用 `rg`。 - Claude `Bash` 表示在 skill 必要时执行本地 shell 命令。 - 每次 Write/Edit 内容保持 2000 字符以内,包括 JSON/YAML,不限制最终文件长度。普通短编辑可原位进行;JSON 按完整值/条目增量编辑,每次操作后值和整个文档都须完整有效,不在已发布 manifest 的引号内分次拼接不可分割的长字符串。 - 长值或条目超限时,事先协调读写方、目标/临时路径及发布时机,在授权路径内离开目标分步组装;待发布临时文档须与目标同文件系统。可分步写临时纯文本块,由本地小脚本按序合并并用 JSON 序列化器编码,不猜转义。完整临时文档须通过 JSON 语法解析及所需结构校验,再原子替换目标;失败保留原目标。patch、命令和脚本内容同受工具字符串长度限制,脚本也分步写入,不用巨大 heredoc/脚本载荷绕过限制。 ## 全画面粗代理映射 按 `skills/_meta/rules/visual-prompt-craft-common.md#全画面粗代理映射`:Creator 读实际参考,最终 prompt 开头覆盖所有可辨识粗对象/类别,含环境构件、地面墙背景、家具物品及无资产图对象。写实际颜色/形状/位置辨识→最终对象→采用空间包络(位置、屏占尺度、距离、朝向、路径)→源定最终形状结构、软硬、材质表面/光响应及源动作所需变化。同类重复可成组,不漏视觉类别、不设每网格配额或扩到无关不出场物。有上传图显式绑定,无图按已定源场景美术正面写外观,不强制新增图/卡;必要设计缺回 owner,不捏造资产/token。 全局稳定映射提供基础,不是只能写一次;局部按主要对象、注意焦点、粗形材误继承风险或表达需要可重申乃至完整介绍最终身份/形材,不限于新对象或变化。新对象、换场歧义、身份切换、形材状态或 purpose 变化时补清关系。避免机械复制无关全对象清单,不禁止逐段有目的重复或设次数,保留完整动作和状态变化。每次显式视频仍带具体源 interval、输出 task 段及采用维度,对象介绍按需,无需逐代词 token。粗包络与 camera/light/reveals/cuts 控制不等于盒形轮廓、比例、拓扑、刚性或材质;环境/道具保留声明的空间邻接/通行拓扑,专门 shape/topology 与 fine refs 按实际 purpose 保留结构/材质。逐 ref.use 与 Creator 亲写完整 prompt 同步,不分发 COMMON 成稿,独立稿可序列化;精细源动作不因无肢省略。 Reviewer 依 fresh helper 实际观察语义核全部可见粗对象映射覆盖与形材分离,无图不豁免,同类可 group。重申按适用性、清晰度、一致性及实际影响判断,不因重复本身 fail 或删必要强调。缺素材/目标不明按实报告,具体遗漏或冲突交 Creator;不新增对象 registry、关键词 parser、schema、gate 或精细建模要求。官方提供素材对应、剧情展开及必要重申思路;全对象覆盖和逐处具体区间是 SVD 细化,不冒称官方硬要求。 ## 本地环境报告与方法 按 `skills/_meta/rules/user-decision-relay.md` 的 Local Environment And Method Choice:项目初始化由有界授权的单一 Creator 全面检查支持工具,写固定 `story/work/shared/environment/environment.md` Markdown 报告,逐项记录真实 `pass`/`unavailable`、命令及路径、版本、backend、实际输出和限制;工具清单见 `skills/creator-local-reference/tools.md`。 后续 Creator/需要预览工具的 Reviewer 自行查询,纯文字角色不强制读,Director 不逐次传结果/路径。固定报告是常规 read 依赖,Director 仍集中维护 init/update writer 占用与 stable/等待条件,不假永久稳定。更新需有界授权单 owner;Reviewer 只读不自修。实际失败、环境变化或确切新增需求所需能力未被初始化证据覆盖时,补验更新受影响项;新增能力只验证该需求的未覆盖部分,不每任务探测、常规扫描版本或无理由重复验证。报告仅工具指导时默认不进 manifest.sources 或所有 review 语义 inputs;确用于验收判断时,owner 在该语义读取前 start/add-input,包括交给 helper 读取。 环境可用不指定工具。Director 交目标、完整源、完整 clean+caption MP4 交付要求及依赖权限;Creator 按镜头复用素材、补必要控制并选最简充分手段。除用户明确要求或合理已选局部,不预设批量 `.blend`/CUDA。静态设计与时间合成分别选法,授权返工可换方法;SVG 可选,既有交付与审核契约不新增流程 gate。 ## Skill 调用 - 用户公开入口仅 short-video、series-video,支持斜杠入口和自然语言。edit-story、repair-story、generate-video、check-video、auto-video 是 AI 可发现、加载的内部知识,修改、恢复、提交、查询下载和持续监控工具仍按其契约运行。用户可直接说“修改 ep01 镜头 3 的动作”“恢复 ep01 中断的制作”“提交本地 ep01 的 task03”“查询 ep01 的 task03 并下载”“持续监控 ep01 已登记任务”或“停止 ep01 监控”,由 AI 按实际目标与授权加载并执行。 - 查看配置可用 `/short-video config`、`/series-video config` 或自然语言;只读报告当前配置,缺失不初始化。内部技能保持模型可调用;`user-invocable: false` 控制公开入口可见性,不设置 `disable-model-invocation` 来阻止内部知识加载。 - `使用 Skill tool 调用 <skill-name> skill` 表示在当前上下文加载对应 Codex 适配层。浏览 description 后选择所需知识,不因加载 skill 创建子代理。 - 如果不能直接调用 skill,则读取 `${CLAUDE_PLUGIN_ROOT}/skills/<skill-name>/SKILL.md`,按当前委托加载知识。 - 入口原始请求仅由宿主原生 `$ARGUMENTS` 传输,整体保留,不拆位置或构造索引。内部 skill 消费当前成果、材料、范围和约束,不编造调用参数串。 - `agent` 是知识的角色关联,不转移所有权。真正的角色委托由 Task 建立上下文;不得把 Skill 加载当作角色切换或审核隔离。 创作委托由顶层主 AI 担任 Director,负责用户交互、范围、授权、创作协调和最终制作材料;在当前上下文本地加载内部 `director-orchestrate`,不派发 director agent 或 fork。此规则只描述顶层主 AI,不把专家或 checker 变成 Director。生产规划、主入口与 orchestrate 不设 agent/fork;插件子代理为 reviewer、scriptwriter、storyboarder、creator,`reviewer-review-*` 关联 reviewer。工程委托由主 AI 作为工程负责人,使用与生产角色独立的工程 agents,不借用生产专家。 决策尽量前置:可预见关键选择已满足或明确委托后,在原授权内连续执行,不要求未知艺术细节、额外“开始吗”或逐轮 review/fix 批准。新问题先查配置、材料、grants 并由 Director/专家在权限内判断;仅用户指定检查点、缺必要权限或无法内部解决的关键冲突才需完整决策包。进度不是确认请求,持续许可内动作不重复求同意,固定参数、初始集时长和操作授权边界不变。 生成意图以实际请求为准,不另问许可。short/series 包含所需资产图与本地参考,intake/审核后执行,始终停在付费视频提交前。后续明确提交请求由内部 generate-video 知识按原文与范围登记 initial_authorization,不追加握手。check/auto 仅在当前契约内延续登记 grants 或取回,不补新许可或无限重试。 AI 内部执行遵循 `${CLAUDE_PLUGIN_ROOT}/skills/generate-video/SKILL.md` 的 prepare 流程与 `${CLAUDE_PLUGIN_ROOT}/skills/creator-provider-dreamina/video.md` 的 guarded wrapper 文档。用户通过自然语言说明目标与范围;AI 维护所需授权记录。Prepared 任务仍须校验当前引用、审核、grants 与输入一致性,保留 submission、inflight 及既有状态保护。 摄影 shot 保留七字段及正整数秒,不受 provider 最短/70% 目标限制。用户原始集目标已确认的 ±10% 是主动可用的创作预算;Director 协调 owner 更新 canonical script/storyboard 与受影响下游,范围内不逐次求许可,原始基准不随本轮/前集合计滚动,精确要求优先。Creator 在设计后装组连续 shots,按核实模型最大 M 以 ceil(0.7*M)..M 为语义目标,不是机械下限;装组保留当前源时长、对白、切点,重设计交 owner,不暗中延时。`task-inputs/taskNN.json` 草稿恰为 `{shots,references}`,最终恰为 `{shots,references,prompt}`,prompt 是 Creator 写入的非空白字符串。文件名给稳定 task_id,成员按源顺序连续,每任务至少一个全组 MP4,条目仅 local PNG/MP4。最终 `--json` 返回 `{task_id,shots,timeline,prompt,duration,references,assetCards,sources,inputPath}`,prompt 原样来自 manifest,不重写;时间派生,不另存可编辑 offset/duration 或装组索引。 创作材料使用所选 provider 自有 material tool,具体命令、pack、token 计数/绑定和重基规则见该 provider 文档;Dreamina 见 `skills/creator-provider-dreamina/video.md`。草稿可供材料解析但不表示就绪。共享 assembler 仅提供无 provider token 的内部数据,不是公开通用 adapter;未来 provider 自行实现工具,无需 registry/framework/manifest schema 变更。同组源视频风格精确相同、materials 提取一次;最终 prompt 表达统一基线,可结尾重申必要全局要求。不同基线交 owner,源事实及对白完整保留。身份图按成员首次使用求并集在前,本地媒体在后,每镜链接须自身 header 声明,sources 不上传。 Creator 在视频参考/装组映射确定后读 materials 和 provider 语法,对每 task 实际源 shots/refs、事件、对白与时钟独立亲写完整 manifest.prompt,保留叙事、动作、对白原词、切点、时长及声音,绑定实际 tokens 并解释 BOX/颜色/身体/肢体代理的最终身份、解剖与动作。源局部时间转成明确任务时间;仅清理非成片源标题、内部 task/shot IDs、路径和审核元数据,保留有意上屏原词与 wide shot 等摄影词。缺源事实交 owner,不编造 use。Creator 自查实际最终 `--json` 后交 fresh shot-input Reviewer 核对源忠实度、完整性、局部适用性和集成;提交不改写。 提示表达按 [任务提示组织](${CLAUDE_PLUGIN_ROOT}/skills/_meta/rules/visual-prompt-craft-video.md#任务提示组织) 与 [每任务独立语义写作](${CLAUDE_PLUGIN_ROOT}/skills/_meta/rules/visual-prompt-craft-common.md#每任务独立语义写作):官方建议 1–4/7 及建议 5 转场在其范围内优先,6/extend 排除。公式指导组织,不分发 COMMON 成稿或用脚本/模板代写语义。每 task Creator 亲写,use 同步;独立完整稿可批量序列化。Reviewer 核对源忠实度、完整性、局部适用性和实际 purpose,不按词数、标题、面部细节数量或相同词验收。 转场与文字按 `skills/_meta/rules/transition-craft.md`:区分场内 UI、观众 SUPER/时间地点/章节/全屏卡和内部调试预览。clean MP4 无内部污染,可含正式文字与转场图像;预演底栏字幕仍内部非上传。Scriptwriter 拥有原词和时间事实,已有隔日事实可设计卡片,新跳时交 owner;Storyboarder 管阅读窗口/切点,独立卡计镜头数与预算,叠字不重复计时,装组不加秒。Creator 可选本地文字引导,Reviewer 查来源/原词/阅读/对比/注意/揭示,观众文字不套演员阅读面,不因文字或黑底失败。源/输入验收不保证成片模型质量,不笼统禁字或承诺准确性。 tasks.json 保持数组,task_id 唯一并保存 shots/prompt/duration/typed references,输出 `videos/taskNN.mp4`;submission 保留四元组与有序媒体指纹。Grants 为 `{decision,episode,task_id,shots,constraints}` 加真实可选次数;reserve 前当前 manifest 成员等于 record/grant,错误身份、成员/输入漂移或部分选组零调用、不改次数。取回按 recorded ID/provider,保留 grants/inflight/submitted/done/真实状态。统计按生成任务,human_needed 为 `{ep,task_id,shots,reason}`,每 ep/task_id 一条完整成员;monitor 仍 epNN/all。 就绪用 check-shot-inputs.mjs 及 script/storyboard/asset-visual/shot-input;新生图另审 asset-prompt。整集源 1..N 且每镜分配一次,任务按首成员排序;局部允许源缺号、目标存在且选完整组。全局查组重叠/缺失源成员,局部不要求未选媒体或完整全片计划。未分配请求/部分组报告完整成员与额外镜头,不静默扩授权。 shot-input target 为 `task-inputs/taskNN.json`,纯文本 owner 验收最终参考与 prompt 集成、时钟和接点:整集覆盖所有相邻组(含场/幕),局部只取必要邻界及实际非相邻/跨集依赖,不附全计划哈希。fresh helper 比较实际选中 clean MP4 尾/头相干窗口和两端 prompt,披露音频实听/仅存在/计划;J/L-cut 源原句一次,独立生成音频不虚称无缝。每个消费 owner 预采 inputs 且观察仍适用时复用独立配对事实,不强制两端重复视觉 pass 或建账本。必要邻组缺失只使受影响 target unknown,不扩生成授权。源码/记账变化沿用 scoped 兼容性评估,不盲刷哈希;无具体冲突复用 storyboard 判断。保留五种 kind、fresh task、缩略图及既有 gates,不审生成视频或授权自动剪辑。主 AI/general 负责工程与测试。 通用 storyboard-to-prompt 的 `.sh` 与 `.mjs` 均显式传 `--json STORYBOARD TASK_ID EP`,仅原样返回最终 manifest.prompt,不生成或改写文本。EP 与 canonical storyboard 路径一致;task_id 来自 manifest 文件名,不从首镜推导或与宿主代理任务 ID 混用。最终 `--json` 要求非空白字符串 prompt;草稿不能通过最终审核/就绪,既有 shot-input target 指纹绑定 manifest.prompt。generate-video 把最终原文存入 tasks.json,保留 submission 快照;gate/reserve 比较最终 manifest 的 prompt/duration/references,不比较源拼接文字,不增加 kind/gate/最终提示文件/账本或迁移。 ## Native User Decision 摄影保留源节拍与时序;职责见 [参考用途与精细度](${CLAUDE_PLUGIN_ROOT}/skills/_meta/rules/visual-prompt-craft-common.md#参考用途与精细度)。两项责任独立:Creator 最终 prompt 无论参考有无肢翼、是否演细节,始终按官方表达要求依源完整写相关动作序列及必要主体/部位归属、准备/执行/收尾、接触变化、先后/重叠,不编动作或设每帧配额。SVD 粗模只做整体移动/站位、camera/取景/运镜、转场、light、空间/reveals 和 clock,不制作手臂、手掌、翅膀或精细机构动作;机构简化属 SVD 边界。已有粗动画优先省去信号后复用,无肢只省本地表现、不省文字。建议 7 对带肢翼另强调模仿风险,不是完整性的条件。Reviewer 核对所有最终序列,另查粗模信号及具体矛盾,缺手不补手或判悬浮/unknown,不穷举潜在行为。细模/静态 shape/identity 与独立 action reference 按 purpose 保留,也不免源语义完整,不重生身份图或默认细 rig;权限、独立审核及 stable inputs 保留。 素材时窗与用途按 [参考区间与采用维度](${CLAUDE_PLUGIN_ROOT}/skills/_meta/rules/visual-prompt-craft-common.md#参考区间与采用维度) 同步到 use/最终 prompt,保留全局映射。正文每次显式引用视频须就地写具体源视频区间与采用维度,并明确输出任务时间段;两钟可相同,同钟全组完整声明或任务段标记不能替代局部源区间,不以“此段/对应片段”省略。不要求每句引用或每代词加 token,静态图无播放时钟。Reviewer 核对正文每个视频绑定处,遗漏交 Creator 语义修订已有 prompt 并同步 use,不按 token 数/正则验收,不由提交时 converter 补字,不新 parser/gate。保留完整源动作、情绪意图、代理归属与 source clock,自然表演按源意图独立表达,局部动作不扩成全片循环。上传清除内部轨迹线、坐标、camera cone 和调试标签,保留正式 film text;抽象分工可说明省略,不能反转矛盾媒体事实。转场过程见 [转场过程表达](${CLAUDE_PLUGIN_ROOT}/skills/_meta/rules/transition-craft.md#转场过程表达),沿源切点与预算,不加示例秒数或 extend。 独立生成 TASK 边界默认强烈优先采用有剪辑动机、明显不同的机位/视点/景别,以降低近似构图独立生成差异的显眼程度。每个相邻接点按源意图判断:同一连续事件保持必要动作进度、持有/接触、空间与声音的相容延续;场/幕或时空跳转判断因果、情绪、信息、主题反差或平行关系与观众定位,不套同一事件标准,不强制同位置、续动作、连续声音或过桥场。源支持的悬念、突兀感与硬切不必顺滑或立即解释;同集底层身份与世界事实一致,有意变化须有源依据。沿已有动机切点装组,相似镜头可同组;实际需要的匹配/重复构图保留,关键接触或必须无缝续声可行时同组,在现有交接说明取舍,不新增许可。此偏好不是每镜变化、每切一任务或角度配额,不保证连续性或豁免违背源意图的错接。TASK 不等于场景或幕,约束内可含多镜/多场,不强制幕结构、停步、终姿、停顿、下组重启或叠化;运动中硬切有效,不要求相同帧。参考与最终 prompt 保留对应接点意图及必要局部事实。保留源时长、连续成员、模型最大值及 grants;源重设计由 Director/owner 在原始预算内同步。 主 AI 完整展示原角色的当前一题正文及全部解释,再用当前模式可用的 `request_user_input` 键盘选择器。questions 恰好一项;id 稳定、header 不超过 12 字符,options 通常 2-3 项,以实际 schema 为准。示例只说明映射,不提供剧情: ```json {"questions":[{"id":"plot_choice","header":"Plot","question":"Which candidate should we use?","options":[{"label":"A","description":"Candidate A, explained above"},{"label":"B","description":"Candidate B, explained above"},{"label":"C","description":"Candidate C, explained above"}]}]} ``` 问题、标签和全部选项由原角色撰写;全文与控件标签一一对应且不重编号。长解释在控件前,不能为长度删内容。三候选加委托超出三按钮限制时,三候选全保留,明确说明可在原生 Other/自由输入中答“Director 决定”(若支持)。不得删候选换委托或偷偷分页。不能表达全部选择或工具/当前模式不可用时,说明限制并保留全部当前选项,单题文本回退;不切换模式,不改权限/框架。可用且适配的控件不能被 Markdown 代替。 原角色一次给齐全部可预见相关问题/表、明确题界及条件分支。主 AI 读全并内部保留计划,只沿作者题界逐题展示当前完整内容,不有损改写或提前倾倒全表;等答复再问下一适用题,不并行提问。相关原始答复及全部条件批量回原角色原上下文,不逐题往返;仅缺内容/映射、不相容或计划外新决定才提前回询。剧情未指定且基本意图充分时默认三个展开故事,明确数量、已有剧本/方向/委托优先。 技术计划按 scope 给齐未决 provider -> model -> 相容 ratio -> resolution 及明确兼容选择/分支。主 AI 只应用作者条件,不推断 provider 知识;若委托模型须专家解析且无后续分支,先回原角色解析再问依赖项。按实际 scope 跳过已答/固定/继承/已委托字段,不以跨模型列表暗示任意组合可用。 ## Task 调用协议 ```json { "task": { "with_subagent": "dispatch_apply_role_outcome_wait", "role_source": "agents/<role>.md", "payload": ["role", "outcome", "references", "scope", "constraints"], "nesting_unavailable": "main_director_relay_resume_requester", "review_context": "fresh_without_producer_history", "relay_unavailable": "blocked_no_self_review" } } ``` - 用户决策须读取并遵循 `${CLAUDE_PLUGIN_ROOT}/skills/_meta/rules/user-decision-relay.md`。原角色一次给齐相关问题计划及每题背景、全部选项/解释和取舍;费用不自动设字段。主 AI 先读全,按 Native User Decision 沿作者题界完整呈现当前题,不只给链接或摘要;补充解释单独标明,缺失/截断请作者补齐。原始答复及全部条件按题对应批量送回原角色原上下文,Director 与各层 relay 不压缩;无人值守仅报告需决策并保留完整计划供后续逐题交互,不擅自提问或代选。 - 派发(含嵌套/relay)沿现有自然语言 handoff:Director 集中核对 active 依赖,明确有界可读依赖及 stable/等待对象和就绪条件、精确允许写入路径/targets、child 委托许可与升级条件。子任务不继承 Director 全局上下文或账本;专家管理本地顺序,向 child 完整转交相关精确 scope、依赖及当前状态,不带全历史。调用方无法建立边界时,只读定位并报告缺口,不假定全局稳定或开始依赖它的制作。未知/新增依赖、共享写冲突、新写入或扩 scope、升级条件先沿 handoff 回 Director 再派发/执行;依赖变化由 Director 集中重排并转交新边界/状态,不自动取消任务。 - 同文件编辑(含不同章节)串行;写入改变 active reader 依赖的内容/语义或使证据失效时,等实际读取工作完成,无实际依赖冲突的读写可并行。整文件指纹证据仍需文件稳定,相关输入有 writer 时等稳定交回再审核。Director 保留整棵受托子树读写占用,直至父任务及真实后代工作全部完成,期间不自行写入或派冲突 writer;异步 running、父任务有限返回或错误不释放未完成工作。实际 child 句柄、精确 scope、依赖及运行/实际完成/阻塞状态沿 handoff 回传;已允许、稳定且独立的 child 无需额外逐 child 握手、重复用户许可或新 Director task。无需新增 registry/schema/调度器/锁文件或轮询;depth relay 保留相同边界/状态。 - Claude `Task` 或 `Agent` 在嵌套可用且满足上述范围/依赖时直接派发 sub-agent,应用 `${CLAUDE_PLUGIN_ROOT}/agents/<role>.md`,传递成果、参考路径、范围、约束与决策余地并等待结果。角色自行发现和加载方法,不要求命名 skill 链。 - Task/Agent 异步返回后台通知/等待指示时,先做无依赖工作,再按宿主原生等待/让出协议接收原任务结果并继续原授权委托;等待进度或子任务有限返回不是最终验收/父委托完成。不轮询代理状态、不用 sleep 等代理、不重复启动同一任务。Provider 按 recorded ID 查询/下载仍遵守原有有界轮询契约,区别于代理等待。宿主确实不能自动唤醒/续接时报告未完成范围与需外部再次触发的实际限制,不承诺自主循环、不重问继续许可,不新增 daemon/timer/账本。 - 工具可见不代表嵌套深度允许。在本会话记住已确认的能力;明确深度/嵌套拒绝或工具缺失才转 relay,普通任务失败不是嵌套失败。确认不可嵌套后不反复探测,不自动调整宿主配置/深度。 - 嵌套不可用时实际请求角色返回协议 payload,由顶层主 AI/Director 忠实派 sibling 目标角色,等待后用宿主任务/agent ID 恢复原请求上下文并返回实际结果(OpenCode 对应 task_id),不寻找或新建不存在的 Director 任务。保留会话能力结论,跨所有者建议由主 Director 协调。每次视觉操作仍新任务,不恢复 image-heavy task;后续视觉工作另建 fresh task,实际结果仍返回原请求方。 - 审核使用全新独立 reviewer task,加载 reviewer-review-*,传当前材料、要求和必要参考,不带生产者历史。每个 ep/kind/target 的 Reviewer 用 helper 写自己的 canonical 文件;相干小批纯文本可逐 target 判断、分别落盘,无读写/输入依赖冲突的就绪视觉目标默认并行。同一 ep/kind/target 重审串行是输出所有权规则,其他读写/输入依赖仍须排序,不同审核输出不证明输入安全。每轮 scope=[target]、一个完成 result、真实 inputs 和唯一 footer。Plural 协调范围、覆盖与计数,不设共享账本或必需 LLM 汇总者。局部检查 delegate 回实际观察与限制给指定独立目标 owner;每次视觉操作仍新任务、helper 缩略图及最小图集。缺失/不可解析/未完成仅影响所属目标;只写受托记录及下述指定临时文件,主 Director/生产者不自签 pass,保留 grants/state 和真实哈希。 - 用 `review-evidence.mjs path KIND EP TARGET` 返回 canonical 路径:`reviews/epNN/script.md`、`storyboard.md`;`reviews/epNN/assets/<category>/<name>.asset-prompt.md` / `.asset-visual.md`(target 仍为资产卡);`reviews/epNN/task-inputs/taskNN.md`(target 为 task manifest)。保留五种 runtime kind;可选规划仅 prose:`reviews/epNN/outline.md`、`reviews/story/arc.md`。 - 五种 runtime 审核默认用 `review-round.mjs`:指定 `/tmp/opencode/<task>` 目录先存在,在读取制作材料前以显式 `SVD_CONFIG="{config_path}"` 执行 `start KIND EP TARGET STATE [EXTRA_INPUT...]`;新语义参考首次读取前 `add-input STATE PATH...`。STATE/payload 是指定临时目录内不同的绝对路径,STATE 绑定配置和首次哈希,不在工作区复制账本。Reviewer 只写受托 canonical 记录及该目录内 state/payload/必要预览,独立撰写 `{commentary,result:{status,blockers,...}}` 后 `finish STATE PAYLOAD.json`;helper 注入 target/inputs、复核并验证记录,不手写哈希 JSON。采集/发现错误保留,漂移保留首次哈希且 finish 记 unknown;缺显式 status 的 payload 无效。exit 0 仅表示记录写入,实际 path/round/status/input_count/evidence_issues 和必要意见足以回传,正常完成不要求立即再 fingerprint、check-target/checkTarget 或全文 Read。错误/诊断按需查,下游 gates 不变。可选规划 Markdown 不使用此 helper。 - 局部视觉 delegate 所需参考由独立目标 owner 在委托读取前 start/add-input 采集,delegate 返回实际观察、所读路径、预览依据和限制;新参考先回 owner 采集再交 fresh task 读取,不以后采快照追认,不需 import registry。逐 target 并行、独立语义判断、每次全新视觉上下文及 helper 缩略图保持不变。 - shot-input 由纯文本独立 owner 总审:先 start 再读最终 prompt/timeline/manifest/必要源,按上述职责规划窗口、切点、阅读和外部配对。owner 对所有最终 prompt 核对完整源动作序列,无论参考有无肢翼或是否演细节;helper 另查粗模信号、模仿风险与具体矛盾,独立 action reference 另查所选动作证据。owner 不加载图片/帧/contact sheet/附件;查看交 fresh Reviewer 最小 helper 缩略图集。单资产叶子仍可有限查看写自身记录。唯一 ep/kind/target 由 owner start/finish;helper 不写同目标记录、不开轮次、不改 STATE,只写指定临时预览/文本反馈。 - owner 在 helper 读取前采集实际 inputs,新依赖先回未读路径,经 Director 协调和 owner add-input 再交 fresh task。helper 只回文本事实、时间/帧、原路径/指纹、采样与预览映射及限制,区分所见与源码推断,不给 target pass、不附图。owner 独立核对全文集成、跨窗口关系和覆盖,必要缺口另派有界新任务,不机械合并局部通过;必要证据仍缺 unknown、明确冲突 needs_revision,采样不证明完整运动。嵌套可用直接委托,确认不可用则沿用限制,由 Director 派 sibling 并按真实句柄恢复原纯文本 owner 传回事实,绝不恢复视觉 helper。实际 scope/依赖/后代和子树占用保持至完成;有限委托返回不是审核或制作完成。不新增账本、schema、帧配额、gate 或完整 rig。 - 主 AI relay 也不能提供所需角色上下文或独立审核时报告阻塞,保留未决 gate;禁止同上下文角色扮演或自审兜底,不把已有文件或任务成功当作审核通过。 - checker 的新提交/重试同样委托真实 Creator;depth1 时返回请求给主 AI 派 sibling Creator,再用原任务 ID 恢复同一个 checker。仅取回由 checker 按 recorded provider 执行,不因当前配置改变而重选。Skill 加载不替代角色任务。 ## 定时任务和自动化 - Claude `CronCreate`、`CronList` 和 `CronDelete` 不是 Codex 中的字面工具名。 - 用户明确请求持续监控时,AI 加载内部 auto-video 知识,优先使用实际可用的 Codex automation 能力。 - 日常使用以单次自然语言提交、查询和下载为主,持续监控由明确请求触发。无 automation 时说明限制,获准后可外部周期性委托内部 check-video 知识,传明确 target 和 unattended 意图,不要求用户 flags。 - 首次与周期 checker payload 均显式传 canonical config_path 或 UNRESOLVED,并沿 Creator relay 保留。UNRESOLVED 只允许取回并报告 human_needed,空值是传输错误,不选择默认;配置操作显式验证绑定路径并共用 SVD_CONFIG。只按有效末行 JSON 且 target 匹配决定停止,缺失/无效/跨目标结果不从 prose 推断。 - 不得绕过 check-video 和 Creator/provider 的 grants、inflight、当前审核与恢复边界。 ## 模型提示 - Claude `model: opus` 和 `model: sonnet` 在 Codex 中仅作为提示信息。 - 在 Codex 中,除非用户明确要求切换模型,否则使用当前活动模型。 ## 工具白名单 - 源 skill 中的 Claude `allowed-tools` 元数据在 Codex 中仅作为提示信息。 - 如果某个 Claude 工具名在 Codex 中不可用,不要仅因为工具名不同而失败,应按本映射执行。 - `Task`/`Agent` 以“Task 调用协议”为准;明确要求隔离的任务不得使用当前会话 fallback。 ## Plugin-rooted Path 解析 源 skill 使用 `${CLAUDE_PLUGIN_ROOT}/...` 引用 plugin 内文件(meta rules / 跨 skill rules / scripts)。Codex 已**原生**为 plugin 进程设置 `CLAUDE_PLUGIN_ROOT` 环境变量(与 Claude Code 兼容;详见 OpenAI Codex plugins 文档)。 **bash 工具调用**:`${CLAUDE_PLUGIN_ROOT}` 由 bash 直接展开。例: ```bash bash ${CLAUDE_PLUGIN_ROOT}/scripts/read-config.sh "总集数" ``` **Read 工具调用 plugin 内文件**:Codex 不在 skill content 做 inline 替换。LLM 需先取得 literal 路径再用 Read: 1. 跑 bash `echo $CLAUDE_PLUGIN_ROOT` 取得绝对路径 2. 拼接构造完整路径 3. 用 Read 工具读取该绝对路径 或更简:用 bash `cat ${CLAUDE_PLUGIN_ROOT}/path/to/file` 一次性读取并加入上下文。 ## 执行源 Skill 1. 读取 `${CLAUDE_PLUGIN_ROOT}/skills/check-video/SKILL.md`;入口保留用户原始自然语言请求,内部 skill 使用当前委托,不构造位置参数。 2. 将 `${CLAUDE_PLUGIN_ROOT}/skills/check-video/` 视为源 skill 目录。当源 skill 引用 `rules.md`、`config-template.md` 或 provider 同级指南时,相对该目录解析。 3. plugin directory 是 `${CLAUDE_PLUGIN_ROOT}`;plugin 内 scripts/agents/skills 相对它解析。项目的 story/assets/config.md 仍相对当前工作区根目录。 4. 执行本适配层时,不要复制或修改源 skill 说明。
عرض على GitHub