AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop
BetaBạn đang đọc tài liệu kênh beta (3.0.0-beta.15). Tính năng có thể thay đổi trước bản stable tiếp theo.Chuyển sang stable →

Skill

Định hình outcome marketing với ak:brainstorm

Dùng ak:brainstorm để biến intent chưa đầy đủ thành outcome, constraint, non-goal và acceptance criteria có thể quan sát đã được chấp nhận.

Dùng ak:brainstorm trước delivery marketing nhiều bước khi outcome, ranh giới hoặc cách tiếp cận mong muốn chưa được thống nhất. Skill biến yêu cầu chưa đầy đủ thành contract có scope rõ ràng, kiểm tra bằng chứng liên quan và so sánh tối đa ba hướng khả thi khi thực sự có lựa chọn. Skill không thực thi hướng đã chọn.

Chọn ak:brainstorm trước delivery

Dùng ak:brainstorm khi

  • Campaign, content program, thay đổi funnel hoặc launch có mục tiêu nhưng chưa có deliverable cụ thể và bằng chứng chấp nhận.
  • Nhiều cách tiếp cận có thể đạt mục tiêu và trade-off của chúng quan trọng.
  • Bạn cần tách target intent khỏi giả định về audience, channel, product hoặc behavior hiện tại của project.
  • Một vấn đề đã được chẩn đoán có nhiều giải pháp phù hợp với nguyên nhân.
  • Quyết định cần HTML brief bền vững để review trước planning.

Chọn workflow khác khi

  • Bạn cần câu trả lời kỹ thuật trực tiếp mà không qua design loop. Dùng ak:ask.
  • Hướng đi đã được chấp nhận và bạn cần implementation plan hoặc CRO plan bền vững. Dùng ak:plan.
  • Bug cụ thể chưa được chẩn đoán. Dùng ak:debug hoặc ak:fix; đừng brainstorm cách sửa từ triệu chứng.
  • Task đã rõ và chỉ cần thực thi theo domain. Dùng Marketing Skill phù hợp, đồng thời giữ publish, spend, outreach và thay đổi account thành phê duyệt riêng.

Chuẩn bị opening contract

Mang theo bằng chứng tốt nhất hiện có và sẵn sàng xác nhận bốn field:

FieldNội dung cần cung cấp
OutcomeTrạng thái cuối mà người dùng, audience hoặc vận hành có thể quan sát.
ConstraintsRanh giới brand, privacy, compliance, channel, thời gian, compatibility, budget và ownership.
Non-goalsCông việc gần kề mà delivery không được hấp thụ.
Acceptance criteriaBằng chứng có thể quan sát chứng minh outcome đã sẵn sàng cho bước tiếp theo.

Nếu brief hoặc plan đã duyệt chứa các field này, hãy trỏ Skill tới đó. Workflow nên dùng lại quyết định đã thống nhất và chỉ hỏi về khoảng trống quan trọng.

RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:brainstorm ...Hỗ trợ delivery native và plugin rõ ràng.
Cursor/ak:brainstorm ...Được projection thành Skill gọi bằng slash; không hàm ý parity rộng hơn.
Codex$ak:brainstorm ...Dùng discovery Skill native của Codex; automation bao quanh khác theo runtime.

Chạy Skill

/ak:brainstorm "Xác định launch outcome cho team workspace mới. Dùng interview note được cung cấp, loại trừ paid media và outbound outreach, so sánh tối đa ba hướng"

Chọn hành vi tùy chọn có chủ đích

