Skip to main content
Skills 是由指令和可选支持文件组成的可复用包。借助 Skills，您的团队只需定义一次完成某项任务的可重复方式，即可在整个 Flowglad 中一致地加以应用。 每个 Skill 都有名称、斜杠命令 slug、描述以及用 Markdown 编写的指令。支持文件可以提供遵循这些指令所需的额外上下文或资源。

​
将 Flowglad 用作团队的 Skill 库

Flowglad 将每个 Skill 作为带版本的包进行保存。发布更改会创建一个新的修订版本，而不是就地替换之前的包。组织管理员可以打开 Skill 的 History，在相应操作可用时查看其修订版本、比较更改、恢复较早的修订版本或丢弃草稿。 这为您的团队提供了一个统一受管的位置来维护可复用指令，同时保留在任意给定时间哪个版本处于活跃状态的记录。草稿和被拒绝的修订版本不会替换活跃版本。

​
通过 MCP 管理 Skills

连接 Flowglad MCP server 后，agent 可以替您查看和管理组织的 Skill 库：
  • skills.list 返回对该连接可见的 Skills。
  • skills.get 返回某个 Skill 的最新修订版本和活跃修订版本的元数据。
  • skills.create 提交一个新的 Skill 包。
  • skills.create_candidate 为现有 Skill 提交一个新的修订版本。
  • skills.publish_revision 验证并发布一个延迟的修订版本。
  • skills.create_package_upload_session 和 skills.finalize_package_upload_session 用于传输过大而无法内联发送的包。
  • skills.get 报告已接受请求的验证和提升结果。
创建或更新 Skills 需要团队成员的组织 membership 和 MCP 连接的授权同时具有 skills:write 权限。如果您在连接 server 之后才添加该权限，请重新连接 Flowglad MCP 并授权 skills:write，以便写入工具可用。 权限： Admin 默认拥有 Skill 编写权限。要为 Contributor 授予相同的权限，请打开 Settings → Team，选择该团队成员，然后启用 Skill Authoring。这样无需将该团队成员设为管理员，即可授予其创建和更新组织 Skills 的权限。

​
将 Flowglad MCP Skills 加载到您的 agent 中

Flowglad MCP server 在 MCP 初始化期间会声明 io.modelcontextprotocol/skills。这会告知兼容的客户端，该 server 实现了 agent Skill 方法 skills/list 和 skills/get。每个返回的 Skill 都包含 skill:// 资源 URI 和内容摘要；客户端可以使用 resources/read 获取文件。 连接 server 并不保证客户端会调用 skills/list 或安装返回的包。客户端支持情况各不相同。如果您希望 agent 在每次会话开始时刷新 Flowglad 注册表，请向 ChatGPT / Codex 或 Claude 添加一条启动指令。 MCP 命名： 这些名称是有意区分的。带点号的 skills.list 是用于组织带版本 Skill 记录的 Flowglad 工具。带斜杠的 skills/list 是用于发现面向 agent 的 Skill 包的 MCP 协议扩展方法。

​
添加启动指令

在开始新会话之前先创建一次目标目录，然后添加下方对应的指令块。

​
ChatGPT / Codex

使用 mkdir -p ~/.agents/skills 创建 ChatGPT / Codex 目标目录。 将以下代码块放入 ~/.codex/AGENTS.md 以应用于所有项目，或放入某个仓库的 AGENTS.md 以与该仓库的团队共享。
AGENTS.md

​
Claude

使用 mkdir -p ~/.claude/skills 创建 Claude 目标目录。 将以下代码块放入 ~/.claude/CLAUDE.md 以应用于所有项目，或放入某个仓库的 CLAUDE.md 以与该仓库的团队共享。
CLAUDE.md
您可以让 ChatGPT / Codex 或 Claude 将相应的代码块添加到其自身的用户级指令文件中。由于该文件会影响之后的会话，请在接受之前审阅拟议的修改。该指令是一种尽力而为的 agent 引导方式；如果您的环境必须以确定性的方式刷新 Skills，请在受信任的 SessionStart hook 或您的 MCP 客户端集成中实现相同的同步逻辑。

​
Skills 的使用场景

Skills 目前有两类使用方：
  • 兼容的外部 agent 通过 Flowglad MCP 发现并同步已启用的包，然后自动匹配或按名称调用它们。
  • Automations 将某个确切的已发布 Skill 修订版本固定为 OWS skill-revision 代码资源。Automation 选择一个包路径和入口点；agent 步骤只会收到经密封运行能力集授权的 Skills。
第一种方式为外部 agent 提供可复用的指令。第二种方式为可重复的 Automation 运行提供不可变的代码和支持文件。已发布的 Skills 在整个组织范围内可用，因此获得授权的 Automation 可以在任何 Space 中选择同一个 Skill 修订版本。使用该 Skill 的 Automation 及其运行仍归属于各自的 Space；选择某个 Skill 不会改变这一边界。

​
创建和维护 Skills

打开 organization menu → Skills → New Skill。在 Skill 标签页中，输入 Name、Slug、可选的 Description，并在 Markdown 中输入可复用的指令。使用 Files 标签页添加任何支持性的包文件，然后选择 Create Skill。 Slug 使用小写字母、数字和连字符，以字母或数字开头，是用户在 / 之后输入的内容。 创建或编辑 Skill 会生成一个草稿。在 Skill 详情页上，编辑会自动保存；选择 Publish Draft 以验证并发布草稿。如果验证失败，请根据显示的诊断信息修正草稿，然后重新发布。 在相应操作可用时，使用 History 查看修订版本、恢复已被取代的修订版本或丢弃可变草稿。Disable Skill 会将其从外部 agent 发现和 Automation 解析中移除，但不会删除修订历史；Enable Skill 会使其再次可用。

​
使用 MCP 创建或编辑 Skill

使用已连接的外部 MCP 客户端进行以包为先的编写。在编辑现有 Skill 之前先调用 skills.get。对于新包使用 skills.create，对于基于当前活跃修订版本的新修订版本使用 skills.create_candidate。 小型包可以内联提供。对于较大的包，请调用 skills.create_package_upload_session，上传所请求的对象，然后以 skills.finalize_package_upload_session 结束。如果验证被延迟，请调用 skills.publish_revision。轮询 skills.get，以获取已接受的生命周期请求及其验证或提升结果。 发布 Skill 不会创建、修订或激活 Automation；需要时请显式使用 Automation MCP 生命周期。

​
从 Skill 模板开始

Skills 页面包含 Skill Templates。搜索或筛选目录、预览模板，然后选择 Copy Skill。副本会成为一个组织 Skill，可以像其他 Skill 一样进行编辑和发布。

​
Skills 与 Automations

Skill 定义如何执行可复用的工作，但并不决定这些工作何时运行。 当工作需要手动运行、按计划运行或响应某个事件运行时，请使用 Automation。Automation 可以固定一个或多个 Skill 修订版本，以便在多次运行中复用相同的实现。