Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:handover

Bàn giao sang agent có kiểm soát

Chuyển việc đang làm sang một runtime coding đã chọn bằng cách tạo hoặc xác thực handoff, nối vào spec orchestration một job, dispatch qua ak:orchestrate và báo kết quả.

01

Bắt buộc runtime

02

Kiểm tra task text

03

Capture hoặc nạp handoff

04

Xác thực handoff

Nguyên tắc 01

Compose ak:handoffak:orchestrate; không copy logic nội bộ của chúng.

Nguyên tắc 02

User chọn runtime; skill chỉ nối và xác thực, không tư vấn “agent tốt nhất”.

Nguyên tắc 03

Tham chiếu artifact và run log bằng path thay vì dán inline.

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.

01

Khởi động

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

  1. 1 Bắt buộc runtime Resolve --agent theo runtime catalog; không có default và không được âm thầm thay runtime.
  2. 2 Kiểm tra task text Từ chối task text chứa credential trước khi ghi artifact.
02

Xử lý

Agent / skill thực thi

  1. 3 Capture hoặc nạp handoff Gọi ak:handoff trừ khi user cung cấp --handoff PATH hợp lệ.
  2. 4 Xác thực handoff Kiểm tra H2 section bắt buộc, marker first-safe-step, pattern redaction và handoff-version trước khi dispatch.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Tạo spec Tạo một spec orchestration một job: prompt đọc artifact như context, enum task lấy từ next actions, effect là scoped-write, approval mặc định require.
  2. 6 Định tuyến model Chỉ truyền --model cho CLI runtime; từ chối --model với --agent internal vì job internal không đặt model.
04

Đóng

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

  1. 7 Dispatch Gọi ak:orchestrate và để preflight, runtime matrix, capture, resume và arbiter review cho skill đó.
  2. 8 Báo bằng con trỏ In path handoff, thư mục run của orchestrate, runtime/model, kết quả job, arbiter verification, con trỏ artifact tạo ra, first safe step, bước kế tiếp và blocker.

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:handover [task] --agent <id> [--cwd PATH] [--task TEXT] [--handoff PATH] [--model NAME] [--yes]

Đối số

[task]

Trọng tâm cho agent kế nhiệm

Trọng tâm tùy chọn bằng ngôn ngữ tự nhiên cho coding agent tiếp tục công việc. Nội dung này được đưa vào mission của handoff và prompt job orchestrate; dùng --task TEXT nếu muốn dạng flag.

/ak:handover --agent claude-code "continue the OAuth callback fix"

Option dùng chung

--agent <id>

Runtime code

Runtime được chọn và bắt buộc, ví dụ claude-code, codex, opencode, cursor hoặc internal. Runtime phải resolve trong runtime catalog; skill không bao giờ tự chọn fallback im lặng.

/ak:handover --agent codex --task "implement the next action in the handoff"
--cwd PATH

Root workspace

Root workspace cho job được dispatch. Mặc định là root workspace hiện tại và được truyền sang ak:orchestrate dưới dạng cwd.

/ak:handover --agent codex --cwd . --task "implement the next action in the handoff"
--task TEXT

Task text dạng flag

Dạng thay thế cho task positional. Nếu cả hai cùng có, task positional thắng và --task bị bỏ qua kèm cảnh báo.

/ak:handover --agent codex --task "implement the next action in the handoff"
--handoff PATH

Handoff có sẵn

Dùng artifact handoff có sẵn thay vì tạo mới. Path phải tồn tại và pass validation schema và redaction trước khi dispatch.

/ak:handover --agent cursor --handoff plans/handoffs/oauth-callback.md
--model NAME

Model CLI

Override model chỉ cho job chạy bằng runtime CLI. Bị từ chối với --agent internal vì job internal không đặt model.

/ak:handover --agent opencode --model anthropic/claude-sonnet-5
--yes

Duyệt tiếp tục

Duyệt rõ việc tiếp tục có ghi hoặc phá hủy bằng cách đổi approval của job được tạo từ require sang inherit.

/ak:handover --agent opencode --model anthropic/claude-sonnet-5 --yes

Đừng bỏ qua bước bắt buộc

Mỗi mục đối chiếu một lối tắt dễ mắc với cách làm đúng mà skill yêu cầu.

Lối tắt dễ mắc

Nếu runtime được yêu cầu fail thì tự chọn runtime khác.

Cách làm đúng

Không thay thế âm thầm; báo blocker và gợi ý chạy lại với --agent khác.

Lối tắt dễ mắc

Flag bypass permission giúp agent kế tiếp chạy nhanh hơn.

Cách làm đúng

Skill này từ chối flag bypass riêng của runtime.

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ế.

Tạo handoff rồi dispatch Khuyến nghị
/ak:handover --agent claude-code "continue the OAuth callback fix"
Dùng khi:
Khi cần runtime coding đã chọn tiếp tục việc hiện tại từ continuation contract vừa capture.
Kết quả:
Chạy ak:handoff trước, xác thực schema và trạng thái redaction của artifact, tạo một job claude-code với approval require, gọi ak:orchestrate rồi báo path handoff và run.
Dispatch handoff có sẵn
/ak:handover --agent cursor --handoff plans/handoffs/oauth-callback.md
Dùng khi:
Khi artifact handoff đã tồn tại và cần được xác thực rồi chuyển cho một runtime cụ thể mà không capture lại.
Kết quả:
Bỏ qua capture mới, kiểm tra file được cung cấp về H2 section bắt buộc, marker first-safe-step, version và raw-secret pattern, rồi dispatch một job cursor qua orchestrate.
Đặt cwd và task text
/ak:handover --agent codex --cwd . --task "implement the next action in the handoff"
Dùng khi:
Khi successor cần chạy trong workspace root cụ thể và nhận task string rõ ràng trong prompt của orchestrate.
Kết quả:
Dùng workspace hiện tại làm cwd của orchestrate, đưa task text vào mission handoff và job prompt, map routing enum từ next actions, đồng thời giữ approval scoped-write mặc định.
Override model CLI kèm approval
/ak:handover --agent opencode --model anthropic/claude-sonnet-5 --yes
Dùng khi:
Khi runtime CLI cần dùng model cụ thể và user đã duyệt rõ việc tiếp tục có ghi.
Kết quả:
Chỉ truyền model vì opencode là CLI runtime, chuyển approval của job sang inherit, giữ isolation scoped-write và vẫn để preflight cùng arbiter review cho ak:orchestrate.

Phạm vi xử lý

  • Spec orchestration một job
  • Bàn giao theo runtime catalog
  • Xác thực schema handoff
  • Nối approval và isolation

Artifact tạo ra

Kết quả handover

Mẫu đường dẫn

Artifact handoff, run orchestrate, runtime, model, kết quả job, verification, con trỏ artifact tạo ra, first safe step, bước kế tiếp, unresolved.

Báo cáo là tóm tắt bằng con trỏ; nội dung handoff, stdout và log chỉ được tham chiếu bằng path.

Skill liên quan

Tiếp theo