Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:brainstorm

Chốt kết quả và thiết kế phương án có giới hạn

Biến ý định chưa rõ hoặc lựa chọn giải pháp có ý nghĩa thành hợp đồng giao việc đã chấp nhận: kết quả, ràng buộc, ngoài phạm vi, tiêu chí nghiệm thu, phương án dựa trên bằng chứng, khuyến nghị và bàn giao sang plan, cook hoặc fix.

01

Xác định gate có áp dụng không

02

Tái dùng hoặc ghi contract

03

Giữ mức độ vừa đủ

04

Đưa bug qua chẩn đoán

Nguyên tắc 01

Brainstorm định hình ý định và phương án; nó không triển khai giải pháp.

Nguyên tắc 02

Đừng biến yêu cầu đã rõ thành buổi phỏng vấn hình thức; mức độ vừa đủ rất quan trọng.

Nguyên tắc 03

Phản biện giả định bằng bằng chứng, không bằng cảm giác.

Nguyên tắc 04

Mặc định giữ đủ phạm vi được yêu cầu; cần --yagni để cắt phần không cần thiết.

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 Xác định gate có áp dụng không Câu trả lời trực tiếp và tiện ích chỉ đọc nhỏ bỏ qua vòng thiết kế; delivery nhiều bước hoặc thay đổi workspace phải đạt gate contract mở đầu.
  2. 2 Tái dùng hoặc ghi contract Tái dùng thiết kế hoặc plan đã duyệt khi đã có outcome, constraint, non-goal và acceptance criteria; nếu chưa có thì ghi bốn trường đó.
02

Xử lý

Agent / skill thực thi

  1. 3 Giữ mức độ vừa đủ Với yêu cầu cụ thể, tóm tắt rồi tiếp tục; chỉ hỏi khi câu trả lời còn thiếu làm thay đổi đáng kể kết quả, ranh giới an toàn hoặc public contract và không thể tự tìm.
  2. 4 Đưa bug qua chẩn đoán Với lỗi, nêu hành vi kỳ vọng sau sửa, rà soát đường ảnh hưởng, ghi trạng thái lỗi và chứng minh root cause trước khi so sánh cách sửa bám theo nguyên nhân.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Kiểm tra bằng chứng liên quan Đọc tập source, tài liệu, test, plan hiện có hoặc trạng thái live nhỏ nhất cần thiết trước khi nói một hướng khả thi; tách ẩn số có thể tự tìm khỏi bất định thật.
  2. 6 So sánh lựa chọn quan trọng Nêu tối đa ba phương án khả thi cùng đánh đổi có ý nghĩa, khoảng trống bằng chứng, giả định trọng yếu, điều kiện thất bại đầu tiên và trường hợp xấu hợp lý.
04

Đóng

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

  1. 7 Khuyến nghị và xử lý bất đồng Chọn hướng nhỏ nhất đáp ứng contract; khi chưa xử lý được giả định, ưu tiên hướng rẻ nhất để từ bỏ và giải quyết bất đồng quan trọng trước implementation.
  2. 8 Bàn giao hoặc dừng Chuyển contract, hướng chọn, bằng chứng và rủi ro chưa xử lý sang plan, cook hoặc fix; với việc chỉ khám phá, báo recommendation rồi dừng.

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:brainstorm [topic or problem] [--advice] [--html] [--report] [--ultra] [--yagni] [--no-antv|--no-diagram-design|--no-editorial-visuals]

Đối số

[topic or problem]

Quyết định cần định hình

Yêu cầu, vấn đề, lựa chọn sửa bug hoặc hướng product/code/docs maintenance bằng ngôn ngữ tự nhiên để chuyển thành contract có giới hạn và recommendation.

/ak:brainstorm "Chọn cách thêm khôi phục bản nháp offline cho editor. Preserve các format lưu trữ hiện tại, tránh một service mới, và định nghĩa hành vi recovery có thể quan sát được."

Option dùng chung

--advice

Checkpoint cố vấn

Thêm tư vấn kongming sau quyết định, khi bị chặn và trước lựa chọn rủi ro cao. Cố vấn không thể sửa, phê duyệt hoặc mở rộng quyền hạn.

/ak:brainstorm "Chọn hướng migration auth" --advice
--ultra

Verifier best-of-5

Chạy năm bản brainstorm chỉ đọc độc lập trên cùng bằng chứng và tiêu chí chấm. Verifier chọn một bản nguyên vẹn hoặc loại tất cả; không trộn các candidate.

/ak:brainstorm "So sánh ba hướng data-sync" --ultra
--yagni

Cắt scope thừa

Chất vấn và bỏ phần việc không cần cho outcome đã nêu. Nếu không có flag này, skill giữ đủ phạm vi đã yêu cầu và chỉ loại phần thêm ngoài yêu cầu.

