Điều phối agent job đã xác minh với ak:orchestrate

Dùng ak:orchestrate khi một outcome hưởng lợi từ staged dependency, parallel work, runtime diversity hoặc arbiter độc lập. Skill xác minh từng runtime cùng control tại thời điểm chạy, isolate writer rủi ro, capture evidence có giới hạn và từ chối đánh dấu công việc chưa được xác minh là hoàn tất. Skill sở hữu routing và judgment; ak orchestrate sở hữu plan state xác định, giám sát process và evidence quan sát được.

Chọn ak:orchestrate cho job graph

Dùng ak:orchestrate khi

• Nhiều job độc lập có thể chạy parallel với ownership riêng.
• Job sau phụ thuộc artifact hoặc check rõ từ job trước.
• Bạn cần route research, implementation, test và review theo capability cùng risk.
• Lần chạy dài cần durable state và resume behavior có giới hạn.
• Independent judgment pass nên hòa giải output mâu thuẫn.

Chọn workflow khác khi

• Một agent có thể hoàn tất task mà không cần fan-out hay arbitration hữu ích.
• Teammate cần thảo luận trực tiếp liên tục và shared multi-session state. Dùng ak:team khi runtime hiện tại hỗ trợ.
• Bạn chỉ cần code map read-only nhanh. Dùng ak:scout.
• Bạn có một implementation plan đã chấp nhận. Dùng ak:cook trừ khi runtime diversity hoặc isolation là quan trọng.

Chuẩn bị workspace và runtime

Trước khi bắt đầu:

• Hoàn thành Làm quen và xác nhận Engineer Kit đã được cài cho runtime cùng scope đang dùng.
• Dùng Git repository khi có job cần worktree isolation.
• Xác định outcome, constraint, non-goal, acceptance evidence, allowed file và external-effect boundary.
• Bảo đảm từng candidate CLI runtime đã được cài và authenticated. Discovery không install, update, login hay đổi configuration.
• Không đưa credential và private data không liên quan vào prompt hay capture.

Runtime gọi Skill không tự động là runtime được chọn cho mọi job.

Kiểm tra hỗ trợ nền tảng

ak:orchestrate không chỉ dành cho macOS. Chỉ việc giám sát process bên ngoài bởi ak orchestrate mới yêu cầu Darwin.

Trên host không phải Darwin, Skill route job đủ điều kiện qua runtime: internal. Job cần process CLI hoặc Pi được giám sát được giữ ngoài spec đã prepare và được báo blocked kèm lý do nền tảng. verification: do bạn hoặc spec được cung cấp khai báo là acceptance constraint: job đó bị block, không bao giờ được chuyển đổi. Chỉ trong spec do Skill tự soạn, Skill mới liệt kê check command trong checks:, chạy chúng trong harness và ghi nhận là harness-attested. Skill không bao giờ bypass supervision gate, launch process không được giám sát để thay thế, hay advance lại job đã bị kẹt ở gate đó. Khi cũng không có in-session Agent nào đủ điều kiện, lần chạy block và nêu lý do.

Chạy Skill

/ak:orchestrate "Map the session boundary, propose two designs, implement the accepted low-risk change in isolated ownership, then run an independent review"

/ak:orchestrate "Map the session boundary, propose two designs, implement the accepted low-risk change in isolated ownership, then run an independent review"

$ak:orchestrate "Map the session boundary, propose two designs, implement the accepted low-risk change in isolated ownership, then run an independent review"

Với công việc lặp lại, truyền đường dẫn YAML job spec. Với công việc bị gián đoạn, truyền run directory hiện có bằng --resume. Dispatch job CLI bằng ak orchestrate prepare <jobs.yaml> <run-dir> rồi ak orchestrate advance <run-dir> --json. Đừng bypass attempt chưa chắc bằng cách gọi start thủ công. Đọc status, events --after <cursor> và output --offset <bytes> đến all_settled. Dùng diagnose --json cho bundle quan sát; đừng export graph.json hay job spec riêng. graph.json có thể chứa argv và environment.

Mô tả job rõ ràng

Mỗi job cần:

• Intent: Task class như scout, architecture, implementation, review, audit, security, test, documentation hoặc mechanical work.
• Workspace: Working directory chính xác trong authorized workspace.
• Ownership: Tệp được phép ghi hoặc read-only scope rõ ràng.
• Dependencies: Job phải thành công trước khi job này bắt đầu.
• Expected output: Report, diff, test result hoặc artifact có thể xác minh.
• Checks: Command hoặc evidence arbiter phải kiểm tra.
• Risk: Read-only, scoped write, isolated high-impact write hoặc external/destructive effect.
• Bounds: Timeout và runtime, model, Agent, tool hoặc budget constraint rõ.

Runtime hoặc model pin là constraint, không phải bằng chứng nó hiện diện hay an toàn. Nếu live candidate không đạt capability cùng control floor, job block thay vì âm thầm hạ thấp yêu cầu.

Hiểu workflow

