Chuyển đến nội dung chính
Skill tùy chỉnh là bộ hướng dẫn viết thành văn bản (file SKILL.md) dạy CloudThinker cách nhóm bạn làm một việc, chẳng hạn checklist review, thứ tự leo thang hay quy ước gắn tag. Bạn viết một lần trong More → Workspace settings → Skills, và agent áp dụng ở mọi nơi bạn cho phép, nên không ai phải gõ lại cùng một quy tắc vào từng prompt.

Khi nào nên viết skill

Hãy viết skill khi thấy mình nhắc đi nhắc lại cùng một chỉ dẫn. Một vài ví dụ điển hình: Skill cho agent biết cách hành động; tài liệu tham khảo để tra cứu thuộc về knowledge base. Xem khi nào nên dùng skill.

Điều kiện tiên quyết

  • Vai trò phù hợp với cách tạo bạn chọn. Developer và Viewer đọc được skill nhưng không thấy nút + hay New Skill. Xem vai trò.
  • Nếu bạn định tự viết SKILL.md hoặc tải lên một gói, hãy đọc qua định dạng skill.

Tạo skill

1

Mở Skills

Vào More → Workspace settings → Skills. Trang liệt kê các skill của workspace ở bên trái và hiển thị skill đang chọn ở bên phải.
2

Mở menu tạo skill mới

Nhấn nút + cạnh Search skills, ở đầu danh sách skill. (Khi chưa có skill nào, trang hiển thị nút New Skill thay thế.) Chọn một cách tạo trong menu. Dùng tab bên dưới tương ứng với cách bạn chọn.
3

Tạo skill

Phù hợp nhất cho skill đầu tiên. CloudThinker phỏng vấn bạn và soạn file.
  1. Nhấn Create with CloudThinker. Một cuộc chat mở ra với lệnh /create-skill đã điền sẵn.
  2. Gửi lệnh, rồi trả lời các câu hỏi. Mô tả một quy tắc cụ thể mà nhóm bạn áp dụng, kèm ví dụ.
  3. Xem bản nháp CloudThinker đề xuất. Khi được hỏi Proceed with creating this skill?, chọn Yes, create it, hoặc chọn Change something và nói rõ cần đổi gì. Sau đó mở More → Workspace settings → Skills để xác nhận skill đã có, đang bật và khả dụng trong Chat.
Bạn có thể bắt đầu quy trình này từ bất kỳ cuộc chat nào bằng cách gõ /create-skill. Đây là cuộc chat bình thường nên có tốn credit. Chưa có gì được lưu cho đến khi bạn chọn Yes, create it, nên dừng giữa chừng sẽ không để lại skill dở dang.
Trạng thái thành công: skill xuất hiện trong danh sách với công tắc bật và Chat được đánh dấu trong Available in.

Chọn nơi áp dụng skill

Skill mới bật sẵn và chỉ khả dụng trong Chat. Các khu vực khác giữ trạng thái tắt cho đến khi bạn bật, nên một quy tắc chưa kiểm thử kỹ không thể làm thay đổi các lượt review hay công việc xử lý sự cố.
1

Chọn skill

Trong More → Workspace settings → Skills, nhấn vào skill trong danh sách.
2

Đánh dấu các khu vực trong Available in

Đánh dấu từng nơi skill cần áp dụng:Để tạm dừng skill, hãy dùng công tắc thay vì bỏ đánh dấu mọi ô.
Review không có bộ lọc theo repository. Đánh dấu ô này sẽ áp dụng skill cho lượt review kế tiếp ở mọi repository. Hãy kiểm thử skill trong Chat trước, rồi làm theo bài kiểm thử Review trong Kiểm thử skill.
3

Xác nhận công tắc đang bật

Công tắc cạnh tên skill dùng để bật hoặc tắt skill. Skill bị tắt vẫn được lưu nhưng không agent nào dùng.

Kiểm thử skill

1

Chạy một việc mà quy tắc có tác dụng

Thử cả hai cách, mỗi cách trong một cuộc chat mới. Với ví dụ weekly-status-report trong tab Write skill instructions:Gọi theo tên (gõ / rồi chọn skill từ menu):
Chạy mà không gọi tên:
Hãy dán ghi chú như trên để agent có nội dung thật. Thiếu ghi chú hoặc công cụ theo dõi công việc đã kết nối, agent không có gì để báo cáo và có thể đặt câu hỏi ngược lại. Kết quả mong đợi gồm ba phần, Wins, Blockers và Next steps, mỗi phần một gạch đầu dòng kèm người phụ trách.Trạng thái thành công: hoạt động của agent hiển thị bước Load Skill, và cả hai câu trả lời đều theo skill (ở đây là bố cục wins, blockers, next steps) mà bạn không phải nhắc lại quy tắc.
2

