技能介绍

要解决的问题

当 Agent 需要处理轻流里的日常事务时，通常会卡在工具链接入上：qingflow-cli 是否已安装、版本是否一致、账号是否登录，MCP server 是否可用，记录字段 ID 是否拿错。轻流操作还跨用户域和应用构建域：前者处理记录和任务，后者处理应用结构、布局、流程与视图。直接让模型凭感觉调用工具，容易出现参数错误、阻塞式登录或终端乱码。

技能如何工作

该技能把轻流请求收敛成固定工作流：

状态检查：先判断 CLI 当日更新状态、安装状态和 auth 登录状态。
认证处理：未登录时引导用户给出邮箱和密码，并在 agent 上下文中直接传 --email 与 --password，避免交互式终端阻塞。
MCP 配置：如需使用 MCP 工具，会配置 qingflow-user 与 qingflow-builder 两类服务。前者偏记录、任务、导入导出；后者偏应用 schema、布局、流程、视图和图表。
执行请求：优先用 qingflow --json 获取机器可读结果；在 MCP 可用时调用 record_*、task_*、app_* 等工具。文档特别强调在 record_list 前调用 record_browse_schema_get_public，在写入前调用 record_insert_schema_get_public，以便先拿到字段 ID 和类型。

适用边界与注意点

该技能适合在 WorkBuddy 或支持 MCP 的 Agent 环境中使用，适合记录查询、任务执行、应用流程维护等结构化请求。它不负责替用户创建轻流账号，也不处理与轻流无关的通用办公任务。遇到 Transport closed from MCP、Python 路径缺失、版本不一致或中文输出乱码时，应按 CLI/MCP 的排障路径处理，必要时改用 --json 输出到临时文件再读取。