subagent-spawn-command-builder

Subagent Spawn Command Builder 是一款专为 Claude Code 环境设计的配置生成工具，旨在简化子代理（Subagent）的启动流程。该工具通过预定义的 JSON 配置文件，自动生成符合 sessions_spawn 接口标准的命令负载，让用户无需重复编写复杂的参数组合，即可快速构建标准化的子代理调用指令。

核心用法方面，用户首先需基于提供的模板创建配置文件 spawn-profiles.json，定义不同的环境画像（如开发、测试、生产环境的不同模型选择、思考模式、超时设置等）。随后通过 Node.js 脚本 build_spawn_payload.mjs 指定画像名称和任务内容，工具将依据"CLI 参数 > 配置文件值 > 默认值"的优先级规则，合并生成最终的 JSON 负载。生成的 JSON 可直接用于 sessions_spawn 调用，支持灵活覆盖模型类型、超时时间、清理策略等关键参数。

该技能的显著优点体现在其极简的依赖架构与出色的安全性上。工具仅依赖 Node.js 内置模块（fs、path、url），零外部 npm 依赖，彻底避免了供应链攻击风险。同时，它采用纯本地文件操作，无网络通信、无动态代码执行，所有输入均经过白名单验证（如 cleanup 参数严格限定为 keep 或 delete）。这种设计使得工具在离线环境下仍可稳定运行，非常适合对安全性要求严格的开发场景。

然而，该工具也存在一定局限性。首先，作为 T3 来源的个人项目，其长期维护稳定性不如企业级工具，且缺乏明确的许可证声明。其次，工具使用相对路径定位配置文件，要求必须在正确的执行目录下运行，否则可能引发文件读取错误。此外，日志文件采用追加模式长期写入，在高频使用场景下可能产生体积过大的日志文件，需要用户手动清理。

该工具特别适合需要频繁调用 Subagent 的开发者、使用 Claude Code 进行复杂任务编排的技术团队，以及希望标准化 AI 代理配置的管理员。对于需要构建自动化工作流、批量生成测试任务或管理多环境配置的用户而言，该工具能显著提升配置管理效率，减少人为参数错误。

使用风险方面，虽然工具本身不执行敏感操作，但用户需注意配置文件的安全性，避免在 spawn-profiles.json 中硬编码敏感密钥。由于工具仅生成 JSON 而不验证任务内容的合理性，错误的配置可能导致生成的 Subagent 任务无法执行或资源浪费。建议在使用前审查生成的 payload，并定期清理 state/build-log.jsonl 日志文件以防止磁盘空间占用过多。