用途:把一个 App 的 AI 能力从产品入口、调用通道、模型策略到可选 UI 一次接好,生成的用户界面只呈现用户需要的能力,不暴露需求背景、账户或渠道细节。适用触发场景:用户说“给这个 App 加 AI 功能”“初始化 AI 调用”或“加聊天/总结/生成入口”,或提到 Agent Client、MaaS 中转渠道、模型偏好、模型路由、可选 AI UI 时启用。不适用:仅在开发环境调用已有脚本或做一次性模型测试;只配置某个 Agent Client 的全局账号或 API Key 而不改 App 功能。
主要能力与工作流(强制按序):Step 0 检查 App 技术栈、运行时界面、认证模型、后端边界与用户动作,明确一个窄能力,不无目的地加通用聊天框。Step 1 解决集成选择:本地运行且有兼容本地客户端可用 Agent Client;Web、移动、共享或生产流量用服务端 MaaS 网关;Hybrid 以 MaaS 为运行时、Agent Client 仅用于本地增强;模型意图选择 fast、balanced、reasoning、vision 或 creative,而非硬编码某供应商模型。Step 2 添加产品边界:定义带类型的输入、校验请求、模型意图、流式/非流式响应、错误结构与用量元数据;凭证和上游路由放服务端网关,浏览器/移动端只调用 App 自身端点,不直连上游密钥;Agent Client 走同一适配器契约,运行时探测可用性并提供明确的不可用状态。Step 3 仅在需要时加 UI,复用现有组件与加载/错误约定,构建最小完整交互并提供有意义的后续动作。Step 4 端到端验证:测试客户端可用/缺失、MaaS 成功/失败、慢速或流式响应、异常模型输出,确认凭证、内部路由、堆栈或私有提示不出现在源码、网络载荷、日志或 UI 中,并运行项目的格式、lint、类型检查与测试。
限制与依赖:需要已知前端和/或服务端边界的目标 App,以及兼容的本地 Agent Client 桥、已配置的 MaaS 网关或两者。本技能仅保存路由顺序、模型意图、语言、UI 默认等可移植偏好,绝不把 API Key、令牌、私有端点或项目路径存入源码控制。用户提出修改意见时,先区分仅本次或可复用,可复用规则须更新对应技能并完成版本、lint 与分发核验后再应用到当前任务;此类修改会使先前的“确认”“继续”失效,完成后须停下等待用户下一步指示,不自动发布或提交。