Tùy chọnHiệu ứngRanh giới
Không có flagTrả về contract đã chấp nhận, cách tiếp cận được so sánh khi cần, recommendation, bằng chứng và rủi ro, đồng thời giữ toàn bộ scope đã yêu cầuKhông thêm phần chưa được yêu cầu và không triển khai hướng đi
--askChạy interview bounded, evidence-first trước khi chốt contractChỉ khi người dùng gọi; không chuyển tiếp downstream. Session headless áp dụng default được recommend cho lựa chọn đảo ngược được và hard-stop khi thiếu quyết định an ninh.
--htmlGhi brainstorm.html self-contained vào vị trí report được cấu hình của repositoryĐây là workspace mutation; không publish tệp
--ak-renderCompile brief brainstorm.html từ Page Spec bằng AK RenderOpt-in; ngầm bật --html; vẫn là workspace mutation, không publish tệp
--reportGhi Markdown report có timestamp với contract đã chấp nhận, các option, recommendation và câu hỏi chưa xử lýDùng thư mục report của active plan nếu có, nếu không dùng plans/reports/
--adviceThêm checkpoint tư vấn kongming sau quyết định, khi bị kẹt và trước lựa chọn rủi ro caoAdvice không thể duyệt gate, ghi deliverable hay mở rộng quyền hạn
--ultraChạy best-of-5 verifier pass trên cùng evidence packet và rubricNăm candidate brainstorm read-only chạy độc lập; verifier chọn một contract thắng nguyên vẹn hoặc reject tất cả candidate
--yagniThách thức và cắt scope không cần thiết cho outcome đã nêuKISS và DRY vẫn áp dụng; yêu cầu an toàn và acceptance rõ ràng vẫn nằm trong scope

Khi chọn --ultra, Skill giữ phần candidate ở chế độ read-only, yêu cầu năm candidate dùng được với một lần re-dispatch có giới hạn nếu cần, và ghi ranking appendix ngắn. Chế độ này yêu cầu dispatch song song nhiều candidate và dừng khi runtime không cung cấp khả năng đó. Chế độ này lấy cảm hứng từ LLM-as-a-Verifier nhưng không tuyên bố dùng logprob hoặc tournament mechanic. Với --report, Markdown report ghi candidate thắng và ranking appendix.

Khi chọn --html, brief gồm bốn field của contract, trade-off giữa các cách tiếp cận, recommendation, rủi ro chưa xử lý và diagram workflow triển khai. Với chủ đề UI/UX, brief còn yêu cầu mockup có annotation. Tệp giữ CSS và JavaScript inline, nhưng panel AntV mặc định có thể kết nối tới jsDelivr. Với công việc offline hoặc nhạy cảm về việc tiết lộ, dùng --no-antv hoặc --no-editorial-visuals. Khi visual preference bật các tính năng tương ứng, phần so sánh cách tiếp cận ưu tiên diagram-design Quadrant và tile effort hoặc impact ưu tiên AntV Infographic CandyCardLite hoặc CompactCard. Tắt các phần bổ sung này bằng --no-antv, --no-diagram-design hoặc --no-editorial-visuals.

Với --advice, kongming dùng advisory tier mạnh nhất cho host được phát hiện: Fable 5 cho Claude Code subscription, gpt-6-astra với low reasoning cho Codex, hoặc claude-fable-5-high cho Cursor. Host khác dùng session model mạnh nhất hiện có và báo rằng không thể pin Fable hoặc Astra.

Chọn tham gia route HTML AK Render

--ak-render ngầm bật --html và compile brief brainstorm.html từ Page Spec. Thay vì viết tay trang HTML, Skill ghi brainstorm.page.yaml cạnh brief rồi compile bằng compiler được ghim npx -y @bestagentkits/render@0.2.0, yêu cầu Node 20.11 trở lên. Project có thư mục .ak-render/ chứa theme preset của AK Render sẽ tự chọn route này, không có cách tắt cho từng lần chạy.

  • Route HTML viết tay vẫn là mặc định. AK Render vẫn là opt-in vì phép so sánh có đo lường với route mặc định chưa vượt quality gate.
  • Trang giữ đủ các section bắt buộc như route mặc định.
  • Các switch editorial visual chỉ áp dụng cho route mặc định.
  • Trang đã compile mở qua file:// với zero network request. Lần chạy npx đầu tiên tải package đã ghim từ npm registry; các lần sau dùng cache.
  • Để sửa trang, hãy sửa spec rồi compile lại. Không vá HTML đã compile.
  • Marketing Kit không có ak:diagram, nên diagram panel hiển thị fallback dạng văn bản có cấu trúc và Skill thể hiện thêm luồng bằng các bước hoặc timeline.
  • Nếu thiếu Node, npx hoặc không tải được package, hoặc spec vẫn không hợp lệ sau ba lần sửa, Skill dùng route mặc định và nêu lý do trong report.

