技能介绍

要解决什么问题

在 Agent 会话里直接猜 FlowUs V2 的请求字段、用 curl 拼鉴权，很容易遇到交互式登录阻塞、凭证泄露、以及写入目标不明确等问题。FlowUs 官方提供自文档化的 flowus CLI，本技能把「先检查环境再调 API」和「写操作前必读再确认」固定成可执行流程。

技能如何工作

强制预检（Preflight）：在任意远程 API 调用前，先确认 CLI 是否可用（缺失或过期时只说明官方安装入口，未经用户明确同意不下载、不执行安装脚本）；再用 flowus --json doctor 与 flowus --json whoami 验证鉴权。未登录时不自动跑交互式 flowus login，而是让用户在浏览器登录（flowus login --browser）、无头手动（flowus --json login --manual）或经批准的密钥通道配置 FLOWUS_TOKEN 中择一。

先问 CLI，再写请求：语法与字段以 CLI 为准——flowus --help、flowus help <cmd>、flowus api ls、flowus api --docs -X <METHOD> <path>、flowus api --spec；读页面内容优先 flowus markdown get。

凭证与输出：解析顺序为 --token → FLOWUS_TOKEN → 本地凭据存储；Agent 命令中不要传 --token、不要要求用户在聊天里粘贴 Bearer。机器可读输出用 --json；JSON 请求体与 Markdown 替换内容分别用 --body、--file 本地文件传入。

写入安全：创建、更新、追加、上传、替换或 raw API 写之前，需确认目标、操作与影响；可行时先读当前内容，Markdown 全量替换需用户明确授权；缺目标或内容时先给变更摘要并等待确认。CLI 故意拒绝 DELETE；本技能不协助绕过删除。

适用边界与注意点

源码仓库可能私有：不要要求用户先 clone 源码；仅在有明确批准时用官方 CDN 安装/更新，并校验版本与 SHA-256（无官方完整性数据则停，改用手动安装）。
优先领域命令而非 flowus api call；分页看 JSON 里的 cursor 再续查；数据库写入用 database mutate 等文档化路径，避免误覆盖已有记录。
搜索：精确标题/关键词用文本搜索；意图模糊时用语义搜索。文件上传后按返回的 object name 追加块或外链。