← 返回 Skills 市场
qriiz112

ACP Orchestrator

作者 qriiz112 · GitHub ↗ · v4.0.1
cross-platform ⚠ suspicious
713
总下载
0
收藏
4
当前安装
7
版本数
在 OpenClaw 中安装
/install acpx-orchestrator
功能描述
Enhanced terminal AI agent orchestrator with parallel execution, health checks, and workflow presets.
使用说明 (SKILL.md)

acpx v4.0 - Agent Orchestrator

Enhanced CLI wrapper di atas acpx dengan fitur orchestration: parallel, health check, workflows.

Quick Start

# Discover agents
acpx discover

# Health check
acpx health

# Run single agent
acpx run opencode "Fix bug"

# Run workflow
acpx workflow review

Commands

Command Description Example
discover List installed agents acpx discover
health Test all agents acpx health
run Run single agent acpx run opencode "task"
parallel Run agents parallel from file acpx parallel tasks.txt
batch Run agents sequential from file acpx batch tasks.txt
watch Watch agent status acpx watch opencode
kill Kill agent sessions acpx kill opencode
workflow Run preset workflow acpx workflow review
json Run with JSON output acpx json opencode "task" | jq
exec Direct acpx passthrough acpx exec opencode "task"

Workflows

Workflow Description
review Code review dengan JSON output
refactor Safe refactoring dengan diff
test Generate pytest tests
debug Deep investigation (600s timeout)

Batch File Format

# tasks.txt
opencode exec 'Fix auth.py'
pi exec 'Create tests'
kimi --print --yolo --prompt 'Review changes'
acpx parallel tasks.txt  # Run parallel
acpx batch tasks.txt     # Run sequential

Spawn via OpenClaw

// Health check
sessions_spawn(
  task="acpx health",
  label="health-check",
  runtime="subagent",
  mode="run"
)

// Run workflow
sessions_spawn(
  task="acpx workflow review",
  label="review",
  runtime="subagent",
  mode="run"
)

// Parallel tasks
sessions_spawn(
  task="acpx parallel tasks.txt",
  label="parallel-jobs",
  runtime="subagent",
  mode="run"
)

// JSON output
sessions_spawn(
  task="acpx json opencode 'List functions'",
  label="json-task",
  runtime="subagent",
  mode="run"
)

Helper Scripts

  • acpx - Main orchestrator CLI
  • acpx-batch - Legacy sequential runner
  • acpx-workflow - Legacy workflow presets
  • acpx-discover - Legacy discovery

Changelog

  • v4.0.0 - Enhanced orchestrator: parallel, health check, workflows, json output
  • v3.1.0 - Simple CLI wrapper
  • v3.0.0 - Generic auto-discovery
  • v2.0.0 - Async multi-agent patterns
  • v1.0.0 - Initial wrapper
