Skip to main content
Skills là các package có thể tái sử dụng gồm hướng dẫn và các file hỗ trợ tùy chọn. Chúng cho phép nhóm của bạn định nghĩa một cách lặp lại được để hoàn thành một tác vụ chỉ một lần, sau đó áp dụng nó một cách nhất quán trên toàn Flowglad. Mỗi Skill có tên, slug slash-command, mô tả và hướng dẫn được viết bằng Markdown. Các file hỗ trợ có thể cung cấp thêm ngữ cảnh hoặc tài nguyên cần thiết để làm theo các hướng dẫn đó.

Dùng Flowglad làm thư viện Skill của nhóm

Flowglad lưu mỗi Skill dưới dạng một package có phiên bản. Việc publish một thay đổi sẽ tạo ra một revision mới thay vì thay thế package trước đó tại chỗ. Quản trị viên tổ chức có thể mở History của một Skill để kiểm tra các revision, so sánh thay đổi, khôi phục một revision trước đó hoặc hủy một bản nháp khi các thao tác đó khả dụng. Điều này mang lại cho nhóm của bạn một nơi được quản trị duy nhất để duy trì các hướng dẫn có thể tái sử dụng, đồng thời lưu giữ phiên bản nào đã được kích hoạt tại một thời điểm nhất định. Các revision nháp và bị từ chối không thay thế phiên bản đang hoạt động.

Quản lý Skills qua MCP

Sau khi bạn kết nối Flowglad MCP server, một agent có thể kiểm tra và quản lý thư viện Skill của tổ chức thay cho bạn:
  • skills.list trả về các Skill hiển thị với kết nối.
  • skills.get trả về metadata của revision mới nhất và revision đang hoạt động của một Skill.
  • skills.create gửi một package Skill mới.
  • skills.create_candidate gửi một revision mới của một Skill hiện có.
  • skills.publish_revision xác minh và publish một revision bị hoãn.
  • skills.create_package_upload_session và skills.finalize_package_upload_session truyền các package quá lớn để gửi inline.
  • skills.get báo cáo kết quả xác minh và promotion của request đã được chấp nhận.
Việc tạo hoặc cập nhật Skills yêu cầu quyền skills:write trên cả membership tổ chức của thành viên và grant của kết nối MCP. Nếu bạn thêm quyền sau khi kết nối server, hãy kết nối lại Flowglad MCP và cấp quyền skills:write để các công cụ ghi trở nên khả dụng. Quyền: Theo mặc định, Admin có quyền soạn thảo Skill. Để cấp cùng quyền đó cho một Contributor, hãy mở Settings → Team, chọn thành viên và bật Skill Authoring. Điều này cấp quyền tạo và cập nhật các Skill của tổ chức mà không biến thành viên đó thành admin.

Tải Flowglad MCP Skills vào agent của bạn

Flowglad MCP server quảng bá io.modelcontextprotocol/skills trong quá trình khởi tạo MCP. Điều này cho các client tương thích biết rằng server triển khai các phương thức Skill của agent là skills/list và skills/get. Mỗi Skill được trả về bao gồm các URI tài nguyên skill:// và digest nội dung; client có thể lấy các file bằng resources/read. Việc kết nối server không đảm bảo rằng client sẽ gọi skills/list hoặc cài đặt các package được trả về. Mức độ hỗ trợ của client khác nhau. Hãy thêm một hướng dẫn khởi động vào ChatGPT / Codex hoặc Claude khi bạn muốn agent làm mới registry của Flowglad vào đầu mỗi phiên. Đặt tên MCP: Các tên được cố ý đặt khác nhau. skills.list với dấu chấm là một công cụ Flowglad dành cho các bản ghi Skill có phiên bản của tổ chức. skills/list với dấu gạch chéo là một phương thức mở rộng giao thức MCP để khám phá các package Skill hướng tới agent.

Thêm hướng dẫn khởi động

Tạo thư mục đích một lần trước khi bắt đầu phiên mới, sau đó thêm khối hướng dẫn tương ứng bên dưới.

ChatGPT / Codex

Tạo thư mục đích cho ChatGPT / Codex bằng mkdir -p ~/.agents/skills. Đặt khối sau vào ~/.codex/AGENTS.md để áp dụng cho mọi dự án, hoặc vào AGENTS.md của một repository để chia sẻ với nhóm của repository đó.
AGENTS.md

Claude

