Ctrl K

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:orchestrate

Điều phối run agent có ghi nhận

Điều phối job theo stage hoặc song song qua runtime coding-agent được xác minh trực tiếp và subagent trong session, kèm routing theo rủi ro, write tách bằng worktree, state có thể resume, capture, safety gate và arbiter độc lập.

Brainstorm và nhận yêu cầu

Dựng graph job

Phát hiện, profile, route

Áp safety gate

Nguyên tắc 01

Ưu tiên một agent trực tiếp khi orchestration không tạo thêm parallelism, dependency theo stage, đa dạng runtime hoặc giá trị arbiter

Nguyên tắc 02

Phân giải mọi runtime, model, alias, flag và agent từ bằng chứng trực tiếp lúc chạy

Nguyên tắc 03

Job cùng stage chỉ chạy song song khi ownership và output không chồng lấn

Nguyên tắc 04

Worktree tránh đụng edit nhưng không phải sandbox hệ điều hành

Nguyên tắc 05

Phải có arbiter review trước khi tuyên bố bàn giao

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

Khởi động

Đầu vào, phạm vi, route

1 Brainstorm và nhận yêu cầu Làm rõ kết quả mong muốn, ràng buộc, non-goal, bằng chứng chấp nhận, workspace root, phụ thuộc, ý định phá hủy hoặc tác động ngoài, output kỳ vọng và ràng buộc runtime.
2 Dựng graph job Chuyển outcome đã nhận thành các job có task, cwd, timeout, output kỳ vọng, ownership file, dependency, importance, isolation, concurrency và chỉ dẫn skill rõ ràng.

Xử lý

Agent / skill thực thi

3 Phát hiện, profile, route Tạo inventory runtime trực tiếp, profile candidate, gọi model-routing và ghi runtime được chọn, model hoặc agent, capability tier, risk tier, kiểm soát, bằng chứng và lý do fallback.
4 Áp safety gate Xác nhận cwd, file được phép chạm, root được ghi, tác động phụ, kiểm soát least-privilege, phê duyệt cho hành động phá hủy hoặc tác động ngoài, nhu cầu worktree và timeout ngoài trước khi dispatch.

Kiểm chứng

Gate, review, xác thực

5 Dispatch và capture Tạo worktree cần thiết, chạy job độc lập theo giới hạn concurrency, cập nhật state.json khi chuyển trạng thái, dùng cơ chế lifecycle của ak orchestrate nơi được hỗ trợ và capture output/artifact đã redacted.
6 Chạy arbiter review Sau khi các job runnable đã settle, dùng route đánh giá C3 riêng để so output với artifact kỳ vọng, check, ý định ban đầu, route floor, safety gap, mâu thuẫn và câu hỏi còn mở.

Đóng

Báo cáo, bàn giao, artifact

7 Báo cáo kết quả đã capture Ghi report.md, lịch sử metrics, trạng thái job, route đã phân giải, artifact, lỗi, verdict của arbiter, check, lệnh tái hiện, diff worktree chờ tích hợp và câu hỏi còn mở.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:orchestrate <job-spec.yaml | task description> [--yes] [--internal]

hoặc

/ak:orchestrate --resume <run-dir>

Đối số

<job-spec.yaml | task description>

Spec job hoặc mô tả việc

Đường dẫn job-spec YAML cho run lặp lại được, hoặc outcome bằng ngôn ngữ tự nhiên để skill chuyển thành jobs.yaml tạm trước khi dispatch. Chỉ bỏ khi dùng --resume <run-dir>.

/ak:orchestrate plans/orchestrate-jobs.yaml

Option dùng chung

--internal

Ưu tiên agent nội bộ

Xét subagent trong session đủ điều kiện trước cho job chưa chỉ định runtime. Đây là ưu tiên routing, không phải chế độ bắt buộc, bảo đảm model hoặc bỏ qua quyền.

/ak:orchestrate "so sánh các tùy chọn xác thực" --internal

--yes

Dùng phê duyệt sẵn chính xác

Chỉ mang phê duyệt cho đúng phạm vi phá hủy hoặc tác động ngoài đã mô tả. Không cấp quyền rộng hơn cho credential, file, release, deployment hoặc bỏ qua safety gate.

/ak:orchestrate plans/orchestrate-jobs.yaml --yes

--resume <run-dir>

Tiếp tục run

