操作场景
在对话页面中，您可以查看和管理当前 Claw 实例已安装的 Skill，以及编辑实例的 SOUL 配置。本文介绍如何在用户端管理 Skill 启停和编辑 SOUL 内容。
背景信息
Skill 是 DatabaseClaw 的运维技能插件，决定了 AI 助手可以执行哪些运维操作。用户端可对已安装的 Skill 进行启用或禁用操作。
SOUL 定义了 AI 助手的身份、行为准则和回答风格。用户端可微调当前实例的 SOUL 内容，修改仅影响当前实例，不影响管理端的 SOUL 模板。
实现机制
Skill 启停：用户端的 Skill 启停操作修改的是实例级别的 Skill 配置（
user_skill 表），不影响管理端全局 Skill 池。禁用 Skill 后，AI 助手在意图识别阶段不再将该 Skill 纳入候选匹配范围。SOUL 编辑：用户端编辑的 SOUL 内容存储在实例级别（覆盖从模板复制的初始内容），AI 助手在每次对话时加载实例级 SOUL 作为系统提示词。系统会自动在 SOUL 末尾注入安全红线规则，该部分对用户不可见、不可编辑。
使用限制
限制项 | 限制说明 |
Skill 管理范围 | 用户端仅能启用或禁用已安装的 Skill，无法新增或删除。 |
SOUL 内容大小 | 最大 100KB，支持 Markdown 格式。 |
安全红线 | SOUL 末尾的安全红线规则由系统自动注入，不可编辑。 |
注意事项
禁用关键 Skill（如巡检、慢查询分析）将导致 AI 助手无法执行对应的运维任务。
SOUL 内容直接影响 AI 助手的回答质量和行为边界，修改前建议与管理员确认。
实例级 SOUL 修改不会同步回管理端模板，重新选择模板也不会自动覆盖已编辑的内容。
前提条件
已创建 DatabaseClaw 实例，且实例状态为运行中。
操作步骤
管理实例 Skill
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击 Skill。
5. 在 Skill 面板查看已安装的 Skill 列表，面板顶部显示统计摘要（总数、已启用数和禁用数）。
6. 通过开关启用或禁用 Skill。
启用 Skill：开启开关后，AI 助手在对话中可调用该 Skill。
禁用 Skill：关闭开关前，系统将弹出确认框提示禁用影响。禁用后 AI 助手将不再调用该 Skill。
说明：
编辑实例 SOUL
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击 Soul。
5. SOUL 编辑弹窗中修改 SOUL 内容。SOUL 内容支持 Markdown 格式，最大100KB。
6. 单击保存，完成修改。
说明：
修改仅影响当前实例的 SOUL 配置，不会修改管理端的 SOUL 模板。
系统会自动在 SOUL 末尾注入安全红线规则，该部分不可编辑。
后续步骤
相关操作
使用对话功能
管理 SOUL
对应的 API 接口
API 名称 | 说明 |
DescribeUserSkillList | 查询实例已安装的 Skill 列表。 |
ModifyUserSkill | 修改实例 Skill 启用状态。 |
DescribeInstanceSoul | 查看实例 SOUL 内容。 |
ModifyInstanceSoul | 修改实例 SOUL 内容。 |
常见问题
用户端编辑 SOUL 后，管理端的 SOUL 模板会被修改吗？
不会。用户端对 SOUL 的编辑存储在实例级别，不影响管理端的 SOUL 模板。管理端模板变更也不会自动覆盖已有实例的 SOUL。
禁用 Skill 后对正在执行的任务有影响吗？
禁用 Skill 后，新的对话请求将不再调用该 Skill。已在执行中的任务不受影响，会继续完成当前执行。
