从 JSON 配置构建 sessions_spawn 命令负载。适用于需要可复用的子代理配置(模型/思考/超时/清理/agentId/标签)等场景。
子代理发光命令- 构建器是一项面向实际任务的技能,主要用于Generate sessions spound 有效载荷 JSON from profile config. 此技能不会执行会话 spound;它只构建有效载荷/ 命令 JSON..;
使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
根据配置文件(profile config)生成 sessions_spawn 请求体(payload)JSON。
该技能**不执行** sessions_spawn,仅负责构建请求体/命令 JSON。
scripts/build_spawn_payload.mjsstate/build-log.jsonltask(必需)label(可选)agentId(可选)model(可选)thinking(可选)runTimeoutSeconds(可选)cleanup(可选,取值:keep 或 delete)cwd(可选)——子代理的工作目录mode(可选,取值:run 或 session)请参阅 TOOLS.md 中的“Subagent Spawn Profiles”表格,了解各 profile 的默认值。所有参数均需通过显式 CLI 参数传入(例如:--model、--thinking、--run-timeout-seconds、--cleanup)。
--profile 标志现仅用作日志标签(logging label),**不再作为配置文件查找键(lookup key)**。
skills/subagent-spawn-command-builder/scripts/build_spawn_payload.mjs --profile heartbeat --task "Analyze recent context and return a compact summary" --label heartbeat-test --model claude-sonnet-4-20250514 --thinking low --run-timeout-seconds 300 --cleanup delete
脚本将直接输出符合 sessions_spawn 接口要求的 JSON。
所有参数值均来自显式的 CLI 参数。--profile 仅为日志用途(非配置查找依据)。有关各 profile 的推荐默认值,请参考 TOOLS.md 中的“Subagent Spawn Profiles”表格。
task 字段始终来源于 CLI 参数 --task。
注意:该构建器基于 Node.js(.mjs 文件)。若生成的任务中包含 Python 执行步骤,请使用 python3(而非 python)编写命令。
--profile(必需)--task(必需)--label--agent-id--model--thinking--run-timeout-seconds--cleanup keep|delete--cwd --mode run|session