Mọi nhóm đã áp dụng AI coding agent đều có một lập trình viên mà prompt của người đó cứ thế mà chạy đúng. Yêu cầu review của họ trả về đúng cấu trúc mà nhóm mong muốn. Hướng dẫn viết test của họ tạo ra test khớp với phong cách chung ngay từ lần đầu. Hỏi họ bí quyết, câu trả lời thường là một tệp nháp, một repo dotfiles, hoặc một đoạn văn họ dán vào phiên làm việc mới mỗi sáng. Tay nghề là thật. Vấn đề nằm ở chỗ nó đang trú ngụ.
Kỹ thuật viết prompt chỉ nằm trong đầu một người thì không thể mở rộng, không tồn tại qua những kỳ nghỉ, và không xuất hiện trong các lượt chạy agent của người khác. Khi lập trình viên đó vắng mặt, chất lượng tụt giảm. Khi nhóm mở rộng từ một agent lên năm agent, năm agent đó không thống nhất với nhau về cách thực hiện công việc.
Skill chính là câu trả lời của Sharkly cho khoảng trống đó. Một Skill đóng gói các hướng dẫn và tệp hỗ trợ có thể tái sử dụng cho công việc của Agent, kèm theo người sở hữu, phạm vi và quyền hạn rõ ràng. Nếu bạn muốn nắm khái niệm tổng quát trước, bài coding agent Skill là gì sẽ trình bày định nghĩa và hệ sinh thái rộng hơn. Còn bài viết này nói về quy trình làm việc bên trong chính Sharkly.
TL;DR
Một Skill trong Sharkly đóng gói các hướng dẫn và tệp hỗ trợ có thể tái sử dụng cho công việc của Agent: quy tắc review, checklist bàn giao, tiêu chuẩn viết, một quy trình của nhóm. Bạn có thể tạo từ đầu, cài một Skill đã được công bố từ nguồn công khai được hỗ trợ, nhập một Skill do Runtime cục bộ phát hiện, hoặc tải lên tệp SKILL.md, tệp .skill hay gói zip. Mỗi Skill có đúng một phạm vi — Organization, Space hoặc Agent — được chọn ngay khi tạo và cố định vĩnh viễn. Agent gán các Skill đủ điều kiện thông qua phần cài đặt Skills của mình, thay đổi chỉ áp dụng cho các lượt chạy sau, và quyền chỉnh sửa thuộc về người tạo, Chủ sở hữu Organization và Quản trị viên. Kết quả: kỹ thuật viết prompt không còn nằm trong dotfiles của một lập trình viên nữa mà trở thành hạ tầng dùng chung của cả nhóm, được kiểm soát bằng quyền.
Điều gì thay đổi khi kỹ thuật viết prompt có một mái nhà
Khác biệt giữa một prompt tốt và một Skill không nằm ở phần văn bản, mà ở mọi thứ xung quanh nó.
Một prompt trong tệp nháp không có người sở hữu, không có đối tượng sử dụng và không có vòng đời. Không ai biết nó tồn tại, không ai biết bản copy họ tìm thấy trên Slack có còn mới hay không, và không ai chịu trách nhiệm cập nhật nó khi quy trình thay đổi. Một Skill có đủ cả ba. Nó thuộc về một tổ chức. Phạm vi của nó quy định rõ những Agent nào được phép dùng. Quyền chỉnh sửa quy định rõ ai được phép thay đổi. Khi quy trình thay đổi, bạn chỉ cần cập nhật Skill một lần, và các lượt chạy sau đó của mọi Agent đã gán sẽ tự động nhận thay đổi.
Đó chính là luận điểm về đòn bẩy ở dạng thu nhỏ. Đòn bẩy của nhóm không đến từ việc mở thêm nhiều cuộc trò chuyện AI, mà đến từ việc chia sẻ vai trò, quy tắc, ngữ cảnh và quy trình làm việc. Và vì Agent trả kết quả về Task, đầu ra của một lượt chạy có Skill dẫn dắt sẽ nằm trong hồ sơ chung để cả nhóm xem xét.
Một ranh giới cần rõ trước khi bàn đến quy trình. Skill không phải là yêu cầu của Task. Hãy để những yêu cầu dùng một lần trong phần mô tả hoặc bình luận của Task. Nếu chỉ Task này cần, đó là ngữ cảnh. Nếu các lượt chạy tháng sau cũng cần, đó là hạ tầng.
Tạo một Skill từ đầu
Một Skill bắt đầu với ba thứ: tên, mô tả và hướng dẫn. Sự tách biệt này quan trọng hơn vẻ ngoài của nó.
Phần mô tả nêu rõ khi nào Agent nên dùng Skill. Đây là điều kiện kích hoạt — câu nói cho một Agent đang quét danh sách năng lực của mình biết rằng Skill này phù hợp với công việc trước mắt. Phần hướng dẫn định nghĩa quy trình có thể lặp lại và đầu ra mong đợi: các bước, các bước kiểm tra, định dạng mà kết quả cần tuân theo. Một phép thử hữu ích là bạn có thể diễn đạt trong một câu khi nào Agent nên dùng đến Skill này hay không. Nếu không làm được, có lẽ bạn đang nhìn vào hai Skill, hoặc không có Skill nào cả.
Bên trong, phần hướng dẫn chính nằm trong tệp SKILL.md: hai trường YAML name và description ở đầu, tiếp theo là phần hướng dẫn. Các tệp hỗ trợ có thể đi kèm để cung cấp template, ví dụ hoặc dữ liệu tham chiếu. Một Skill về checklist bàn giao có thể mang theo template checklist; một Skill viết migration có thể kèm hai ví dụ có chú thích. Hãy giữ chúng tập trung. Những bộ tệp lớn hoặc không liên quan chỉ thêm ngữ cảnh mà không cải thiện quyết định của Agent.
Nhập kỹ thuật bạn đã có sẵn
Hầu hết các nhóm không bắt đầu từ con số không. Kỹ thuật viết prompt đã tồn tại, chỉ là nó nằm rải rác. Sharkly mang đến ba cách nhập.
Cài đặt từ một nguồn công khai được hỗ trợ. Sharkly có thể lấy một Skill đã được công bố và tạo một bản sao được quản lý trong phạm vi bạn chọn. Bản sao được quản lý này rất quan trọng: bạn không liên kết tới tệp của người khác, mà đang tạo một bản chụp do tổ chức của bạn kiểm soát. Hãy xem xét nguồn và nội dung đã nhập trước khi gán nó cho bất kỳ Agent nào. Hãy coi hướng dẫn từ bên ngoài như code của bên thứ ba, chứ không phải chính sách đáng tin của tổ chức.
Nhập từ Runtime cục bộ. Đây chính là con đường được thiết kế riêng cho vấn đề dotfiles. Một Runtime cục bộ đang online có thể báo cáo các Skill phát hiện được trong thư mục Skill cục bộ của nó, nghĩa là những kỹ thuật mà một lập trình viên âm thầm tích lũy sẽ trở nên hiển thị với cả tổ chức. Việc nhập sẽ sao chép Skill vào tổ chức; bản gốc cục bộ vẫn tách biệt, nên không có gì trong thiết lập của lập trình viên đó bị phá vỡ. Một lưu ý để giữ mọi thứ minh bạch: những Skill cục bộ mà Runtime của Agent truy cập trực tiếp được thì hoàn toàn không cần gán trong sản phẩm. Chỉ nhập khi nó cần trở thành một Skill có thể tái sử dụng, được quản lý với phạm vi rõ ràng, chứ không phải chỉ vì nó tồn tại.
Tải lên một gói. Nếu Skill nằm trong một repo hoặc đến từ đồng nghiệp, hãy tải lên tệp SKILL.md, tệp .skill hoặc gói zip. Sharkly kiểm tra những gì được đưa vào: đường dẫn tệp phải là đường dẫn tương đối và không được vượt ra ngoài Skill; thao tác tải lên và nhập sẽ từ chối các đường dẫn ẩn hoặc nhạy cảm, nội dung nhị phân không được hỗ trợ, mục lưu trữ không an toàn, đường dẫn trùng lặp và các gói vượt giới hạn của dịch vụ. Skill là những hướng dẫn mà Agent sẽ tuân theo; nó xứng đáng được soi xét kỹ càng như một dependency.
Phạm vi: quyết định ai được dùng một Skill
Mỗi Skill thuộc về một tổ chức và có đúng một phạm vi, được chọn khi tạo. Phạm vi quyết định những Agent nào có thể gán nó, và không thể thay đổi sau đó.
| Phạm vi | Ai có thể dùng | Chọn khi nào | Quy tắc gán |
|---|---|---|---|
| Organization | Các Agent đủ điều kiện trong toàn tổ chức | Quy trình thực sự áp dụng cho toàn công ty, như tiêu chuẩn review hay checklist bảo mật | Bất kỳ Agent nào trong cùng tổ chức đều có thể gán |
| Space | Các Agent gắn với Space đó | Một nhóm hoặc một mảng sản phẩm sở hữu quy trình này | Agent không thể gán nó trừ khi Agent thuộc Space đó |
| Agent | Chỉ một Agent duy nhất | Năng lực này định hình vai trò của một chuyên gia duy nhất | Được gán cho Agent đích ngay khi tạo hoặc nhập |
Nguyên tắc trong tài liệu là đúng: hãy chọn phạm vi hẹp nhất phù hợp với đối tượng dự kiến. Phạm vi cũng là mức độ ảnh hưởng. Một Skill ở phạm vi Space mà lỗi thời sẽ khiến Agent của một nhóm bối rối; còn ở phạm vi Organization thì khiến tất cả bối rối. Một prompt trong dotfiles mãi mãi chỉ có một người dùng. Còn đối tượng của một Skill là quyết định có chủ đích, được ghi lại trong hệ thống.
Gán Skill cho Agent
Một Skill chẳng làm gì cả cho đến khi được một Agent mang theo. Trong Sharkly, một Agent là một cấu hình làm việc đã lưu, và việc gán Skill sẽ bổ sung một năng lực cho nó.
Cách thực hiện khá đơn giản. Dùng phần cài đặt Skills của Agent để thêm hoặc bớt các Skill đủ điều kiện, hoặc chọn Skill ngay khi tạo Agent. Điều kiện đủ tuân theo các quy tắc phạm vi. Thay đổi áp dụng cho các lượt chạy Agent sau đó, nên khi bạn gán thêm một Skill hôm nay, nó sẽ định hình công việc của ngày mai mà không làm xáo trộn bất kỳ thứ gì đang chạy.
Câu hỏi cần phán đoán là một Agent nên mang bao nhiêu Skill. Tài liệu nói thẳng: tránh gán nhiều Skill chồng chéo nhau, vì những hướng dẫn xung đột hoặc trùng lặp khiến việc thực thi khó đoán định hơn. Hai Skill sắc bén vẫn hơn sáu Skill cãi nhau. Nếu danh sách Skill của một Agent trông như ngăn kéo đồ linh tinh, thì các lượt chạy của nó cũng vậy.
Cũng có sự phân công giữa hướng dẫn riêng của Agent và các Skill của nó. Hướng dẫn của Agent mang những hành vi ổn định cho vai trò đó: phạm vi, khi nào cần hỏi con người, định dạng báo cáo. Một quy trình có thể tái sử dụng mà nhiều Agent cùng chia sẻ thì nên nằm trong một Skill. Khi bạn thấy mình đang dán cùng một đoạn văn vào hướng dẫn của Agent thứ ba, đoạn văn đó đang muốn trở thành một Skill.
Việc gán Skill chính là thứ giúp phần còn lại của nền tảng tạo hiệu ứng cộng dồn. Cũng chính Agent mang Skill review của bạn là Agent mà Automations kích hoạt theo lịch hoặc theo thay đổi trạng thái, nhờ đó một tiêu chuẩn được ghi lại một lần sẽ xuất hiện trong các lượt chạy định kỳ mà không ai phải khởi động thủ công. Skill cũng có thể dùng qua script: CLI cung cấp sharkly skill list và sharkly skill view với đầu ra JSON.
Quản trị: ai chỉnh sửa, ai xóa, ai review
Năng lực dùng chung cần sự kiểm soát chung, và đây là điểm Skill khác biệt rõ nhất so với các tệp prompt.
Một Skill có thể được chỉnh sửa hoặc xóa bởi người tạo, Chủ sở hữu Organization hoặc Quản trị viên. Với Skill ở phạm vi Space, còn cần quyền ghi vào Space đó. Việc tạo hoặc nhập một Skill ở phạm vi Agent, cũng như thay đổi các gán Skill của Agent, đòi hỏi quyền quản lý Agent đích. Không ai âm thầm viết lại tiêu chuẩn review vào một buổi chiều thứ Sáu.
Việc bảo trì cũng theo đúng nguyên tắc một nơi duy nhất. Khi quy trình thay đổi, hãy cập nhật hướng dẫn và tệp hỗ trợ của Skill, các lượt chạy sau đó sẽ dùng phiên bản mới. Xóa là thao tác cần chậm lại: nó gỡ Skill khỏi mọi Agent đang dùng, nên hãy kiểm tra các gán hiện tại trước.
Các quy tắc bảo mật ngắn gọn và không thể thương lượng. Không bao giờ lưu mật khẩu, access token, private key hay bất kỳ bí mật nào khác trong hướng dẫn hoặc tệp hỗ trợ của Skill. Hãy xem xét mọi Skill nhập từ bên ngoài hoặc từ cục bộ trước khi dùng. Giữ các lệnh và ví dụ ở mức quyền tối thiểu. Và kiểm tra lại các gán sau khi thay đổi liên kết Space của Agent hoặc nội dung của Skill, vì điều kiện đủ có thể thay đổi dưới một gán.
Xuyên suốt tất cả những điều này, giao kèo giữa người và agent vẫn giữ nguyên. Agent nạp Skill, tuân theo quy trình và trả kết quả về Task. Con người quyết định Skill nào mang thẩm quyền của nhóm. Skill nâng mức sàn về tính nhất quán. Nó không loại bỏ người review.
Khi nào không nên tạo Skill
Skill là hạ tầng, mà hạ tầng thì có chi phí duy trì. Cặp quyết định trung thực: giữ các yêu cầu dùng một lần trong mô tả hoặc bình luận của Task; tạo Skill khi cùng một năng lực cần có mặt trong các lượt chạy về sau.
Thêm vài trường hợp mà câu trả lời đúng là không tạo Skill. Nếu một quy trình nằm trong thư mục Skill của Runtime cục bộ và chỉ các lượt chạy của Computer đó cần, hãy để nó ở cục bộ. Nếu hai Skill ứng viên chồng chéo nhiều trên cùng một Agent, hãy gộp hoặc mài sắc chúng trước khi gán bất kỳ cái nào. Và nếu bạn không viết nổi câu mô tả, quy trình đó chưa đủ ổn định để đúc kết lại.
Bắt đầu với một quy trình
Hãy chọn một quy trình mà nhóm bạn lặp lại và âm thầm phụ thuộc vào một người. Viết nó thành một Skill hẹp duy nhất: tên, mô tả nêu rõ khi nào áp dụng, hướng dẫn định nghĩa quy trình và đầu ra mong đợi. Đặt phạm vi cho Space của bạn. Gán nó cho một Agent, giao cho Agent đó một Task thật, rồi đọc kết quả trả về.
Vòng lặp chỉ có vậy. Kỹ thuật từng nằm trong đầu một lập trình viên giờ đã có tên, có phạm vi, có người sở hữu và một nơi duy nhất để cập nhật. Nếu bạn mới làm quen với nền tảng, bài tổng quan về Sharkly giải thích cách Skill song hành cùng Task, Agent và Computer, còn bắt đầu với Sharkly sẽ dẫn bạn qua kết nối đầu tiên từ đầu đến cuối. Tài liệu về Skills trình bày đầy đủ mọi quy tắc ở trên.
Câu hỏi thường gặp
Skill khác gì so với hướng dẫn của Agent?
Hướng dẫn của Agent định nghĩa hành vi ổn định cho một vai trò: phạm vi, khi nào cần hỏi ý kiến, cách báo cáo. Skill là một quy trình tái sử dụng mà nhiều Agent có thể chia sẻ, được đóng gói cùng tệp hỗ trợ và quyền hạn riêng. Nếu một đoạn văn đang bị sao chép qua lại giữa các Agent, nó thuộc về một Skill.
Tôi có thể thay đổi phạm vi của Skill sau khi tạo không?
Không. Phạm vi của Skill được cố định ngay khi tạo. Khi cần thay đổi đối tượng sử dụng, hãy tạo một Skill mới ở phạm vi phù hợp và gán lại cho những Agent cần đến. Đó là lý do tài liệu khuyến nghị chọn ngay từ đầu phạm vi hẹp nhất phù hợp với đối tượng dự kiến.
Skill đã nhập có tự đồng bộ với nguồn không?
Không. Cài đặt từ một nguồn công khai được hỗ trợ sẽ tạo một bản sao được quản lý trong phạm vi bạn chọn, còn nhập từ Runtime cục bộ sẽ sao chép Skill vào tổ chức trong khi bản gốc cục bộ vẫn tách biệt. Từ đó trở đi, tổ chức của bạn kiểm soát bản sao của mình.
Việc gán một Skill mới có ảnh hưởng đến các Task đang chạy của Agent không?
Không. Thay đổi đối với các gán Skill của Agent chỉ áp dụng cho những lượt chạy sau đó. Công việc đang chạy sẽ hoàn thành với cấu hình lúc bắt đầu, và lượt chạy kế tiếp sẽ nhận bộ Skill đã cập nhật.
Cài Skill từ nguồn công khai có an toàn không?
Có thể an toàn, nếu bạn xem xét kỹ. Hãy coi mọi Skill từ bên ngoài hoặc nhập từ cục bộ như code hay cấu hình của bên thứ ba: đọc hướng dẫn và tệp hỗ trợ trước khi gán, giữ lệnh ở mức quyền tối thiểu, và tuyệt đối không để bí mật lọt vào Skill. Tính năng kiểm tra khi tải lên của Sharkly sẽ từ chối những đường dẫn và mục lưu trữ không an toàn, nhưng việc phán đoán liệu những hướng dẫn đó có xứng đáng được nhóm bạn tin tưởng vẫn thuộc về con người.
