Improvement Orchestrator

Coordinates the full improvement pipeline: Generator → Discriminator → Evaluator → Executor → Gate.

When to Use

• Run a full improvement cycle on one or more skills
• Coordinate the 5-stage pipeline end-to-end (with optional evaluator)
• Retry failed improvements with trace-aware feedback (Ralph Wiggum loop)

When NOT to Use

• 只想检查 skill 质量评分 → use improvement-learner
• 只想手动给候选打分 → use improvement-discriminator
• 只想改一个文件 → use improvement-executor
• 只想查基准数据 → use benchmark-store

Pipeline

propose → discriminate → evaluate* → execute → gate
         ↻ Ralph Wiggum: fail → inject trace → retry (max 3)
         * evaluate is optional — skipped if no task_suite.yaml exists

CLI

python3 scripts/orchestrate.py \
  --target /path/to/skill \
  --state-root /path/to/state \
  --max-retries 3 \
  --auto

Output Artifacts

Request	Deliverable
Full pipeline	JSON with all stage outputs, final scores, execution trace
Retry cycle	Updated candidates with injected failure traces

Related Skills

• improvement-generator: Produces candidate proposals (stage 1)
• improvement-discriminator: Multi-reviewer panel scoring (stage 2)
• improvement-evaluator: Task suite execution validation (stage 3, optional)
• improvement-executor: Applies changes with backup/rollback (stage 4)
• improvement-gate: 6-layer quality gate (stage 5)
• benchmark-store: Frozen benchmarks and Pareto front data

References

• Architecture — System design and data flow
• Guardrails — Safety rules and protected targets
• End-to-End Demo — Complete walkthrough