使用 AI 机器人技能

Gisia 提供机器可读的技能（Skill）文件，让 AI 机器人能够通过 API 理解并操作你的项目。本指南将带你把机器人连接到项目，并让它替你执行真实的 DevOps 任务。

什么是技能？

每个项目都在可预测的 URL 上提供一组 Markdown 技能文件：

  • /-/skill.md — 项目概览、认证方式以及可用技能
  • /-/users/skill.md — 当前用户及其身份和访问权限
  • /-/issues/skill.md — 如何列出、创建、更新和关闭议题
  • /-/epics/skill.md — 如何管理史诗（Epic）
  • /-/labels/skill.md — 如何管理标签
  • /-/branches/skill.md — 如何管理分支
  • /-/tags/skill.md — 如何管理标签（Tag）
  • /-/merge_requests/skill.md — 如何创建和管理合并请求
  • /-/pipelines/skill.md — 如何运行和查看 CI 流水线
  • /-/jobs/skill.md — 如何查看和控制 CI 作业
  • /-/members/skill.md — 如何管理项目成员
  • /-/comments/skill.md — 如何在议题、史诗和合并请求上发表评论，以及通过草稿评论提交合并请求评审

当你把技能 URL 发送给机器人时，它会读取该文件，学习如何通过 Gisia REST API 与你的项目交互。

第 1 步 — 准备你的 AI 机器人

你需要一个能抓取 URL 并调用 REST API 的机器人。OpenClaw 是一个很好的起点，可以直接配合 Gisia 技能文件使用。

按照机器人自身的安装指南安装并启动它，运行起来后再回到这里。

第 2 步 — 创建项目

  1. 访问 /-/dashboard/projects
  2. 点击 New Project

新项目会以空仓库开始，可以立即使用。

第 3 步 — 创建个人访问令牌

机器人需要一个令牌来向 Gisia API 认证，并用于克隆或推送仓库。

  1. 访问 /-/users/settings/personal_access_tokens
  2. 点击 New token
  3. 输入一个名称（例如 my-bot）
  4. 勾选 API 作用域
  5. 点击 Create personal access token
  6. 复制令牌

第 4 步 — 把技能指令发送给机器人

在新项目页面上你会看到一个 AI Skill 区块。它包含一条现成的指令，可以直接复制粘贴到机器人的聊天窗口。

对于私有项目，它看起来像这样：

Read the project skill and follow the instructions by running:
`curl -s https://your-instance/-/skill.md -H "PRIVATE-TOKEN: YOUR_PERSONAL_ACCESS_TOKEN"`

将 YOUR_PERSONAL_ACCESS_TOKEN 替换为你刚创建的令牌，然后把消息发送给机器人。

第 5 步 — 让机器人克隆仓库并推送 README

“按照项目 skill.md 的说明，使用个人访问令牌克隆仓库并推送一个 README。”

刷新项目页面即可验证结果 — README 应该会出现在文件浏览器中。

第 6 步 — 创建带议题和标签的史诗

现在让机器人来组织一些工作：

“创建一个名为 ‘Initial setup’ 的史诗，然后在它下面创建两个议题”

完成后，你可以直接在项目中查看该史诗及其关联的议题。

第 7 步 — 在议题上发表评论

技能同样可以处理讨论：

“在第一个议题上留下一条评论，总结需要完成的工作，得到回复后将其标记为已解决。”

机器人会读取 /-/comments/skill.md，学习如何在议题、史诗和合并请求上列出、创建、回复和解决评论。在合并请求上，它还可以创建草稿评论并将它们作为一次评审统一发布。

想自定义内置技能提供给机器人的内容？请查看覆盖项目技能。