用途
dcode-runner 用于执行外部 DeepAgents CLI(dcode)提示,使用用户已在 dcode 中配置好的模型和凭据。它只应在明确请求 dcode 或 DeepAgents CLI 时使用。该技能通过本地 CLI 执行调用方给定的限定提示(scoped prompt)。
主要能力
- 通过本地 CLI 执行限定提示,并返回包装信封(wrapper envelope)与
agent_message。 - 原生路由判断:在决定外部路由前,先阅读
shared/references/host-model-execution.md。如果当前宿主能以所需的努力、隔离和回执策略,在原生子代理或任务线程中派发所选精确模型,则使用该原生路由。agents/openai.yaml是宿主 UI 元数据,它不派发原生模型。 - 席位保真(seat fidelity):必须指明实际应答的提供方,并诚实报告不可用或未经验证的席位。
- 共享角色、信封键和结果处理位于
shared/references/runner-common.md。
使用方式
在同一 shell 调用中,将 SKILL_DIR 设为该已加载技能目录:
SKILL_DIR="<absolute path of this skill directory>";
python3 "$SKILL_DIR/scripts/run_dcode.py" "<scoped prompt>" --json
已批准的工作流会提供确切的模型、努力、角色、工具模式和回执策略。传入这些已批准的选项以及 --disable-fallback;上述基本示例不授权使用其他路由。
按需加载:
references/command-reference.md:在组合非基本调用时,查看标志、示例、原生映射和返回码。references/runtime-reference.md:在配置路由或解释其结果时,查看认证、回退条件、配置和扩展信封字段。references/continuation.md:仅在恢复会话或管理后台作业时使用。
适用场景
仅用于明确请求的手动 dcode 运行。该包装器无法绑定精确模型,也不能作为已批准的实现或审查路由。
限制
- 用户现有的模型和凭据保留在 dcode 中配置。
--model是元数据标签,不会被转发。 - 除非经授权的调用传入
--auto-approve,否则权限检查保持启用。提示和文件上下文可能会被发送到所配置的提供方。 - 分析角色使用只读提示覆盖,而非强制沙箱。对不可信输入应隔离工作区;不要将
--restrict-tools视为安全边界。 - 当 CLI 缺失时,直接调用有一条带标签的回退链。不要将回退答案归因于 dcode。当调用方要求该席位时,使用
--disable-fallback。 - 原生输出没有会话 ID。恢复最新会话使用共享状态,且不得针对同一 home 并发运行。
结果检查
阅读 agent_message 和包装信封。检查成功状态、服务模型回执、有效运行器/提供方,以及任何回退或格式异常状态。仅进程完成并不能证明使用了所请求的任务或模型。当调用方授权编辑时,报告被触及的文件。