Mở rộng khi skill đã chạy tốt

Sau vài kết quả tốt trong Chat, hãy đánh dấu Review, Incident hoặc Assessment và kiểm tra lượt chạy kế tiếp ở đó. Review không có môi trường thử riêng, nên hãy kiểm thử như sau:
  1. Đánh dấu Review.
  2. Mở một pull request nhỏ trong repository nháp mà Review đang theo dõi. Đừng mở dưới dạng draft: draft chỉ được review khi đánh dấu sẵn sàng. Hoặc bình luận @cloudthinker-ai review trên một pull request có sẵn.
  3. Kiểm tra lượt review có theo skill không. Nếu không, hãy bỏ đánh dấu Review ngay, vì mọi repository đều dùng skill khi ô này còn được đánh dấu.
Ứng dụng CloudThinker phải được cài trên repository đó; xem thiết lập Review và lệnh mention.
Nếu kết quả bỏ qua quy tắc, hãy viết quy tắc cụ thể hơn và thêm một ví dụ tốt và một ví dụ xấu. Chỉ dẫn mơ hồ kiểu “follow our style” hiếm khi làm thay đổi kết quả.

Sửa, tải xuống hoặc xóa skill

Chọn skill, rồi dùng các nút biểu tượng cạnh Available in. Di chuột lên từng nút để xem tên.
Xóa skill không hoàn tác được, và không có lịch sử phiên bản để quay lại sau khi sửa. Hãy tải file .zip xuống trước khi sửa hoặc xóa, hoặc tắt công tắc thay vì xóa nếu có thể bạn còn cần skill.
Audit Logs ghi lại ai đã tạo, tải lên, sửa, đổi phạm vi áp dụng hoặc xóa skill trong More → Workspace settings → Skills, nhưng chỉ trên gói Scale và Enterprise, và không ghi skill do agent lưu từ chat. Trên các gói khác, không có gì ghi lại thay đổi của skill, nên hãy lưu file .zip của mọi skill trong một repository và tải thay đổi lên từ đó.

Khắc phục sự cố

Một skill khác trong workspace đã dùng tên này. Hãy chọn tên khác, hoặc tải lên file .zip và chọn Replace để ghi đè skill có sẵn.
Tên này trùng với một skill tích hợp sẵn của CloudThinker, chẳng hạn pdf, docx hoặc deep-research. Hãy chọn tên khác.
Form cho phép gửi khi Description để trống, nhưng thao tác lưu sau đó thất bại với lỗi này. Thêm một câu nói khi nào dùng skill rồi nhấn Create lại. Nếu mô tả đã điền, nghĩa là kho lưu skill không chấp nhận file; hãy thử lại.
Đây là nguyên văn thông báo lỗi (executor là dịch vụ lưu file skill). Thường là do frontmatter của SKILL.md bị thiếu, không hợp lệ, hoặc thiếu name hay description. Xem khắc phục sự cố định dạng skill.
Thao tác tải lên chỉ chấp nhận .zip. Hãy đặt SKILL.md (và các thư mục scripts/, schemas/ hoặc references/ nếu có) vào một thư mục, nén thư mục đó thành zip rồi tải lên.
Thông báo này hiện dưới dạng cảnh báo trên bảng chi tiết của skill trong More → Workspace settings → Skills. Frontmatter SKILL.md của skill không có description dùng được, thường do một lần sửa thủ công đã xóa hoặc làm hỏng dòng description:. Sửa thủ công, thêm dòng description: rồi nhấn Save. Trước khi sửa xong, skill không xuất hiện trong menu /.
Không tải được nội dung file của skill. Nhấn Recovery with AI để dựng lại SKILL.md cùng CloudThinker qua một cuộc phỏng vấn ngắn, hoặc nhấn Re-upload để khôi phục từ file .zip bạn đã lưu (chẳng hạn file đã tải xuống trước đó).
  • Kiểm tra công tắc đang bật.
  • Kiểm tra đúng khu vực đã được đánh dấu trong Available in (ví dụ Review cho review pull request).
  • Viết hướng dẫn cụ thể và thêm ví dụ. Tách một skill dài, quá rộng thành nhiều skill ngắn.

Bước tiếp theo

Định dạng skill

Tổ chức SKILL.md, đặt frontmatter và viết quy tắc để agent làm theo.

Knowledge base

Cung cấp tài liệu tham khảo để agent tra cứu.

Lệnh

Chạy skill và prompt đã lưu từ menu /.

Custom agent

Tạo một agent cho một việc cụ thể và ghép với các skill của bạn.