1. Skill chấp nhận contract. Skill xác nhận outcome, boundary, expected evidence, dependency và external intent.
2. Skill xây và validate graph. Skill reject duplicate ID, dependency cycle, working directory không an toàn, bound còn thiếu và parallel write overlap.
3. Skill kiểm kê live candidate. Skill xác minh executable hoặc Agent availability, authentication readiness, command shape hiện tại, selectable route, permission, isolation, timeout, capture, resume behavior và host limitation.
4. Skill phân loại capability và risk. Read-only extraction, implementation và independent judgment có minimum floor khác nhau. Safety control được lọc trước cost hay latency.
5. Skill áp dụng approval gate. Destructive, release, deployment, deletion, credentialed cùng external effect khác cần approval chính xác và recovery plan.
6. Skill dispatch theo stage. Independent job chỉ chạy cùng nhau trong concurrency limit. Parallel writer dùng worktree riêng và ownership không chồng lấn.
7. Skill capture durable evidence. State transition, bounded output, artifact, error, duration và usage được báo đáng tin vẫn sẵn sàng cho diagnosis cùng resume. Process CLI và Pi được giám sát yêu cầu Darwin; trên host khác, internal job đủ điều kiện tiếp tục qua cùng vòng prepare, advance và accept, như mô tả trong phần Kiểm tra hỗ trợ nền tảng ở trên.
8. Skill chạy arbiter. Judgment route riêng kiểm tra expected output, contradiction, safety gap, failed check, unsupported claim và unresolved question.
9. Skill report mà không tự integration. Worktree diff vẫn chờ review; merge hoặc cherry-pick là action riêng.

So sánh shadow tùy chọn

Routing áp dụng mọi mức sàn về capability và rủi ro cùng các lựa chọn bạn đã ghim trước. Luồng mặc định không bao giờ gọi lệnh semantic hay đọc cấu hình provider. Chỉ với thử nghiệm do bạn yêu cầu, hoặc khi context đã có sẵn một opt-in đáng tin cậy từ bạn, Skill mới có thể chạy ak eval decision. Skill chỉ cung cấp các dữ kiện ngắn gọn (task, tác động, mức độ quan trọng và việc có chạy song song hay không) cùng phân loại rủi ro và capability hiện có, không bao giờ gửi prompt của job, log hay credential.

Lệnh kiểm tra consent và chỉ tạo phép so sánh shadow. Lệnh không thể đổi runtime hoặc model đã chọn, hạ kiểm soát rủi ro hay mức sàn capability, cấp phê duyệt, hoặc mở khóa một route không khả dụng. Skill theo kết quả routing hiện có mỗi khi có bất đồng hoặc provider gặp lỗi.

Giữ quyền phê duyệt và an toàn ở bạn

Mỗi CLI process có timeout do coordinator sở hữu. In-session timeout chỉ là accounting limit trừ khi live harness chứng minh cancellation; Skill không được launch writer khác vào cùng ownership khi timed-out Agent có thể vẫn chạy.

Permission bypass mặc định tắt. Headless runtime auto-approve write bị giới hạn ở read/report work hoặc treatment isolate mạnh hơn. Không job nào được đặt token, cookie, private key, raw environment value hay secret argument vào request hoặc capture.

Xác minh kết quả

Một lần chạy hoàn tất nên cung cấp:

• Job graph đã validate với dependency, ownership, bound, expected output và check.
• Live runtime inventory cho candidate verified, constrained, unavailable và unverified mà không chứa secret value.
• Per-job status, resolved route, risk cùng capability classification, artifact, error, timeout và attempt.
• Failed hoặc interrupted evidence được giữ thay vì silent retry.
• Arbiter verdict kiểm tra mọi required artifact cùng contradiction.
• Final report nêu successful, failed và blocked job, check, worktree diff chờ integration cùng unresolved question.

Lần chạy chỉ thành công khi mọi required job thành công, check pass, claim có evidence, contradiction được giải quyết và arbiter pass.

Xử lý sự cố hoặc resume

So sánh ak:team cho live multi-session collaboration, hoặc tiếp tục với Engineer Kit và Runtime adapter.

Biết các giới hạn hiện tại

• Runtime cùng model catalog, authentication, flag và safety control thay đổi; mỗi lần chạy phải xác minh trực tiếp.
• In-session Agent có thể không cung cấp force cancellation, per-job sandboxing hay selectable model.
• Job không chia sẻ implicit memory; dependency phải truyền explicit artifact.
• Worktree cần Git cùng disk headroom, và integration vẫn là action được review riêng.
• Usage cùng cost chỉ xuất hiện khi harness đã chọn báo đáng tin.
• Skill điều phối runtime hiện có; Skill không tạo daemon, dashboard, account pool hay provider adapter.
• Job CLI và Pi được giám sát, check verification: thực thi được và các lệnh supervisor start, status, resume, stop yêu cầu Darwin. Host khác chạy job runtime: internal đủ điều kiện và block phần còn lại.