/ak:brainstorm "Đơn giản hóa redesign onboarding" --yagni
--no-antv

Không visual AntV

Tắt visual KPI/card AntV tùy chọn trong brief HTML. Không thay đổi delivery contract.

/ak:brainstorm "Lập kế hoạch refresh dashboard" --html --no-antv
--no-diagram-design

Không lớp diagram so sánh

Tắt visual so sánh diagram-design tùy chọn trong brief HTML. Không bỏ delivery-flow diagram bắt buộc và không đổi contract.

/ak:brainstorm "So sánh các flow onboarding" --html --no-diagram-design
--no-editorial-visuals

Không visual biên tập

Tắt toàn bộ lớp visual biên tập tùy chọn trong brief HTML. Nội dung bắt buộc và delivery contract không đổi.

/ak:brainstorm "Chọn cấu trúc trang launch" --html --no-editorial-visuals

Flag xuất bản / artifact

Chỉ các flag đổi artifact hoặc publish. Không phải toàn bộ option của skill.

--html

Brief HTML độc lập

Ghi brainstorm.html vào vị trí report đã cấu hình với các trường contract, đánh đổi, khuyến nghị, rủi ro, ít nhất một diagram delivery-flow và mockup UI có chú thích khi chủ đề liên quan UI/UX.

Ví dụ

/ak:brainstorm "Plan a dashboard refresh" --html
--report

Báo cáo quyết định Markdown

Lưu brainstorm đã chấp nhận thành báo cáo Markdown có timestamp trong thư mục reports của plan đang active, plans/reports độc lập hoặc đường dẫn Report được inject.

Ví dụ

/ak:brainstorm "Choose an API migration path" --report

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.

--advice thêm giám sát kongming ở checkpoint theo pha, khi kẹt và khi rủi ro cao.

--ultra đi cùng được với --html, --report, --advice--yagni.

--no-antv, --no-diagram-design--no-editorial-visuals chỉ ảnh hưởng lớp hình ảnh của HTML.

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

Hướng tính năng Khuyến nghị
/ak:brainstorm "Chọn cách thêm khôi phục bản nháp offline cho trình soạn thảo. Giữ các định dạng lưu trữ hiện tại, tránh dịch vụ mới, và định nghĩa hành vi khôi phục có thể quan sát được."
Dùng khi:
Dùng ở đầu delivery nhiều bước khi kết quả mong muốn đủ rõ để bàn nhưng cách làm chưa chốt.
Kết quả:
Định hình delivery contract bốn trường, kiểm tra bằng chứng liên quan trước khi khẳng định khả thi, so sánh tối đa ba hướng quan trọng, đề xuất hướng nhỏ nhất phù hợp và bàn giao sang plan, cook hoặc fix.
Báo cáo bền vững
/ak:brainstorm "Chọn kiến trúc cho chia sẻ bản xem trước" --report
Dùng khi:
Dùng khi brainstorm đã chấp nhận cần một decision record Markdown có timestamp trong vị trí reports của plan hoặc reports độc lập đã cấu hình.
Kết quả:
Lưu báo cáo Markdown có frontmatter, summary, bốn trường contract, các option đã so sánh, recommendation, câu hỏi chưa giải quyết ở cuối và đúng quy ước thư mục reports của plan đang active hoặc reports độc lập.
Brief HTML độc lập
/ak:brainstorm "Cấu trúc landing page cho lần ra mắt" --html
Dùng khi:
Dùng khi brainstorm cần tạo brief cục bộ có thể preview bên cạnh delivery contract, nhất là với quyết định UI hoặc UX.
Kết quả:
Ghi brainstorm.html vào vị trí report đã cấu hình với CSS/JS inline, không cần asset mạng, contract và so sánh option, diagram delivery-flow bắt buộc và mockup UI có chú thích khi chủ đề liên quan UI/UX.
Lượt verifier ultra
/ak:brainstorm "So sánh ba cách tiếp cận đồng bộ dữ liệu" --ultra --yagni
Dùng khi:
Dùng khi hướng delivery rủi ro cao đáng tốn chi phí cho năm candidate brainstorm chỉ đọc độc lập và một lượt verifier xếp hạng.
Kết quả:
Tạo một evidence packet và rubric bất biến, dispatch đúng năm candidate chỉ đọc, để verifier chọn một contract thắng nguyên vẹn hoặc reject tất cả, ghi phụ lục xếp hạng ngắn và áp dụng cắt scope theo --yagni.

Phạm vi xử lý

  • Xác định gate có áp dụng không
  • Tái dùng hoặc ghi contract
  • Giữ mức độ vừa đủ
  • Đưa bug qua chẩn đoán
  • Kiểm tra bằng chứng liên quan
  • So sánh lựa chọn quan trọng

Tiếp theo