Tạo thẻ tham chiếu một trang và bảng tra cứu nhanh (cheat sheet) có mật độ thông tin cao, tối ưu hóa cho in ấn dành cho Basecamp và công cụ dòng lệnh Basecamp CLI chính thức (`basecamp`). Sở hữu bố cục chia hai cột tỷ lệ 60/40 bao gồm các luồng công việc CLI cốt lõi, các quy tắc bất biến cho tác tử (agent invariants), các chế độ đầu ra, cú pháp nhắc tên (mentions) và xử lý sự cố.
Hãy tạo một bảng tra cứu nhanh (cheat sheet) + thẻ tham chiếu bỏ túi dài một trang, được tối ưu hóa cho in ấn dành cho Basecamp + công cụ dòng lệnh Basecamp CLI chính thức (basecamp). Ràng buộc thiết kế (bắt buộc tuân thủ): - Một trang khổ US Letter (8.5×11"), hướng dọc (portrait), căn lề tối đa 0.4". - Mật độ thông tin cao nhưng có thể đọc lướt ngay lập tức. Không lan man. Mọi dòng đều phải xứng đáng với không gian nó chiếm giữ. - Phân cấp thị giác: tiêu đề phần in đậm, phông chữ đơn cách (monospace) cho mọi câu lệnh, đường phân cách trực quan tinh tế. - Hai vùng hợp lý trên trang: 1. 60% bên trái → Tham chiếu CLI cốt lõi (các câu lệnh + mẫu sử dụng) 2. 40% bên phải → Các quy tắc bất biến cho tác tử (Agent invariants), hồ sơ (profiles), cấu hình, mô hình tư duy, xử lý sự cố - Dải cuối trang (toàn chiều rộng) → Một dòng “Vòng lặp Tác tử Hàng ngày” (Daily Agent Loop) và quy tắc quan trọng nhất duy nhất. - Sử dụng Markdown thuần túy + CSS tối giản giúp in ấn sắc nét (hoặc tạo file PDF/DOCX hoàn chỉnh nếu công cụ hỗ trợ). Không dùng hình ảnh trang trí gây lãng phí mực in hoặc không gian. - Phải sử dụng tốt cả ở dạng tài liệu tham khảo để bàn (in một lần, ưu tiên ép plastic) lẫn dạng thẻ tra cứu nhanh “luôn để trước mắt”. Yêu cầu nội dung (rút ra từ các nguyên tắc Làm chủ Basecamp CLI): 1. Cài đặt & Xác thực (siêu nhỏ gọn) 2. Hồ sơ (Profiles - định danh đa tác tử) — tạo / đặt mặc định / sử dụng theo từng lệnh 3. Cấu hình cục bộ theo dự án (.basecamp/config.json) — cấu trúc khuyến nghị chính xác + cách các tác tử bắt buộc phải sử dụng nó 4. Các quy tắc bất biến cho tác tử (Agent Invariants - 6 quy tắc bắt buộc tuân thủ) — đánh số, in đậm, không thể bỏ sót 5. Bảng các chế độ đầu ra: --json / --agent / --jq / --md / --ids-only + khi nào nên dùng từng chế độ 6. Các mẫu câu lệnh cốt lõi (chỉ chọn những lệnh chủ lực thực sự): - Khám phá & điều hướng - Todos (tạo, liệt kê, hoàn thành, giao việc, dọn dẹp/sweep, ngày đến hạn) - Cards / Kanban (tạo, di chuyển, hoàn tất) - Messages / Chat / Comments (bao gồm cú pháp nhắc tên xác định - deterministic mentions) - Tệp & tệp đính kèm - Báo cáo, thước đo tiến độ (gauges), lịch trình (schedule) 7. Liên kết chuỗi điều hướng (Breadcrumb chaining) & thói quen tự kiểm tra bằng `--agent --help` 8. Mẫu nhắc tên (Mentions): định dạng ưu tiên `[@Name](mention:SGID)` 9. Mẫu vòng lặp tác tử hàng ngày (một ví dụ cô đọng) 10. Các câu lệnh một dòng xử lý sự cố (doctor, auth, noninteractive, kiểm tra cấu hình) Giọng văn & phong cách của bảng tra cứu: - Mật độ thông tin hữu ích cực cao. Ưu tiên chọn lọc khắt khe. - Các câu lệnh được hiển thị kèm theo những cờ (flags) hữu ích phổ biến nhất được gắn sẵn. - Ưu tiên các ví dụ thực tế, có thể sao chép-dán ngay thay vì mô tả trừu tượng. - Giả định người đọc là một tác tử AI (AI agent) hoặc người dùng chuyên sâu (power user) sẽ chạy các lệnh này trong terminal. Ưu tiên định dạng đầu ra: - Trước tiên, cung cấp phiên bản Markdown sạch sẽ, sẵn sàng để in, có thể dán vào trình duyệt hoặc công cụ chuyển đổi Markdown sang PDF. - Nếu môi trường hỗ trợ, hãy tạo thêm một bản PDF một trang hoàn chỉnh được tối ưu hóa cho in ấn (độ tương phản cao, không có nền màu gây tốn mực). Cuối cùng, thêm một dòng chân trang nhỏ: “Basecamp CLI Mastery — Agent-First Reference | Follow the breadcrumbs.” Hãy làm cho bảng tra cứu này xuất sắc đến mức người dùng thực sự muốn in ra, ép plastic và đặt cạnh bàn phím của họ mãi mãi.
