AgentKit · Workflow tham khảo

Workflow tham khảo cho AgentKit

Đang mở dần các workflow hay dùng. Các recipe khác sẽ hiện tiếp — xem rồi chỉnh cho phù hợp, không bắt buộc làm y hệt.

Cách gọi lệnh: Claude Code hoặc Cursor: gõ /ak:… · Codex: gõ $ak:…

Cách dùng workflow tham khảo

1

Chọn workflow gần với việc bạn đang làm

Feature, bug, review, ship…

2

Xem chuỗi skill gợi ý

Đây là tham khảo — được phép rút gọn hoặc thêm bước

3

Chạy từng lệnh /ak: theo thứ tự hợp lý

Claude Code / Cursor: /ak:… · Codex: $ak:…

Cách làm việc đơn giản

Kết quả tốt thường đi theo năm nhịp. Chỉ bỏ bước khi việc nhỏ và ít rủi ro.

  1. Hiểu
  2. Quyết
  3. Làm
  4. Kiểm
  5. Giao

Tư vấn

Hai cách nhờ tư vấn

Chọn một cách phù hợp — không cần dùng cả hai mọi lúc.

Thử thách hướng đi trước khi cam kết

/ak:advise

Dùng /ak:advise để nhận second opinion thẳng thắn trước khi cam kết một hướng. Chạy bằng model của main session (không phải kongming), hỏi từng câu, bạn xác nhận reframing, rồi nhận advice + checklist có thể hành động — không viết code.

Checkpoint kongming khi đang làm

--advice kongming trên plan, cook, fix…

Thêm --advice vào /ak:brainstorm, /ak:plan, /ak:cook, /ak:fix hoặc /ak:vibe để kongming giám sát giữa chừng. Không phê duyệt hay thay bước bạn duyệt plan. Khác với /ak:advise (và khác --agent).

Đừng gắn --advice cho sửa một file nhỏ. --hard --advice rất nặng — giữ cho việc high-risk.

Lọc theo loại việc

Chọn theo level

Bắt đầu với level dễ nếu bạn mới dùng AgentKit.

Nên thử trước

Workflow thường dùng

Các chuỗi skill hay dùng — chọn việc gần nhất, rồi chỉnh bước cho đúng context của bạn.

Bắt đầu

Cần quen một chút

Xây feature mới

Dùng khi: Feature hình dạng chưa rõ hoặc ảnh hưởng nhiều file

~30–90 phút · 7 bước

  1. 1
    /ak:brainstorm

    Khám phá hướng

    So sánh hướng trước khi chốt plan

  2. 2
    /ak:plan

    Viết plan

    Tạo plan theo phase để đưa sang cook

  3. 3
    Duyệt plan Bạn làm bước này

    Đọc và chấp nhận (hoặc sửa) trước khi code

  4. 4
    /ak:cook /path/to/plan.md

    Implement

    Chạy plan; truyền path plan

  5. 5
    /ak:test

    Kiểm thử

    Chạy test cho thay đổi

  6. 6
    /ak:code-review

    Review code

    Bắt regression và vấn đề chất lượng

  7. 7
    /ak:ship

    Mở PR / ship

    Gộp main, push, PR

Tuỳ chọn: thêm --advice

/ak:plan --advice "…"/ak:cook /path/to/plan.md --advice

Chuỗi đầy đủ có --advice nằm ở «Chuỗi feature có tư vấn»; thêm --hard/--tdd/--html như optional mode

Dễ bắt đầu

Implement nhanh

Dùng khi: Feature/fix nhỏ khi yêu cầu đã rõ

~5–20 phút · 3 bước

  1. 1
    /ak:cook "task"

    Implement

    Hoặc /ak:cook --fast cho đường ngắn

  2. 2
    /ak:test Tuỳ chọn

    Kiểm thử

    Thêm khi rủi ro hơn một dòng sửa

  3. 3
    /ak:code-review Tuỳ chọn

    Review

    Thêm với code dùng chung / nhạy cảm

Tuỳ chọn: thêm --advice

/ak:cook "small task" --advice

Cook nhanh kèm --advice

Lên plan & tư vấn

Nâng cao Cẩn thận

Chuỗi feature có tư vấn

Dùng khi: Feature đụng nhiều module, refactor lớn, hoặc đổi flow quan trọng — thử thách framing, rồi checkpoint kongming lúc plan/cook

