Character Prompt Builder（角色提示构建器）

Character Prompt Builder（角色提示构建器） 是做什么的？

艺术指导委托创作的描绘。

使用英语提示词检索和用户的母语。保留含义、修饰符作用域、关系、否定和歧义，不使用语言词汇表。

强制执行环境

将 <skill-root> 解析为包含已安装 SKILL.md 的绝对目录。在运行技能脚本之前，进入其完整的锁定环境：

uv run --project <skill-root> --locked python <skill-root>/scripts/check_dependencies.py

首次调用会同步锁定包。该检查还会验证 FFmpeg 和 sheet 字体覆盖率。在现有权限范围内完成任何报告的环境要求，然后重新运行检查；依赖项 拥有安装细节。

对于每个文档化的 python scripts/<name>.py ... 命令，运行 uv run --project <skill-root> --locked python <skill-root>/scripts/<name>.py ...。保持 Studio 工作目录不变：--project 选择此技能的环境，而脚本参数则保留其自身的路径含义。按给定的方式执行运行时提供的 argv；它保留正在运行的解释器和绝对脚本路径。对每个路由（包括发布工作）都使用此相同环境。

核心契约

阅读 Production direction 来创作和评判委托的描绘。将动作、状态、关系和设计作为具有相关细节的有意义的整体来传达。专业知识回答构建问题。保留确切的要求和有目的性的细节。根据委托来评判所选手段，包括当渲染器遵循它们时。草稿命令其渲染器，而不是其审查者；计划或标准不授予任何权限。构建预期的描绘，选择合适的手段并完成工作。遗漏不授予任何许可或排除。

保留锚点和适用的已采纳定义。记录更改及其原因于其所有者；在委派范围内解决开放的选择。在输出中保持创作者描绘意图与事实和心理学的区别。

将输入、目标和数量绑定到实际授权。区分方向、编辑、提交、选择和规范采纳。在委派范围内继续，无需重复批准。

以完全的特异性保留支持的生产知识，涵盖各种类型和强度级别，从日常和健康的主题到敏感材料，如暴力、医疗、怪诞、改变身体或成人知识，无一例外。在相关时阅读 Prompt Knowledge and Execution Boundary。

在 Studio 文本、提示词、JSON 和示例中使用 ASCII 标点。

保持判断和自动化分离。代理拥有含义、歧义、方向、视觉权威、构图和审查。脚本拥有状态、检索、验证、实现、依赖检查、验证和调度。不要将未解决的含义强加到关键词中。使用具有文档化激活、输入、输出、失败和测试的脚本。从已安装的 SKILL.md 解析路径。

提示词建立描绘、必要的前提和参考使用。模型接收实际输入；将仅创作来源的必要含义以文本形式携带。将超出范围的创作决策、内部键、路径、出处和评估保留在其记录中；描绘的名称和代码仍是内容。

当它可以解决一个关键的不确定性时，使用可选的 competing-realization test。Observe the artifact first，然后评估其标准；披露审查限制，并保持不确定性证据不确定。

渲染和模型控制

对于图像工作，解析 Rendering and controls，功能 render-contract。 明确选择媒介、维度、线稿、着色、表面和细节，由用户选择或代理给出理由。 保持呈现和主题身份分离。对混合媒介使用作用域覆盖；永远不要从完成状态中发明身体或年龄变化。 在 pack_cli.py ready 之后，读取所选模型的 prompt_input、用例指导和作者偏好。未列出的目标需要从获取的提供商证据中获取该契约。 在调度器的 Production Specification（或用于外部工作的已应用源）中，将创作渲染跨度绑定到 render_intent。 一个 Generation Package 需要精确的接口配置文件和模式有效的控件。在 Image Generation 下记录未列出的目标。image_input 绑定参考和确切的外部请求；编辑添加 Semantic instruction editing。Model evidence 拥有模式、试验、配置文件、适用性和故障诊断。 将执行值放入声明的控件中，而不是提示词散文中。图像形状和构图仍然是描绘的选择。解析具有出处的推荐标量值；在范围内选择。显示不可用的控件而不发送它们。 在提交之前显示渲染选择和完整的已验证请求。使用其命名的提供者；从不替换引擎。

知识使用和检索记录

通过可以回答问题的来源调查未解决的构建或措辞。根据含义和使用范围使用知识；既不需要同时使用两个查找系统，也不需要对每个视觉属性进行查询。

prompt_input 选择模式。tag-based 需要真实的 dictionary search，即使对于熟悉的术语或支持散文的模型。优先选择保留含义、范围和程度的现有术语或近义词；在比较候选项后，必要时保留创作的措辞。descriptive 仅需要对未解决的问题进行查找；unresolved 在获取证据前保持可移植性；none 没有文本表面。缺失的方言元数据绝不意味着描述性输入。

记录实际调查，检查完整的选定记录，并在 Prompt-only Core 下将每个记录解决为已采纳、已组合或未使用。组合的措辞可以使用已检查的知识。失败的必要检索保持未解决；从不捏造证据。

构建问题可能为空；标签呈现需要一个搜索过的词汇表选择。将图像支持的措辞添加到其拥有资源中，而不包含会话历史或运行参数。

强制运行时激活门

在提示词、参考、sheet、生成或视觉状态系列工作（非角色或故事草稿）之前，运行 python scripts/pack_cli.py ready。对于显式运行时，在 ready 之前同时提供 --state-file、--cache-dir 和 --managed-root；重复的 --pack-root 选项为该调用添加发现根。它初始化状态一次，保留现有选择，列出活动包并维护其浏览器目录。