Nạp lại thư mục run đã capture, giữ output thành công và attempt cũ, xác minh lại route trực tiếp và chỉ dispatch lại phần bị gián đoạn.

/ak:orchestrate --resume plans/reports/orchestrate-20260829

Flag kết hợp

Cách các option đi cùng nhau trên cùng một lần gọi. Không thay thế bảng option ở trên.

--internal là ưu tiên routing.

--yes chỉ áp dụng cho phạm vi phá hủy hoặc tác động ngoài đã được duyệt chính xác.

--resume dùng state đã capture thay vì làm lại từ đầu.

Mode / route nên dùng

--internal

Ưu tiên subagent trong session cho job chưa pin runtime, nhưng vẫn cho fallback CLI đã xác minh trực tiếp khi capability, chọn model hoặc isolation yêu cầu.

Nghiên cứu:: live
Review:: arbiter
Xác thực:: required

--yes

Chỉ xem phạm vi phá hủy hoặc tác động ngoài đã duyệt chính xác là được xác nhận; không bao giờ bỏ qua bằng chứng route trực tiếp, kiểm soát least-privilege hoặc safety gate.

Nghiên cứu:: live
Review:: arbiter
Xác thực:: required

--resume <run-dir>

Nạp lại jobs.yaml và state.json đã capture, giữ output thành công và attempt cũ, xác minh lại route trực tiếp và chỉ dispatch lại job bị gián đoạn.

Nghiên cứu:: revalidate
Review:: arbiter
Xác thực:: required

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Run theo stage từ yêu cầu tự do Khuyến nghị

/ak:orchestrate "nghiên cứu ba phương án triển khai và so sánh chúng"

Dùng khi:: Dùng khi các job research hoặc implementation độc lập có thể chạy theo stage và cần capture bằng chứng kèm arbiter review trước khi bàn giao.
Kết quả:: Tạo jobs.yaml tạm trong plans/reports/orchestrate-<timestamp>/, route trực tiếp từng job, capture state và artifact, chạy checklist arbiter và ghi report.md.

Spec YAML lặp lại được

/ak:orchestrate plans/orchestrate-jobs.yaml

Dùng khi:: Dùng cho graph job lặp lại được với dependency, output kỳ vọng, ownership, isolation, check và concurrency rõ ràng.
Kết quả:: Đọc job spec YAML, xác minh stage và ownership, phát hiện runtime trực tiếp, ghi runtimes.json và state.json, chạy các job runnable và báo cáo phát hiện của arbiter.

Routing ưu tiên nội bộ

/ak:orchestrate "so sánh các lựa chọn auth" --internal

Dùng khi:: Dùng khi nên xét subagent trong session trước, nhưng fallback CLI đã xác minh trực tiếp vẫn có thể cần cho kiểm soát model hoặc isolation mạnh hơn.
Kết quả:: Profile dispatch nội bộ và candidate CLI, ghi agent hoặc runtime fallback đã phân giải trong status.json, capture result.md nội bộ không giả lập field subprocess và chặn việc hạ chuẩn thiếu an toàn.

Resume run bị gián đoạn

/ak:orchestrate --resume plans/reports/orchestrate-20260829

Dùng khi:: Dùng sau gián đoạn khi jobs.yaml và state.json đã tồn tại và cần giữ output thành công hoặc attempt trước đó.
Kết quả:: Nạp lại thư mục run, reconnect các job đã giao cho ak orchestrate khi có thể, xác minh lại route trực tiếp, giữ phần đã xong, chỉ dispatch lại job bị gián đoạn và cập nhật report.md.

Ghi thật không hỏi

/ak:orchestrate plans/orchestrate-jobs.yaml --yes

Dùng khi:: Khi job spec đã review và bước mutate nên chạy không hỏi thêm.
Kết quả:: Xác minh spec YAML, bỏ prompt xác nhận thêm, chạy job runnable và vẫn ghi phát hiện arbiter vào report.md.

Phạm vi xử lý

Brainstorm và nhận yêu cầu
Dựng graph job
Phát hiện, profile, route
Áp safety gate
Dispatch và capture
Chạy arbiter review

Artifact tạo ra

Kết quả orchestrate

Mẫu đường dẫn

plans/reports/orchestrate-<timestamp>/report.md

Báo cáo cuối nêu spec, số job, route runtime/model/agent đã phân giải, capability và risk tier, artifact, lỗi, verdict của arbiter, check, lệnh tái hiện, diff worktree chờ tích hợp và câu hỏi còn mở.