orchestration-run-task

Files (2)

• SKILL.md
• manager-integration.md · references/

SKILL.md (first lines)

# Orchestration Run Task

## Goal

Use [scripts/orchestration/run_worker.sh](/Users/shenlan/workspaces/cloud-neutral-toolkit/github-org-cloud-neutral-toolkit/scripts/orchestration/run_worker.sh) as the single worker execution entrypoint.
Use [config/orchestration/roles.yaml](/Users/shenlan/workspaces/cloud-neutral-toolkit/github-org-cloud-neutral-toolkit/config/orchestration/roles.yaml) as the single source of truth for manager and worker roles.
Use [scripts/orchestration/run_manager.sh](/Users/shenlan/workspaces/cloud-neutral-toolkit/github-org-cloud-neutral-toolkit/scripts/orchestration/run_manager.sh) when a manager should load skills plus role metadata without hand-assembling prompts.
Use `--prompt-mode compact` as the default manager mode. Use `--prompt-mode full` only when debugging or when the compact contract is insufficient.
Use `--template review|deploy|dns-audit` to bind compact mode to a fixed output contract.

This skill is the execution layer under [../codex-multi-cli-orchestrator/SKILL.md](../codex-multi-cli-orchestrator/SKILL.md):

- `codex-multi-cli-orchestrator` decides what to delegate
- `orchestration-run-task` turns that decision into a concrete worker command

Use this skill when:

- a manager must dispatch one bounded subtask to one worker
- the worker prompt must stay short and structured
- the worker result must come back to Codex or another manager for acceptance

## Preconditions

Before using this skill, verify:

1. the worker CLI exists locally
2. the needed model credentials are available
3. the task can be bounded to one worker
4. the target role can be resolved from `config/orchestration/roles.yaml`

Read [references/manager-integration.md](references/manager-integration.md) only when you need manager-side integration patterns for `opencode`, `Antigravity`, or another orchestrator.
Use [scripts/orchestration/orchestration_roles.py](/Users/shenlan/workspaces/cloud-neutral-toolkit/github-org-cloud-neutral-toolkit/scripts/orchestration/orchestration_roles.py) to inspect the configured role map.

## Entrypoint

Use exactly one of these commands:

```bash
scripts/orchestration/run_worker.sh --describe opencode
scripts/orchestration/run_worker.sh opencode "<prompt>"
scripts/orchestration/run_worker.sh ollama "<prompt>"
scripts/orchestration/run_worker.sh gemini "<prompt>"
```

Use `codex` only when the orchestrator explicitly falls back to Codex direct execution.

The wrapper already reads model defaults from [scripts/orchestration/openclaw_cli_defaults.py](/Users/shenlan/workspaces/cloud-neutral-toolkit/github-org-cloud-neutral-toolkit/scripts/orchestration/openclaw_cli_defaults.py). Do not duplicate model selection logic inside prompts.
Do not duplicate role assignment logic outside `config/orchestration/roles.yaml`.

## Role Resolution

Resolve role intent before writing prompts:

- `codex_app`: chief engineer and acceptance gate
- `codex_cli`: direct executor for fallback-only work
- `opencode`: optional orchestration manager
- `antigravity`: optional automation manager
- `opencode_cli`: bounded editor worker
- `gemini_cli`: independent auditor worker
- `ollama`: cheap reviewer worker

Inspect the current role map with:

```bash
python3 scripts/orchestration/orchestration_roles.py
python3 scripts/orchestration/orchestration_roles.py codex_app
python3 scripts/orchestration/orchestration_roles.py --format json
scripts/orchestration/run_worker.sh --describe ollama
```

## Worker Selection

Use `opencode` for:

- bounded repo-aware edits
- playbook, workflow, and docs fixes
- low-risk implementation within explicit path boundaries

Use `ollama` for:

- read-only review
- cheap repeated checks
- config audits
- smoke-check prompt execution

Use `gemini` for:

- read-only cross-check
- short audit
- alternate diagnosis

## Prompt Contract

Every worker prompt must include four fields:

1. `Task`
2. `Allowed`
3. `Forbidden`
4. `Return only`

Keep prompts as short as possible while preserving those fields.

Default read-only prompt:

```text
Task:
- one concrete objective

Allowed:
- explicit read-only scope

Forbidden:
- secrets output
- unrelated edits
- production changes

Return only:
- finding
- blocker

From haitaopanhq/.github, Apache-2.0.

More from haitaopanhq/.github