ACP 单聊 - 技能扩展 (F-SKILL)

本文档由 PM 从 prd-acp-scenarios.md 抽取，保持与源同步。 覆盖技术场景：S-MSG-04 ~ S-MSG-06, S-SKILL-01

---

(F-SKILL-01) AI 技能自动发现与注入 [已实现]

用户故事：作为用户，我希望 AI 能自动发现并使用我配置的技能（如代码审查、测试等专业能力），以便获得更专业的帮助。

前置条件：用户已在技能目录中配置了技能

正常流程（用户视角）：

1. 用户发送首条消息时 -> 系统自动扫描并发现可用技能
2. 技能索引自动注入到 AI 的上下文中 -> AI 知道自己拥有哪些专业能力
3. AI 根据任务需要自动调用相应技能

不同 AI 后端的差异：

• 支持原生技能发现的后端：AI 通过工作目录中的技能文件自动获取技能信息
• 不支持原生技能发现的后端：系统通过在首条消息中注入技能索引来告知 AI

验收标准：

• 首条消息时自动发现并注入可用技能
• 支持内置技能、打包技能和用户自定义技能三种来源
• 技能注入仅在首条消息时执行，后续消息不重复注入

---

(F-SKILL-02) 指定技能注入（高级模式）[已实现]

用户故事：作为高级用户，我希望在发送消息时能指定使用哪些技能，以便精确控制 AI 的专业能力范围。

正常流程（用户视角）：

1. 用户在高级编辑界面中选择要启用的技能 -> 选中指定技能
2. 发送消息 -> 系统将选中技能的完整内容注入到消息上下文中
3. AI 获得所选技能的详细指导 -> 按照技能要求执行任务

异常情况：

• 未选择任何技能：消息按原样发送，不注入技能信息

验收标准：

• 支持在发送消息时手动选择启用的技能
• 选中技能的完整内容被注入到 AI 上下文
• 注入的内容包含技能目录路径信息

---

(F-SKILL-03) MCP 工具服务注入 [部分实现]

实现差距：4/5 验收标准通过；缺失 OAuth 认证引导 UI（仅支持 header 传递 token）

用户故事：作为用户，我希望 AI 能自动使用我配置的外部工具服务，以便 AI 能够完成更多类型的任务（如数据库查询、API 调用等）。

前置条件：用户已在设置中添加并启用了 MCP 工具服务

MCP 工具服务的三种来源：

1. 用户手动配置：用户在设置界面添加的外部工具服务（如数据库连接、API 网关等）
2. 系统内置：应用预装的工具服务（如图像生成），标记为"内置"，用户可启用/禁用
3. 扩展贡献：通过已安装的扩展插件自动提供的工具服务

正常流程（用户视角）：

1. 用户在设置中配置 MCP 工具服务（添加服务地址、选择传输方式、配置认证信息）
2. 用户启用该工具服务
3. 用户创建或进入会话时，系统自动将所有已启用的工具服务注入到 AI 会话中
4. AI 在对话中根据需要自动调用外部工具（用户会在界面中看到工具调用的过程和结果）
5. 用户无需在每次对话中手动选择要使用的工具

异常情况：

• MCP 工具服务连接失败：AI 仍可正常对话，但缺少对应外部工具能力
• 需要 OAuth 认证的工具服务：系统会引导用户在设置中完成登录授权
• 会话恢复时 MCP 工具服务自动重新加载
• 工具服务在会话中途不可用：AI 会收到工具调用失败的反馈，并尝试其他方式完成任务

重要限制：

• MCP 工具服务仅在会话建立时注入，会话中途新增或修改的工具配置需要重新进入会话才生效
• 禁用某个工具服务后，已建立的会话不受影响，新建会话才会排除该工具

不同 AI 后端的差异：

• 部分后端可能不支持 MCP 工具服务
• 不同后端支持的 MCP 传输方式可能不同

验收标准：

• 已启用的 MCP 工具服务在进入会话时自动注入
• 支持用户手动配置、系统内置、扩展贡献三种来源的工具服务
• 需要 OAuth 认证的工具服务能引导用户完成授权
• 工具服务加载失败不影响 AI 基本功能
• 会话恢复时自动重新加载工具服务