Orca Cook Plan: chạy AgentKit plan qua Orca, mỗi phase một worker session mới

# Orca Cook Plan: chạy AgentKit plan qua Orca, mỗi phase một worker session mới Nguồn: https://modernengineer.dev/vi/library/orca-cook-plan > **Tóm tắt nhanh:** Orca Cook Plan điều phối một AgentKit plan có sẵn qua Orca. Coordinator xếp phase theo dependency, giao mỗi phase cho một worker session mới chạy `ak-cook`, hỏi bạn khi cần quyết định, đối chiếu bằng chứng rồi checkpoint. Bài đọc miễn phí; mua lẻ bộ file là có skill 1.2.3 để cài vào Claude Code, Codex, Cursor, Grok CLI, Pi hoặc OMP, kèm trang giới thiệu và sơ đồ luồng chạy tương tác. Ghi chú: bản beta hiện tại của AgentKit (từ 3.0.0-beta.35, 21/10/2026) đã đổi format tên skill từ `ak:<tên>` sang `ak-<tên>`, nên lệnh trong bài đã cập nhật theo tên mới: Claude Code gõ `/ak-plan`, Codex gõ `$ak-plan`. Nếu bạn còn dùng bản cũ hơn, đổi `ak-` thành `ak:` là ra lệnh tương ứng. Khi chạy cả một plan nhiều phase trong một session, mình hay gặp ba chuyện: worker hỏi thêm những thứ ngoài scope, coordinator quên tiến độ sau compact, và lần nào cũng phải dò lại công cụ của dự án. Orca Cook Plan tách việc ra: coordinator chỉ điều phối, worker làm từng phase trong session riêng, còn plan vẫn là điểm tựa. ## Skill này giải quyết gì - **Giữ đúng phạm vi.** Với `--auto`, coordinator quyết định trong phạm vi plan đã giao. Đề xuất mở rộng được ghi lại, không chặn phase đang chạy. - **Nhớ việc đang chờ.** Một checkpoint lưu Run, Task/Dispatch, quyết định, bằng chứng và bước tiếp theo. Sau compact hoặc fallback, coordinator khôi phục trong cùng session và Run cũ, đối chiếu Orca để không giao trùng hay chạy lại phase đã nghiệm thu. - **Dùng công cụ đã có.** Worker nhận entrypoint, lệnh, thư mục chạy và cách kiểm tra của dự án. Cách xử lý đã xác minh được dùng lại cho worker sau. - **Chọn runtime và model.** `--select-agent` hỏi lựa chọn một lần cho cả Run, tìm CLI trong môi trường worker và kiểm tra khả năng tích hợp trước khi chạy. Bài có kèm trang giới thiệu đầy đủ (tab “Tổng quan”) và sơ đồ coordinator, worker, advisor dạng tương tác (tab “Từng bước”). ## Bạn nhận được gì - Bộ file `orca-cook-plan` 1.2.3: `SKILL.md`, `README.md`, các file tham chiếu (`recovery`, `runtimes`, `selection`, `omp`), script dò runtime, extension Context Guard cho OMP và test. - Trang giới thiệu, bảng flags, Context Guard và changelog của skill. - Sơ đồ tương tác vai trò coordinator, worker, advisor. Bộ file dùng cho riêng bạn, không chia sẻ lại. Thành viên gói Subscriber tải bộ file mà không cần mua lẻ, và cài qua MCP để agent tự nhận bản mới. ## Ba vai trò  *Coordinator sở hữu Run, worker làm một phase, advisor chỉ phản biện.* | Vai trò | Làm gì | Không làm gì | | --- | --- | --- | | Coordinator | Sở hữu Run: xếp phase, giao việc qua Orca, xử lý câu hỏi, xác minh bằng chứng, chấp nhận kết quả, cập nhật plan và lưu checkpoint. Commit trong Git, hoặc ghi bằng chứng theo phạm vi file nếu workspace không dùng Git. | Không tự implement hay review lại toàn bộ code khi report và bằng chứng đã đủ. | | Worker | Làm một phase trong session riêng: implement, test và review theo cook, rồi báo `worker_done`. Ưu tiên công cụ dự án, hỏi qua Orca khi cần quyết định. | Không tự stage, commit hay chạy phase tiếp theo. Repair dùng một worker session mới. | | Advisor | Phản biện cách làm và đề xuất điều chỉnh. | Không sở hữu Run, không dispatch hay commit. | `worker_done` chưa có nghĩa phase đã đạt. Coordinator đối chiếu bằng chứng, nghiệm thu và ghi checkpoint trước khi giao việc phụ thuộc. Phase không có thay đổi được ghi nhận thay vì tạo commit rỗng. ## Chuẩn bị trước khi cài 1. **Orca.** Coordinator cần Orca để tạo Task, mở worker session và theo dõi tiến độ. 2. **AgentKit Engineer Kit** trong runtime của worker, vì worker chạy `ak-cook`. Ví dụ với OMP: `ak kit init engineer --target omp --yes`. Mua AgentKit qua [link giới thiệu của mình](https://agentkit.best/?ref=OMG49S8R), giảm 30%. 3. **Runtime** bạn định dùng: OMP nếu muốn có Context Guard, hoặc Claude Code, Codex, Cursor, Grok CLI, Pi. Coordinator và worker có thể dùng runtime khác nhau. 4. **Python 3**, và **Node.js** nếu dùng extension trên OMP. ## Cài từ bộ file Thành viên gói Subscriber đã nối [MCP server modernEngineer](https://modernengineer.dev/vi/mcp) không cần làm tay: dán câu lệnh ở phần Bộ file vào agent, agent tự tải, cài và cập nhật khi có bản mới. Tải bộ file ở cuối bài rồi giải nén. Trong file zip, thư mục skill nằm ở `orca-cook-plan/orca-cook-plan/`. Chép **nguyên thư mục** này, gồm cả `extensions/` và `references/`, vào thư mục skills của runtime: | Runtime | Theo dự án | Global | | --- | --- | --- | | Claude Code | `.claude/skills/` | `~/.claude/skills/` | | Codex | `.agents/skills/` | `~/.agents/skills/` | | OMP | `.omp/skills/` | `~/.omp/agent/skills/` | | Pi | `.pi/skills/` | `~/.pi/agent/skills/` | | Cursor | `.cursor/skills/` | `~/.cursor/skills/` | | Grok CLI | `.grok/skills/` | `~/.grok/skills/` | Ví dụ cài global cho Claude Code: ```bash unzip orca-cook-plan-v1.2.3.zip mkdir -p ~/.claude/skills test ! -e ~/.claude/skills/orca-cook-plan && cp -R orca-cook-plan/orca-cook-plan ~/.claude/skills/ ``` Nếu thư mục đích đã có `orca-cook-plan`, dừng lại và xem diff trước khi thay. Dùng `orca-cook-plan` ở nhiều dự án hoặc worktree với Claude Code hay Codex? Bài [Để agent tự cài và cập nhật AgentKit cùng bộ skill cho nhiều dự án qua MCP](https://modernengineer.dev/vi/library/agent-control-plane-mcp-first) hướng dẫn để agent giữ một bản gốc, link vào từng dự án và cập nhật khi có bản mới. ### Thêm bước cho OMP Chép thư mục skill chưa làm Context Guard tự nạp. Tạo thêm một file loader cùng phạm vi: | Phạm vi | Skill | Loader | | --- | --- | --- | | Dự án | `.omp/skills/orca-cook-plan/` | `.omp/extensions/subscriber-orca-cook-plan.js` | | Global | `~/.omp/agent/skills/orca-cook-plan/` | `~/.omp/agent/extensions/subscriber-orca-cook-plan.js` | Nội dung loader: ```js export { default } from "../skills/orca-cook-plan/extensions/context-guard.mjs"; ``` Mở session OMP mới rồi gọi skill. Extension ban đầu ở trạng thái idle; coordinator cấu hình và kích hoạt khi chạy Run. Kiểm tra extension đã nạp bằng `/orca-cook-context-status`. Không nạp thêm bản trùng qua `--extension`. Nếu gỡ skill, gỡ cả loader để tránh lỗi import. ## Cách gọi Mở session mới tại dự án rồi gọi skill với đường dẫn plan thật (tuyệt đối hoặc tương đối, có thể thêm tiền tố `@`): | Runtime | Cú pháp | | --- | --- | | Claude Code, Cursor, Grok CLI | `/orca-cook-plan plan.md --auto` | | Pi, OMP | `/skill:orca-cook-plan plan.md --auto` | | Codex | `$orca-cook-plan plan.md --auto` | Vài cách kết hợp (cú pháp OMP): ```text /skill:orca-cook-plan plan.md --advice --auto /skill:orca-cook-plan plan.md --runtime omp --omp-advisor all --advice --auto /skill:orca-cook-plan plan.md --runtime omp --omp-advisor phase-02,phase-04 --auto --tdd /skill:orca-cook-plan plan.md --select-agent --parallel --auto ``` Không có flag thì worker dùng runtime hiện tại và mode mặc định của cook; quyết định cần duyệt được chuyển qua coordinator tới bạn. ## Flags Có hai lớp: flags điều phối do Orca Cook Plan xử lý, và flags chuyển xuống `ak-cook` cho từng phase. Đây là quy ước gọi skill, không phải một CLI parser riêng; coordinator đối chiếu flags với bản cook thật trong runtime của worker trước khi dispatch. **Flags điều phối** | Flag | Ý nghĩa | | --- | --- | | `--runtime <agent-id>` | Chọn runtime của worker, không đổi runtime coordinator. Mặc định là runtime hiện tại. Nhận `--runtime omp`, `--runtime=omp`, `--runtime=current`. | | `--select-agent` | Hỏi runtime và model chính trước lần dispatch đầu, lưu cho cả Run và recovery. `--auto` vẫn chờ lựa chọn này. | | `--auto` | Coordinator tự quyết các approval trong plan. Worker không nhận `--auto` của cook, vẫn hỏi qua Orca. Không bao giờ tự mở rộng scope, bỏ qua quyền truy cập hay tự publish, deploy. | | `--omp-advisor` | Chỉ cho worker OMP: `all`, `none`, hoặc danh sách phase như `phase-02,phase-04` (áp cả cho repair của chúng). | | `--parallel` | Ưu tiên chạy các phase độc lập song song. Dependency và xung đột ghi vẫn được giữ; mặc định tối đa hai worker. | **Flags chuyển xuống `ak-cook`** | Flag | Ý nghĩa | | --- | --- | | `--advice` | Bật advisory workflow của AgentKit (kongming) cho mỗi phase và repair. Độc lập với `--omp-advisor`, bật cùng lúc được. | | `--tdd` | Viết test cho hành vi hiện tại trước, rồi kiểm tra lại sau implement. | | `--interactive` | Workflow đầy đủ có các review gate; câu hỏi vẫn qua coordinator. | | `--fast` | Bỏ bước research: scout, plan, code. Không bỏ review, test hay mở rộng phạm vi. | | `--no-test` | Bỏ bước test của cook. Report phải ghi rõ phần chưa được xác minh. | | `--yagni` | Cho cook cân nhắc cắt phần scope không cần cho outcome, không tự bỏ acceptance criterion. | | `--skip-journal` | Bỏ bước tự ghi journal khi finalize. | ## Context Guard (chỉ OMP) Guard là extension riêng trên session OMP. Khi active, nó nhắc đúng vai trò, Run và checkpoint; nhắc lưu checkpoint khi telemetry chạm ngưỡng context; nhắc recovery sau compact hoặc fallback; và chặn mọi tool trừ đọc, ghi checkpoint khi session chạy model ngoài `allowedModels` của role. Guard không tự đổi model, không tự lưu checkpoint và không đánh thức runtime đã dừng. Claude Code, Codex, Cursor, Grok CLI và Pi vẫn dùng workflow, checkpoint và hướng dẫn recovery, nhưng không có hook tự theo dõi context. Nếu coordinator chạy Codex còn worker chạy OMP, chỉ worker OMP có guard. ## Câu hỏi hay gặp **Trả lời muộn thì coordinator có tiếp tục không?** Skill lưu câu hỏi cùng việc đang chờ. Khi bạn trả lời hoặc session được khôi phục, coordinator xử lý đúng quyết định đó rồi tiếp tục. Nó không tự đánh thức một runtime đã kết thúc. **Sau compact hoặc fallback có mở coordinator mới không?** Không. Coordinator đọc lại checkpoint, đối chiếu Run, Task, Dispatch, câu hỏi còn chờ và bằng chứng, rồi tiếp tục trong cùng session và Run. Không khôi phục được thì nó báo rõ blocker và đường dẫn checkpoint. **Khi nào được thay worker?** Chỉ khi recovery trong session worker không thể tiếp tục. Worker mới làm tiếp phần acceptance chưa xong của cùng Task, không làm lại cả phase. **Vì sao mở OMP mà guard vẫn idle?** Được nạp chưa có nghĩa đang active. Idle là bình thường khi chưa chạy Run hoặc Run đã xong. Telemetry `unknown` nghĩa là chưa đủ dữ liệu, không chứng minh context còn nhiều. ## Giới hạn đã biết Skill đã qua kiểm tra logic, smoke OMP và một số lifecycle của Orca. Mình chưa kiểm thử full cook E2E trên cả sáu runtime, trên native Windows, hay khi quota cạn và context đầy thật. Fallback model do runtime và cấu hình của bạn quản lý. Đừng coi trạng thái im lặng là hoàn thành.

unzip orca-cook-plan-v1.2.3.zip
mkdir -p ~/.claude/skills
test ! -e ~/.claude/skills/orca-cook-plan &&
  cp -R orca-cook-plan/orca-cook-plan ~/.claude/skills/

export { default } from "../skills/orca-cook-plan/extensions/context-guard.mjs";

/skill:orca-cook-plan plan.md --advice --auto
/skill:orca-cook-plan plan.md --runtime omp --omp-advisor all --advice --auto
/skill:orca-cook-plan plan.md --runtime omp --omp-advisor phase-02,phase-04 --auto --tdd
/skill:orca-cook-plan plan.md --select-agent --parallel --auto

Đọc bài "Orca Cook Plan: chạy AgentKit plan qua Orca, mỗi phase một worker session mới" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "orca-cook-plan". Nếu chưa nối MCP hoặc bị từ chối quyền, đọc thẳng trang https://modernengineer.dev/vi/library/orca-cook-plan.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.

claude mcp add --transport http modernengineer \
  https://api.modernengineer.dev/mcp \
  --header "Authorization: Bearer <API key>"