Hiểu các giai đoạn workflow

  1. Ghi nhận hoặc dùng lại contract. Skill xác định outcome, constraint, non-goal và acceptance criteria.
  2. Kiểm tra bằng chứng liên quan. Skill đọc bề mặt project, content, test hoặc live state nhỏ nhất cần thiết trước khi khẳng định cách tiếp cận khả thi.
  3. Route bug qua chẩn đoán. Skill ghi nhận behavior cần khôi phục, rồi scout và chứng minh root cause trước khi thảo luận giải pháp.
  4. So sánh option có ý nghĩa. Khi có lựa chọn thiết kế thực sự, Skill trình bày tối đa ba cách tiếp cận khả thi và trade-off.
  5. Đề xuất hướng đủ dùng. Skill áp dụng KISS và DRY, giữ toàn bộ scope đã yêu cầu, không thêm phần chưa được yêu cầu và ghi nhận uncertainty còn lại. Với --yagni, Skill cũng thách thức scope không cần thiết.
  6. Handoff mà không thực thi. Skill chuyển contract, hướng đã chọn, bằng chứng và rủi ro chưa xử lý cho workflow planning hoặc delivery.

Yêu cầu rõ ràng không cần interview hình thức. Chỉ hỏi khi câu trả lời còn thiếu sẽ thay đổi đáng kể kết quả, ranh giới an toàn hoặc public contract và không thể khám phá từ bằng chứng.

Tách quyết định khỏi mutation

Hướng đã chọn không phải phê duyệt thực thi

ak:brainstorm không publish content, thay đổi campaign hay provider account, liên hệ audience, chi budget, deploy hoặc triển khai hướng đã chọn. --advice không đổi ranh giới này. --html chỉ cho phép local brief đã mô tả.

Nếu workflow kiểm tra analytics, customer research hoặc live platform, hãy giới hạn ở dữ liệu đã duyệt và quyền truy cập hiện tại. Không gửi credential, secret, personal data hay audience record bí mật tới dịch vụ bên ngoài nếu chưa có phê duyệt riêng và data-handling path phù hợp.

Review output và bằng chứng

Handoff hữu ích nên có:

  • Outcome, constraint, non-goal và acceptance criteria đã chấp nhận.
  • Bằng chứng hiện tại đã kiểm tra cùng khoảng trống hoặc uncertainty.
  • Tối đa ba cách tiếp cận khả thi khi lựa chọn có ý nghĩa.
  • Hướng được đề xuất với trade-off rõ ràng.
  • Rủi ro, quyết định chưa xử lý và workflow sở hữu bước tiếp theo.
  • Local brainstorm.html chỉ khi đã yêu cầu --html.
  • Markdown report có timestamp chỉ khi đã yêu cầu --report.

Kết quả sẵn sàng cho planning khi contract cụ thể và hướng đã chọn được bằng chứng hiện có hỗ trợ. Nó không chứng minh campaign, content hoặc thay đổi sản phẩm sẽ tạo ra business result.

Xử lý sự cố brainstorm

Triệu chứngBước tiếp theo an toàn
Runtime không tìm thấy ak:brainstormXác nhận target và scope, khởi động lại runtime, rồi làm theo Runtime không tìm thấy Skill hoặc Agent.
Skill hỏi nhiều câu ít giá trịCung cấp bốn field của contract và trỏ tới bằng chứng hoặc quyết định đã chấp nhận.
Option chung chungCung cấp constraint về audience, offer, channel, brand, privacy, timing, non-goal cùng bằng chứng Skill được phép kiểm tra.
Workflow đề xuất sửa trước chẩn đoánDừng và route failure cụ thể qua ak:debug hoặc ak:fix.
Thiếu brainstorm.htmlXác nhận đã truyền --html và vị trí report được cấu hình có thể ghi; báo giới hạn thay vì ghi nơi khác.
Thiếu Markdown reportXác nhận đã truyền --report và thư mục report của active plan hoặc standalone có thể ghi.
Skill bắt đầu implementationDừng tại handoff và yêu cầu plan hoặc domain workflow riêng đã được phê duyệt.

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

  • Brainstorm giúp cấu trúc quyết định; không thể đảm bảo demand, conversion, revenue, campaign performance hay platform support.
  • Chất lượng bằng chứng bị giới hạn bởi input, project access, tool và trạng thái provider hiện tại có trong session.
  • --html có thể mô tả trải nghiệm đề xuất, nhưng không phải trang đã deploy, campaign đã test hay creative asset đã duyệt.

Tiếp tục với ak:plan cho plan bền vững hoặc quay lại Tổng quan Marketing Kit để chọn domain workflow.