~45–120 phút · 7 bước

  1. 1
    /ak:advise "problem" Tuỳ chọn

    Thử thách hướng đi

    Tuỳ chọn

    • --agent — Chỉ Claude Code: chạy advisor trên fable trong context riêng. Trên Codex sẽ fallback về cách chạy thường (inline).

    Dùng model bạn đang chọn trong session này. Chỉ hỏi–đáp tư vấn — không viết code.

  2. 2
    /ak:plan --advice "…"

    Plan có kongming

    Tuỳ chọn

    • --hard — phức tạp / nhiều module / stack chưa quen
    • --deep — refactor lớn nhiều vùng
    • --tdd — phase tests-first để cook an toàn hơn
    • --html — duyệt plan.html trực quan

    Kongming chỉ đưa checkpoint tư vấn — không thay bước bạn duyệt plan.

  3. 3
    Duyệt plan Bạn làm bước này

    Bạn vẫn phải chấp nhận plan trước khi cook. Nếu có plan.html thì đọc file đó cho dễ duyệt trực quan.

  4. 4
    /ak:cook /path/to/plan.md --advice

    Implement có kongming

    Tuỳ chọn

    • --tdd — khớp với plan nếu đã bật --tdd — tests-first từng phase
    • --auto — tự duyệt cổng — cẩn thận với việc high-risk

    Truyền đường dẫn plan thật. Cook đã chạy tester + code-reviewer.

  5. 5
    /ak:test "scope" Tuỳ chọn

    Cổng test độc lập

    Chỉ khi muốn kiểm scope cuối ngoài cook

  6. 6
    /ak:code-review --pending Tuỳ chọn

    Cổng review độc lập

    Tuỳ chọn review pending trước ship

  7. 7
    /ak:ship

    Mở PR

    Tạo PR; rồi theo dõi CI → merge → CI nhánh đích

Tuỳ chọn: thêm --advice

/ak:advise "problem"/ak:advise "problem" --agent/ak:plan --advice "…"/ak:cook /path/to/plan.md --advice

Advise inline = model main · --agent = advisor/fable (chỉ Claude Code; Codex → inline) · plan/cook --advice = kongming · thêm optional mode khi cần

Lưu ý Bấm để xem các lưu ý
  • Bỏ /ak:advise khi framing đã vững — inline dùng model main session, không phải kongming
  • --agent chỉ hỗ trợ đầy đủ trên Claude Code (advisor/fable + relay AskUserQuestion); trên Codex fallback về inline
  • --hard / --deep + --advice rất nặng — giữ cho việc high-risk
  • Bật --tdd trên plan khi muốn phase tests-first; truyền cùng --tdd sang cook cho khớp
  • Tuỳ chọn --html trên plan khi muốn duyệt plan.html trực quan trước khi chấp nhận
  • cook đã chạy tester + code-reviewer; /ak:test và /ak:code-review thêm chỉ khi muốn cổng độc lập
  • /ak:ship mở PR — chưa chứng minh đã merge hay CI xanh
Nâng cao Cẩn thận

Plan có cổng kiểm

Dùng khi: Plan cho kiến trúc, database, public API, payment, hoặc security — cần red-team / validate trước khi cook

~30–60 phút · 6 bước

  1. 1
    /ak:predict Tuỳ chọn

    Tranh luận hướng

    Kiểm đa persona trước khi plan

  2. 2
    /ak:plan

    Plan hard hoặc deep

    Tuỳ chọn

    • --hard — việc phức tạp cần research + red-team
    • --deep — refactor lớn nhiều vùng
    • --tdd — phase tests-first
    • --html — duyệt plan.html trực quan
    • --advice — checkpoint kongming giữa plan

    Chọn mode theo rủi ro — rồi chạy cổng trước cook

  3. 3
    /ak:plan red-team Tuỳ chọn

    Red-team plan

    Nếu chưa chạy tự động

  4. 4
    /ak:plan validate

    Validate plan

    Cổng nhất quán / sẵn sàng

  5. 5
    Duyệt plan Bạn làm bước này

    Chấp nhận trước cook. Nếu có plan.html thì đọc file đó cho dễ duyệt trực quan.

  6. 6
    /ak:cook /path/to/plan.md

    Implement

    Tuỳ chọn

    • --tdd — khớp với plan nếu đã bật --tdd
    • --advice — checkpoint kongming lúc implement

    Sau khi bạn chấp nhận; truyền path plan

Thêm

Thêm workflow sắp có

Đang mở dần các workflow hay dùng. Các recipe khác (bug, review, ship…) sẽ hiện dần trên trang này.

Tránh lỗi

Hay sai — làm thế này thay vì thế kia

  • Hay làm

    Chuỗi dài cho sửa một file

    Nên làm

    Một lệnh /ak:cook --fast (hoặc skill domain bạn đã biết)

  • Hay làm

    Bỏ review trên đăng nhập / thanh toán

    Nên làm

    Giữ bước security + review cho auth và tiền

  • Hay làm

    Ship trước khi test xong

    Nên làm

    Test (và review nếu rủi ro cao) trước /ak:ship

  • Hay làm

    Nhảy plan mới khi chưa có bằng chứng mới

    Nên làm

    Sửa bước đang hỏng, rồi tiếp tục chuỗi

  • Hay làm

    Gọi skill chưa cài

    Nên làm

    Xem bảng skills, hoặc chạy /ak:find-skills trước

  • Hay làm

    Nhầm /ak:advise, --agent, và --advice

    Nên làm

    /ak:advise = model main · --agent = advisor/fable · plan/cook --advice = kongming

  • Hay làm

    Gắn --advice mọi sửa nhỏ

    Nên làm

    Chỉ khi quyết định khó hoặc ảnh hưởng lớn

  • Hay làm

    Luôn xâu cook → test → code-review → ship

    Nên làm

    cook đã chạy tester + reviewer; cổng thêm chỉ khi muốn kiểm độc lập

Xem thêm