安全使用建议
This skill is an orchestration wrapper and mostly consistent with that purpose, but there are several things to check before installing: - Confirm the source: manifest.json references a GitHub repo (https://github.com/qriiz112/acpx-orchestrator) while the registry says 'Source: unknown' and 'Homepage: none' — verify the repository and author before trusting binaries. - Verify the acpx binary/npm package: SKILL.md and manifest expect an 'acpx' CLI (and manifest suggests npm packages). If you plan to install those packages, inspect the npm package and GitHub repo for malicious code or unexpected install scripts. - Be cautious with optional agents: the manifest lists optional external agents (Anthropic/pi, etc.). Those agents may require service credentials or send data externally. Do not provide secrets to those agents unless you trust them. - Understand runtime behavior: the skill's examples use sessions_spawn to run subagents. Allowing the agent to spawn subagents means it can execute multiple agent processes and pass arbitrary tasks; limit what you let it run and review tasks it will forward. - Metadata mismatches: the registry's top-level metadata (no required binaries/homepage) conflicts with files inside the package that declare requirements. Ask the publisher to clarify/correct metadata before installation. If you cannot verify the package source or are uncomfortable with an orchestrator that spawns other agents, avoid installing or run it in an isolated environment (container/VM) and inspect any installed npm packages and their install scripts first.
功能分析
Package: acpx (xpi) Version: 4.0.0 Description: Enhanced terminal AI agent orchestrator with parallel execution, health checks, and workflow presets The provided files consist of metadata (manifest.json, _meta.json) and documentation (README.md, SKILL.md, COMPARISON.md) for a tool named 'acpx', described as an AI agent orchestrator. The package defines a set of CLI commands for managing and running various AI agents like 'opencode' and 'pi'. No executable source code (Python, JavaScript, or shell scripts) is present in the provided files. The configuration and documentation describe standard orchestration logic, such as health checks, parallel execution, and workflow presets, with no evidence of malicious behavior, secret exfiltration, or unauthorized execution.
能力评估
Purpose & Capability
The declared purpose (CLI orchestrator for agents) matches the instructions and manifest: the SKILL.md and manifest.json reference an 'acpx' CLI plus optional agent packages (opencode, @anthropic-ai/pi, kimi, etc.), which is coherent for an orchestrator. However, the registry summary above this bundle claims 'Required binaries: none' and 'Homepage: none' while manifest.json and SKILL.md explicitly list 'acpx' as a required binary and include a GitHub homepage/repository. This metadata mismatch is unexpected and should be confirmed.
Instruction Scope
SKILL.md contains only CLI usage for the acpx tool and examples of sessions_spawn(...) calls to spawn subagents (runtime='subagent', mode='run'). There are no instructions to read arbitrary files or environment variables in the included docs. Spawning subagents and passing tasks/flags is exactly the orchestrator's role, but it does mean the skill will cause execution of other agents/commands whose behavior depends on those agents — potential data forwarding or remote API interaction is possible via those agents.
Install Mechanism
The package is instruction-only (no code files) so the platform will not run installs automatically. However, manifest.json includes an 'install' section referencing npm packages ("acpx" and optional agent packages). This is not enforced by the registry metadata but indicates the author expects an npm-based install. Because there is no direct install spec executed by the platform, immediate install risk is low — nonetheless, if you follow the manifest's suggested npm installs, verify the packages and sources before running.
Credentials
The skill does not request environment variables or credentials in the registry metadata or SKILL.md. That is proportionate for a CLI orchestrator. However the manifest references optional external agent packages (e.g., '@anthropic-ai/pi') that in real use may require service credentials; the SKILL.md's sessions_spawn will pass tasks to subagents and could cause those agents to interact with external APIs. Make sure you do not inadvertently supply credentials to optional agents or allow the orchestrator to forward secrets.
Persistence & Privilege
always:false (no forced always-on) and default model invocation is allowed. The skill instructs spawning subagents (sessions_spawn), which is expected for an orchestrator but expands runtime activity. This is consistent with the stated purpose and does not itself request persistent system-wide privileges or modify other skills.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install acpx-orchestrator
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /acpx-orchestrator 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v4.0.6
Fixed: CLI agents support (kilo, kimi), added warnings section to SKILL.md, added binaries.warnings to manifest, security notes documented
v4.0.5
Fixed ClawHub metadata: binaries field, install.command, synced manifest.json and SKILL.md frontmatter
v4.0.4
Fixed: Proper install spec declaration, homepage metadata, batch/parallel working directory support, opencode/pi command fix
v4.0.3
Fixed: Added race condition warning to parallel command, clarified parallel vs batch usage in docs
v4.0.2
Fixed manifest structure: requires.bins, suggests.bins, proper install.npm format
v4.0.1
Fixed manifest: added requirements.bins, optional binaries, npm install, and proper metadata
v4.0.0
Enhanced agent orchestrator with parallel execution, health checks, workflows, and JSON output mode. Supports opencode, pi, kimi, kilo, codex, claude.
元数据
Slug acpx-orchestrator
版本 4.0.1
许可证
累计安装 4
当前安装数 4
历史版本数 7
常见问题

ACP Orchestrator 是什么?

Enhanced terminal AI agent orchestrator with parallel execution, health checks, and workflow presets. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 713 次。

如何安装 ACP Orchestrator?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install acpx-orchestrator」即可一键安装,无需额外配置。

ACP Orchestrator 是免费的吗?

是的,ACP Orchestrator 完全免费(开源免费),可自由下载、安装和使用。

ACP Orchestrator 支持哪些平台?

ACP Orchestrator 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 ACP Orchestrator?

由 qriiz112(@qriiz112)开发并维护,当前版本 v4.0.1。

💬 留言讨论