← 返回 Skills 市场

Subagent Spawn Command Builder

Name: Subagent Spawn Command Builder
Author: nextaltair

作者 Altair · GitHub ↗ · v0.1.4 · MIT-0

cross-platform ✓ 安全检测通过

1015

总下载

当前安装

版本数

在 OpenClaw 中安装

/install subagent-spawn-command-builder

功能描述

Build sessions_spawn command payloads from JSON profiles. Use when you want reusable subagent profiles (model/thinking/timeout/cleanup/agentId/label) and com...

使用说明 (SKILL.md)

subagent-spawn-command-builder

Generate sessions_spawn payload JSON from profile config. This skill does not execute sessions_spawn; it only builds payload/command JSON.

Files

Builder script: scripts/build_spawn_payload.mjs
Builder log: state/build-log.jsonl

Supported sessions_spawn parameters

task (required)
label (optional)
agentId (optional)
model (optional)
thinking (optional)
runTimeoutSeconds (optional)
cleanup (keep|delete, optional)
cwd (optional) — working directory for the subagent
mode (run|session, optional)

Setup

Read the "Subagent Spawn Profiles" table in TOOLS.md for default values per profile. Pass values as explicit CLI arguments (--model, --thinking, --run-timeout-seconds, --cleanup). The --profile flag is now a logging label, not a lookup key for a config file.

Generate payload

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

The script prints JSON directly usable for sessions_spawn.

Merge/priority rule

All values come from explicit CLI arguments. --profile is a logging label only (not a config lookup key). Refer to the "Subagent Spawn Profiles" table in TOOLS.md for recommended defaults per profile.

task always comes from CLI --task.

CLI options

Note: this builder is Node.js (.mjs) based. If generated tasks include Python execution steps, write commands with python3 (not python).

--profile (required)
--task (required)
--label
--agent-id
--model
--thinking
--run-timeout-seconds
--cleanup keep|delete
--cwd \x3Cpath>
--mode run|session

安全使用建议

This skill appears coherent and limited in scope: it only builds JSON payloads and logs them locally. Before installing, be aware that every run will append a JSON line to state/build-log.jsonl containing the full payload (including the --task text and any other flags you pass). If your tasks contain sensitive data or secrets, avoid passing them to this builder or ensure the state log is stored securely/cleaned up. Also note the script does not execute subagents or make network calls. If you rely on default profile values referenced in TOOLS.md, verify that TOOLS.md exists in your environment and provides the values you expect.

功能分析

Type: OpenClaw Skill Name: subagent-spawn-command-builder Version: 0.1.4 The skill is a utility for generating JSON payloads for the 'sessions_spawn' command. The core logic in 'scripts/build_spawn_payload.mjs' is a straightforward CLI argument parser that outputs formatted JSON and logs the activity locally to 'state/build-log.jsonl'. No evidence of data exfiltration, remote execution, or malicious prompt injection was found.

能力评估

✓ Purpose & Capability

Name/description match the included code and SKILL.md: the script builds a sessions_spawn payload JSON from CLI args and does not attempt to execute any spawn operation or call external services.

✓ Instruction Scope

SKILL.md and the script are narrowly scoped to parsing CLI args, constructing a payload object, writing a JSON log line to state/build-log.jsonl, and printing the payload to stdout. The instructions do not read unrelated system files or environment variables, nor do they send data to external endpoints.

✓ Install Mechanism

No install spec is provided (instruction-only with a small included Node script). There are no downloads or package installs; risk from installation is minimal.

✓ Credentials

The skill requests no environment variables, credentials, or config paths. All inputs come from CLI arguments, which is proportional to its stated purpose.

ℹ Persistence & Privilege

The script creates a local state directory and appends log lines to state/build-log.jsonl containing timestamp, profile label, and the generated payload (including the full task text and any provided fields). This is expected for a builder but means user-supplied text will be persisted on disk under the skill's state directory.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install subagent-spawn-command-builder
安装完成后，直接呼叫该 Skill 的名称或使用 /subagent-spawn-command-builder 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.1.4

- Added support for new payload parameters: cwd (working directory) and mode (run|session). - Updated CLI options to accept --cwd and --mode flags. - Documentation refreshed to reflect new fields and usage.

v0.1.3

refactor: migrate user config to TOOLS.md (#3)

v0.1.2

- Switched builder script from Python to Node.js: replaced build_spawn_payload.py with build_spawn_payload.mjs - Updated documentation and usage instructions to reference the new .mjs script - Removed Python references from setup and payload generation examples - Clarified that the builder is now Node.js-based in the CLI options section

v0.1.1

- Added a note recommending the use of python3 when specifying commands in generated tasks. - No functional code changes; updated documentation only.

v0.1.0

Initial release of subagent-spawn-command-builder. - Generates sessions_spawn command payloads from JSON profile configurations. - Supports reusable profiles for parameters like model, thinking, timeout, agentId, and label. - Command-line tool merges CLI arguments, profile values, and defaults to build the final JSON. - Does not execute sessions_spawn; only constructs and outputs the payload. - Includes setup instructions, file locations, and all supported parameter options.

元数据

Slug subagent-spawn-command-builder

版本 0.1.4

许可证 MIT-0

累计安装 12

当前安装数 12

历史版本数 5

常见问题