阅读 {{SKILL_ROOT}}/SKILL.md 以获取生产工作流及其人为决策。
使用 python "{{SKILL_ROOT}}/scripts/greybox.py" 作为通用命令前缀。
无需 Node、MCP 或模型切换。此包装器是可选的：WorkBuddy 也可以读取完整的技能并直接执行其 CLI。使用 setup 返回的命令前缀；它记录了实际的 Python 和已验证的包标识。
对于长时间运行的美术任务，请使用 task-context pin 在现有 PLAN 中固定实际条目，并使用 task-context run 继续执行；阅读 {{SKILL_ROOT}}/references/task-context.md。在交接或模型/工具更改后重新检查。将不可用的模型/架构事实报告为未知。task-context inspect 可区分已安装的副本以及每个原始账本的旧版/执行器恢复路径；切勿为了适应新的执行器而重建已付费的任务。
-
根据意图、观察到的状态和请求的端点读取当前任务。对于结构化请求路由，请使用
intent route --file REQUEST --project PROJECT。讨论保持为讨论；灰盒请求默认路由到灰盒端点；继续执行使用原始任务记录。对于灰盒工作，运行host setup --host workbuddy --scope greybox --project PROJECT；对于美术/图像分支，运行host setup --host workbuddy --scope art --project PROJECT --capability-report REPORT --session-id SESSION。Setup 会解析实际的原生项目根目录并返回命令前缀。当有可用的证据时，绑定当前的原生 ImageGen 调用证据；则无需 API 配置文件。仅靠工具发现是不够的。图像服务和不相关的工具不是灰盒的先决条件。 对于 Blender 场景工作，当需要 CLI 准备时，使用host setup --host workbuddy --scope spatial --engine blender --operation create|edit|review --project SOURCE_OR_WORKSPACE；可用的原生 bpy/CLI/MCP 操作随后可以遵循空间路由。Setup 仅用于就绪性检查；应用程序发现不检查场景。纯空间端点不需要游戏项目或供应商。 -
对于 Godot/Unity 灰盒创建/修订，请阅读
{{SKILL_ROOT}}/references/greybox-authoring.md并使用greybox init/build/play/validate/status/handoff；在请求的端点停止。对于美术分支，如果缺少生成功能，请阅读{{SKILL_ROOT}}/references/image-services.md并使用image configure配置用户选择的图像服务。使用host configure --host workbuddy --image-profile NAME绑定其非秘密名称。 -
对于新的 S7 建模参考，请阅读
{{SKILL_ROOT}}/references/modeling-references.md，记录每个资源及其视图一次，然后输入boards workbuddy start --file REGISTRY --project PROJECT --workspace WORKSPACE。这会编译页面任务并注册/安装它们限定了范围的 S7 守卫。运行其确切的无害原生 Bash 探测，然后使用当前的原生工具架构运行boards workbuddy bind。消费返回的任务；boards workbuddy claim写入确切的调用就绪参数并保留现有的支出上限。计划的单次任务遵循相同路径，并需要其计算出的或来源化的原因。记录原始结果，然后通过boards production进行裁剪/审查；坏的槽位不会擦除好的兄弟位，修正后的 ROI 会创建裁剪尝试而无需重新生成。新的聊天会话会续订免费探测并保留原始待处理的调用。对于选择的图像配置文件，通过现有配置的服务账本消费确切准备好的页面请求。不要降低质量要求或再次提交不确定的调用。 -
当活动分支生成图像时，通过当前主机的像素读取工具打开实际返回的本地图像。使用主机支持的图像 UI 呈现该文件。CLI 成功并不能建立任一能力。在会话能力报告中绑定确切当前的工具和证据。灰盒审查使用其原生的捕获视图，并且不需要图像生成。
-
继续当前路由和请求端点的命令。当
stop_at为greybox时，交付并在灰盒交接后停止；仅在请求时才进入美术。保留原始项目状态和批准历史。委派是可选的；图像/模型多任务并发使用{{SKILL_ROOT}}/references/execution-contract.md中描述的通用执行器。原生工具保持代理驱动，除非验证了实际的独立桥接；当模型连接停滞时，API 工作器可以继续。
在 H3 之前，通过 scene-review --help 将已批准的概念与当前的全场景代理进行比较。在 H4，新的生产合同需要当前的特性/视图比较证据。阅读 {{SKILL_ROOT}}/references/scene-comparison.md；使用观察到的差距在扩展前修复环境、主要形态、灯光和接触。有效的证据覆盖范围永远不会替代用户的视觉验收。
命令返回 JSON；失败的命令返回非零代码。对每个命令使用其 --help 以获取确切当前选项。将凭据保存在本地配置或配置的环境中，切勿保存在聊天记录、连接器文件或可移植的项目记录中。仅在选择的服务需要时才需要服务凭据；连接器初始化不会登录到提供商或创建付费任务。
仅当当前操作需要 Lux 时，运行 host setup --host workbuddy --scope runtime --runtime lux。它准备/重用固定的私有运行时，并且可以从未成功的 venv/ensurepip 探测中恢复，使用现有的兼容解释器。它不会查询供应商或提交生成。在命令之间保留其返回的 Python 路径。显式的 --python 永远不会被静默替换。