技能¶

技能是 Agent 可复用的工作方法或专业能力。启用技能后，Agent 可以按照预设流程、标准和输出方式处理任务，例如告警研判、日志排查、链路分析、巡检报告生成、变更风险检查或故障复盘整理。

技能采用“先全局准备，再按 Agent 启用”的配置方式：先在全局配置中准备团队可用的技能，再回到具体 Agent 的工作台，只开启这个 Agent 真正需要的技能。这样可以避免所有 Agent 默认拥有同样能力，也方便按职责控制工作边界。

配置流程¶

建议按以下顺序配置技能：

flowchart TD
  A[进入全局配置 > 技能] --> B{选择技能来源}
  B --> C[从技能市场安装]
  B --> D[创建自定义技能]
  B --> E[上传包含 SKILL.md 的 ZIP 技能包]
  C --> F[形成空间内可用技能池]
  D --> F
  E --> F
  F --> G[进入具体 Agent 工作台 > Skills]
  G --> H[按 Agent 职责开启市场或自定义技能]
  G --> I[内置技能默认可用]
  H --> J[在任务中使用技能]
  I --> J

在技能市场安装技能¶

技能市场提供可直接安装的技能。进入全局配置 > 技能后，默认可以在市场中浏览可用技能，也可以通过搜索快速定位。

查看市场技能时，可以：

• 点击技能卡片查看技能详情，包括说明、标签和版本信息；
• 点击安装，将该技能加入当前空间的技能池；
• 安装完成后，在已安装中查看该技能，并按内置、市场、自定义等来源筛选。

市场技能安装后不会自动对所有 Agent 生效。它只是进入空间可用能力池，仍需要到具体 Agent 工作台中开启。

创建或导入自定义技能¶

如果团队需要沉淀自己的工作方法，可以在全局配置中创建自定义技能。新增技能时，可以选择：

• 创建空白技能：填写技能名称、描述、图标和技能文档；
• 上传 ZIP：上传包含 SKILL.md 的技能包，由系统解析后生成技能。

创建空白技能时，建议重点写清楚：

• 技能名称：使用便于识别的名称，例如 code-review-helper、test-case-generator；
• 描述：说明这个技能适合解决什么问题，帮助团队判断是否需要启用；
• 技能文档：用 Markdown 描述适用场景、输入要求、处理流程、输出标准和示例。

在已安装技能列表中，点击技能卡片可以查看技能详情。对于上传导入的技能，详情页会展示技能包内容，便于确认 SKILL.md 和相关文件是否符合预期。

在 Agent 中启用技能¶

进入具体 Agent 的工作台，打开 Skills 页面。这里展示的是当前空间内已经准备好的技能，并按内置、市场、自定义分组。

配置时需要注意：

• 内置技能默认对 Agent 可用，不需要也不能手动关闭；
• 市场技能和自定义技能需要通过开关启用，启用后会立即保存到当前 Agent；
• 当前页面只负责 Agent 级启停，不提供新增、编辑或删除入口。如需管理技能，请点击页面中的全局配置返回全局配置；
• 点击技能卡片主体，可以打开只读详情，查看该技能的具体说明或包内容。

建议按 Agent 职责启用技能。例如告警值班 Agent 可以启用告警研判和通知整理技能，生产排障 Agent 可以启用日志、指标、链路分析相关技能，巡检 Agent 则只启用巡检报告和风险汇总相关技能。

在任务中使用技能¶

技能启用后，Agent 可以在任务中根据目标自动选择合适的技能；您也可以在任务描述中明确指定希望使用的技能。

当技能会影响 Agent 的处理流程或输出格式时，建议在任务中写清楚目标、输入范围和期望结果。例如：

• 希望 Agent 按告警处理标准输出影响范围、可能原因和建议动作；
• 希望 Agent 汇总某次故障相关的日志、指标和链路线索，并给出排查顺序；
• 希望 Agent 按团队模板生成巡检报告、故障复盘或变更风险说明。

使用建议¶

• 先把技能作为团队能力沉淀到全局配置，再按 Agent 职责启用，避免重复配置。
• 一个 Agent 只启用与职责相关的技能，保持行为稳定、可预期。
• 技能描述要写给使用者看，让团队成员能快速判断“什么时候该用它”。
• 技能文档要写给 Agent 执行看，重点说明输入、流程、约束、输出格式和示例。
• 导入技能包后，先点击卡片检查详情，再到 Agent 工作台开启使用。