企业官网建设流程全解析

AgentRQ 是一款自托管（Self-hosted）的人机协同实时任务管理器，可管理你的 AI Agent。它的Skills 技能系统允许把团队的"Agent 工作手册"沉淀成标准技能包，并从 GitHub 一键导入，让所有 Agent 在任务匹配时自动加载执行。本文带你完整走通：技能格式、GitHub 导入步骤、双开关管理与 MCP 工具调用。

什么是 AgentRQ Skills 技能系统？

在 AgentRQ 中，Skill（技能）= Agent 的 playbook（工作手册）：当任务匹配某个技能时，Agent 会自动加载它。一个技能就是一个目录，核心文件是SKILL.md，可以附带参考资料、提示词和脚本。

✨ 好消息：这套格式与 Claude Code、Antigravity 完全一致，为它们写好的技能可以直接在 AgentRQ 中使用。

一个最小技能长这样：

--- name: pr-reviewer description: Use when reviewing a pull request, before leaving any comments. --- # Reviewing a pull request 1. Read the description, then `references/checklist.md`. 2. Run the tests before commenting on style.

三个要点：

完整规范见官方文档 docs/SKILLS.md。

从 GitHub 一键导入技能：3 步完成

这是 Skills 系统最实用的功能：团队把技能库托管在 GitHub 上，成员在 AgentRQ 里粘贴链接即可导入，无需 clone 仓库。

导入入口：侧边栏的Skills页面，或任意工作区的Settings → Skills（从工作区进入时，当前工作区已自动勾选）。

第 1 步：粘贴公开 GitHub 链接

在Import from GitHub输入框中粘贴链接，支持以下 4 种形式（对应界面代码 SkillsPanel.vue）：

https://github.com/obra/superpowers https://github.com/obra/superpowers.git https://github.com/obra/superpowers/tree/main https://github.com/obra/superpowers/tree/main/skills/systematic-debugging

前 3 种导入整个仓库的技能，第 4 种只导入某一个技能子目录，适合技能库很大的场景。

第 2 步：勾选要启用的工作区

在 "Turn on in" 区域勾选技能导入后要在哪些工作区生效。技能本身属于账户，勾选的工作区只是打开它的开关。

第 3 步：点击 Import，查看导入报告

导入完成后会显示import report（导入报告）：成功导入的技能列表，以及每个被跳过文件的具体原因，例如：

• SKILL.md超过 96 KiB → 跳过整个技能
• 二进制文件、符号链接、隐藏文件 → 跳过
• 没有任何文件引用它 → 不保留
• 名称已被账户中现有技能占用

📌文件保留规则：技能目录下所有 Markdown 文件（README.md、CLAUDE.md等仓库元文件除外）都会被保留；其他文件只有被SKILL.md或已保留文件引用到时才会保留——避免把脚本、二进制等 Agent 用不到的东西塞进来。

仓库太大怎么办？按需挑选技能

如果仓库压缩后超过20 MB（或解压后超 64 MB），AgentRQ 不会整体导入，而是列出仓库里的全部候选技能（附每个SKILL.md的大小，超限的会置灰并标注原因）。你只需勾选需要的技能，点击Import selected，系统只下载所选技能的文件。

这个"候选列表 + 按需下载"机制由后端 skillimport.go 实现：它下载一个 tarball 而非逐文件调用 GitHub API（未认证 API 每小时仅 60 次），并且从不直接请求用户粘贴的 URL——只从 owner/repo/ref 自行构造下载地址，从源头规避 SSRF 风险。

勾选Overwrite skills you already have可覆盖同名技能：原有工作区开关保持不变，新勾选的工作区会被打开。

导入后如何管理：账户 + 工作区双开关

每个技能有两级开关，控制"谁能看到它"：

⚠️ 注意两点：

• 一个技能全局只有一份：无论在哪个工作区编辑，改动对所有开启它的工作区生效，不是副本
• Fork 工作区直接沿用父工作区的开关，无需重复配置
• 技能页的Delete会从账户彻底删除技能，所有工作区都会失去它

阅读技能文件与 skill:// 地址

打开某个技能会进入它的专属页面（SkillPage.vue）：

• 左侧文件树列出技能的全部文件，默认展示SKILL.md
• 正文中的引用可以直接点击跳转：skill://…链接、相对路径链接，或恰好命名了技能文件的行内代码（如`references/checklist.md`）
• 面包屑显示当前位置，Back返回上一份文件

所有文件都有全局地址skill://<name>/<path>，例如skill://systematic-debugging/SKILL.md；skill://<name>单独使用则指向该技能的SKILL.md。

让 Agent 自己发现技能：4 个 MCP 工具

每个工作区都运行一个 MCP 服务器，Agent 通过它使用技能（工具定义见 skill_store.go）：

🤖 Agent 被明确要求：任务开始时先调skills.search，任务匹配哪个技能就skills.load哪个。也就是说，导入的技能会真正被 Agent 用起来，而不是躺在库里。

安全边界也值得注意：Agent 的skills.delete只能影响自己的工作区，无法把技能从别的工作区拿走——"要不要全局下线"始终是人类（你）的决定。

技能限制速查表

💡 任何超限内容都会被整体拒绝（不会静默截断），错误信息会告诉你具体该改什么。

常见问题

Q：导入的技能能跨工作区共享吗？能。技能归属账户，各工作区只是开关。在任意工作区编辑一次，所有工作区看到的都是同一份。

Q：Agent 可以帮我写技能吗？可以。让 Agent 调用skills.save写入SKILL.md即可创建新技能，这是"团队手册持续沉淀"的关键闭环。

Q：REST API 也能查技能吗？可以。GET /api/v1/skills?q=&limit=&offset=返回账户技能及各自开启的工作区列表；GET /api/v1/workspaces/{id}/skills返回指定工作区视角的技能（接口见 skill.go）。

小结

AgentRQ 的 Skills 技能系统把"团队 Agent 工作手册"变成了一等公民：标准格式兼容 Claude Code 生态、GitHub 链接一键导入、大仓库按需挑选、账户/工作区双开关精细授权，Agent 还能通过 MCP 工具自动发现、加载甚至创建技能。如果你的团队已经积累了 Agent 提示词和流程文档，现在就可以把它们整理成SKILL.md，一次导入、全局生效。

📚 延伸阅读：docs/SKILLS.md · docs/agents/skills.md · docs/agents/mcp-and-tasks.md