Tạo thư mục đích cho Claude bằng mkdir -p ~/.claude/skills. Đặt khối sau vào ~/.claude/CLAUDE.md để áp dụng cho mọi dự án, hoặc vào CLAUDE.md của một repository để chia sẻ với nhóm của repository đó.
CLAUDE.md
Bạn có thể yêu cầu ChatGPT / Codex hoặc Claude thêm khối phù hợp vào file hướng dẫn cấp người dùng của chính nó. Hãy xem lại chỉnh sửa được đề xuất trước khi chấp nhận vì file đó ảnh hưởng tới các phiên trong tương lai. Hướng dẫn này là một cơ chế bootstrap agent theo kiểu best-effort; nếu môi trường của bạn phải làm mới Skills một cách xác định, hãy triển khai cùng cơ chế đồng bộ đó trong một hook SessionStart đáng tin cậy hoặc trong phần tích hợp MCP client của bạn.

Skills được sử dụng ở đâu

Skills hiện có hai nơi sử dụng:
  • Các agent bên ngoài tương thích khám phá và đồng bộ các package đã bật thông qua Flowglad MCP, sau đó tự động khớp chúng hoặc gọi chúng theo tên.
  • Automations ghim một revision Skill đã publish cụ thể dưới dạng tài nguyên mã OWS skill-revision. Automation chọn một đường dẫn package và entrypoint; các bước agent chỉ nhận được những Skill được cho phép bởi tập capability của lần chạy đã được niêm phong.
Đường thứ nhất cung cấp hướng dẫn có thể tái sử dụng cho một agent bên ngoài. Đường thứ hai cung cấp mã bất biến và các file hỗ trợ cho một lần chạy Automation có thể lặp lại. Các Skill đã publish có phạm vi toàn tổ chức, vì vậy một Automation được cấp quyền có thể chọn cùng một revision Skill trong bất kỳ Space nào. Automation sử dụng và các lần chạy của nó vẫn thuộc sở hữu của Space của chúng; việc chọn một Skill không thay đổi ranh giới đó.

Tạo và duy trì Skills

Mở organization menu → Skills → New Skill. Trong tab Skill, nhập Name, Slug, Description tùy chọn và các hướng dẫn có thể tái sử dụng trong Markdown. Dùng tab Files cho bất kỳ file package hỗ trợ nào, sau đó chọn Create Skill. Slug sử dụng chữ cái thường, chữ số và dấu gạch nối, bắt đầu bằng một chữ cái hoặc chữ số, và là nội dung người dùng gõ sau /. Việc tạo hoặc chỉnh sửa một Skill sẽ tạo ra một bản nháp. Trên trang chi tiết Skill, các chỉnh sửa được tự động lưu; chọn Publish Draft để xác minh và publish bản nháp. Nếu xác minh thất bại, hãy dùng thông tin chẩn đoán được hiển thị để sửa bản nháp và publish lại. Dùng History để kiểm tra các revision, khôi phục một revision đã bị thay thế hoặc hủy một bản nháp có thể thay đổi khi các thao tác đó khả dụng. Disable Skill loại bỏ nó khỏi việc khám phá của agent bên ngoài và việc phân giải của Automation mà không xóa lịch sử revision; Enable Skill làm cho nó khả dụng trở lại.

Tạo hoặc chỉnh sửa Skill bằng MCP

Dùng một MCP client bên ngoài đã kết nối để soạn thảo theo hướng package-first. Gọi skills.get trước khi chỉnh sửa một Skill hiện có. Dùng skills.create cho một package mới hoặc skills.create_candidate cho một revision dựa trên revision đang hoạt động hiện tại. Các package nhỏ có thể được cung cấp inline. Đối với các package lớn hơn, hãy gọi skills.create_package_upload_session, tải lên các object được yêu cầu và hoàn tất bằng skills.finalize_package_upload_session. Nếu việc xác minh bị hoãn, hãy gọi skills.publish_revision. Poll skills.get để lấy lifecycle request đã được chấp nhận và kết quả xác minh hoặc promotion của nó. Việc publish một Skill không tạo, sửa đổi hay kích hoạt một Automation; hãy sử dụng vòng đời Automation MCP một cách rõ ràng khi cần.

Bắt đầu từ một Skill template

Trang Skills bao gồm Skill Templates. Tìm kiếm hoặc lọc danh mục, xem trước một template và chọn Copy Skill. Bản sao trở thành một Skill của tổ chức có thể được chỉnh sửa và publish như bất kỳ Skill nào khác.

Skills và Automations

Một Skill định nghĩa cách thực hiện công việc có thể tái sử dụng. Nó không quyết định khi nào công việc đó chạy. Hãy dùng một Automation khi công việc cần chạy thủ công, theo lịch hoặc để phản hồi một sự kiện. Một Automation có thể ghim một hoặc nhiều revision Skill để cùng một bản triển khai được tái sử dụng qua các lần chạy.