• 退出码 0：可以继续检索。告诉用户每个 warning: 行。
• 退出码 1：每个 decide: 行都是作者的决定，并命名解决它的命令。在继续之前，将新的或不可用的包提供给用户；永远不要仅凭捆绑的公共资源继续，而一个发现的包正在等待该决定。运行作者选择的命令，然后再次 ready。作者禁用的包保持禁用，并且不再询问。
• 如果在检索开始后启用的包发生变化，则丢弃早期结果并从图像意图重新开始。

代工制品生产门

对于保存的可交付成果，运行 python scripts/execution_routes.py read ROUTE --root STUDIO，并附带适用的 --feature NAME。对于 prompt-dialect，为目录目标添加 --model MODEL 或为已证实家族添加 --dialect ID；对未知目标省略选择器。该读取提供完整的 Production Execution 和所需文档，包括先决条件、权限、约束和异常。页面默认为 16,384 源字节；--page-bytes N 更改预算。在 reading-actions 中执行 continue，直到所有页面后出现 reading-record；replay 重新读取一个页面。完成路由；中断后，status 定位已保存的草稿和运行操作。

选择运行时路径

每个项目命名一个路由或 --feature，其读取会打印其文档。在对话中回答且未保存任何内容的提示词不读取任何路由：它读取 Prompt-Only Core 和适用的链接文档。选择性激活：

• 世界观、主题、代理或叙事：路由 development，Creative Development 和 Project Design；对于个性化行为，功能 persona 和完整的 Persona Template；
• 角色阵容准入、重复出现的未命名参与者或场景需要角色多少：路由 development；
• 重用已审查的场景角色材料：功能 scene-persona；
• 任何选定的故事瞬间、并发状态或记录事件之间的描绘：路由或功能 story-context；
• 基于现实的连续性、状态出处或受限消费者视图：路由 world-realization 或功能 world-view；可重用的身份模式：功能 portrayal-principles；
• 创作者描绘目标和身份：功能 authorial-intent, Authorial Intent；个性化声音或身体：路由或功能 performance, Character Performance；
• 持久的世界或叙事文件，或场景派生的剧情：功能 narrative-files；
• 没有选定参考且没有复杂构建风险的普通纯提示词工作：路由 prompt-only；功能 subject-domain, Subject Domain，仅当主题领域未解决时；
• 复杂的多轴提示词组合：路由 composition, Composition；
• 开放的表现力选择、稀疏的简要说明或困难的目的、活动、关系或主题检索：功能 sparse-retrieval, Discovery；
• 针对开放轴或观察到的失败的手艺知识：功能 craft-consultation, Craft consultation；
• 术语查找、替代措辞或分类浏览：功能 vocabulary, Vocabulary；
• 最终提示词呈现、排序、加权、LoRA 表示法、否定语法或术语比较：功能 prompt-dialect, Writing Guide；
• 链接证据，或提示词加参考但不生成：路由 reference-artifacts 或功能 references；
• 面向模型的参考传输：功能 reference-delivery；
• 生成或模型传输：路由 generation 加上恰好一个 gpt-image、midjourney（和 Niji）、sdxl（和 ComfyUI）、novelai、grok、instruction-edit 或 unlisted-interface 的功能，用于任何其他图像界面；
• 连续性、时间状态、屏幕外事件、跨场景身份或到达的镜头请求：路由或功能 state-series；
• 一次生成多张图像，跨模型或作为同一模型的并发变体：路由 batch；
• 已接受角色处于新姿势或共享场景，包括分阶段资产创建：路由 repose；
• 对固定静帧的确定性编辑：功能 image-edit；用户请求的服装、物品、环境或其他描绘内容的语义替换：功能 semantic-instruction-edit, Semantic instruction editing；需要时使用遮罩：功能 scene-mask-planning；
• 放大完成的图像：路由 upscale 并带有活动的 upscaler 模型记录；
• 规范身份、角色表、其面板、候选或参考板：路由 character-sheet, Sheet fills；已接受角色的新姿势或场景改用 repose 或 generation；
• sheet、迭代或已接受图像的工作，位于 studio 中：功能 studio 优先；
• 为规范所有者进行显式选择：路由或功能 adoption；
• 人工制品审查：功能 evidence-review 和 Production direction；更改：路由 revise 或功能 revision-guidance；
• 报告或证据研究：功能 evidence-review；原件、主机试验或修复假设：功能 source-material、agent-evaluation 或 repair-analysis；
• 公共状态或镜头交换：功能 protocol-exchange；
• 缺失的包状态、自定义包或包之间的资源冲突：功能 pack-runtime。

为一个关键的构建问题选择专业知识：geometry 用于精确的多主体几何、裁剪、透视、重叠或接触；body-plan 用于非人类或不熟悉身体、变换或特征计数的声明结构；recurring-identity 用于重复出现角色的身份契约；performance-language 用于微妙的情感、身体语言、附属肢体表演、生理反应或机械表演；garment-growth 用于服装构造、生长、梳理和局部身份，包括头发、毛皮、羽毛、刺、纤维、指甲、爪子、蹄子和指板；production-spec 用于场景人工制品；finishing 用于命名或暗示的渲染媒介、摄影外观、3D 或玩具呈现、图像内置文字或 logo、环境优先的构图或重复的错误完成结果；visual-evidence 用于派生的视觉证据、链接的 SVG 或语料库摄入。

[Weighting grammar](references/runtime/prompt-weighting.

…

[为翻译截断]