​
ak:orchestrate — Chạy workflow đa agent

Version: AK v2.19.1-beta.1 · Scope: project đã bật AK (ak/enable-ak-in-project.sh) · Updated: 2026-10-05 Có 2 lớp:
  • Skill /ak:orchestrate (gõ trong Claude Code) — nhận job spec YAML hoặc yêu cầu tự do, kiểm runtime thật trên máy, chọn model, rồi điều phối.
  • CLI ak orchestrate — bộ máy chạy nền: khởi chạy, theo dõi, resume, dừng một lần chạy.
Team dùng skill là chính; CLI để theo dõi/xử lý sự cố.
Giám sát tiến trình của CLI chỉ chạy trên macOS (Darwin) — phù hợp Mac mini làm máy chạy chung.

​
Khi nào dùng

  • Fan-out nhiều agent trên nhiều việc độc lập (ví dụ: 12 feature cùng migrate design system).
  • Pipeline có tầng: scout → implement song song → review → tổng hợp.
  • Việc chạy dài cần resume khi máy/phiên bị ngắt.
1 agent 1 việc → /cook hoặc /vibe là đủ.

​
Job spec (YAML) — schema thật

Trích từ references/job-spec.md của skill, chỉ các trường hay dùng:
Quy tắc:
  • Trường bắt buộc mỗi job: id, runtime, cwd, prompt (hoặc skill), timeout (hoặc defaults.timeout), expected_output, task (hoặc model).
  • runtime khác internal (ví dụ CLI codex) phải là runtime đang cài và đăng nhập — kiểm bằng ak orchestrate probe.
  • depends_on tạo tầng; job cùng tầng chạy song song khi owned_paths không chồng nhau.
  • effect cao (high-impact-write, external-destructive) sẽ bị chặn nếu không có quyền phù hợp hoặc approval: require.
  • Không ghi credential vào job spec — CLI lưu lại argv/env để resume.

​
Chạy

Trong Claude Code, tại project pilot:
hoặc mô tả tự do — skill tự dựng YAML vào thư mục report:

​
CLI — theo dõi và xử lý sự cố

Dữ liệu mỗi lần chạy: ~/.agentkit/orchestrate/runs/<run-id>/. Chi tiết tham số: ak orchestrate <lệnh> --help.

​
So với AO (Composio) đang dùng

​
Unresolved

  • Dashboard web cho orchestrate: chưa có, đang dùng ak gui / CLI
  • Chạy 24/7 trên Mac mini headless: chưa test