前言¶
在对话里提到「轻流」时，Agent 往往不知道要先装哪套工具、先查 schema 再查记录，还是该走 CLI 还是 MCP。手工查 npm 文档、拼 qingflow 子命令，既慢也容易漏步骤。下面介绍的 轻流（坐标 @user_2b6572ff/qingflow-mcp-skill）是 SkillHub 上的社区 Skill（分类 office-efficiency，当前版本 1.0.3），用标准 SKILL.md 把安装、鉴权、选 CLI/MCP 的流程写死，并在 references/ 里附带 CLI 与 MCP 工具清单，便于 Agent 按同一套约定执行。
这是什么¶
轻流 面向「用户提到轻流 / Qingflow，或要在 Qingflow 里做记录、应用、任务、工作区、导入导出、搭建侧操作」的场景。官方简介为：This skill should be used when the user mentions ‘轻流’ (Qingflow)；SKILL.md 还写明会检查并安装 @qingflow-tech/qingflow-cli，读取包内文档，再通过 CLI 或 MCP 完成请求。
维护方为 SkillHub 发布者 user_2b6572ff，来源 community。SkillHub 页面标注 requires_api_key=false（指安装该 Skill 本身不需要 SkillHub API Key）；实际访问轻流业务仍须轻流账号鉴权。
核心功能¶
Skill 本体不替代轻流服务端，而是编排 Agent 行为，并依赖全局安装的 Qingflow CLI（npm 包 @qingflow-tech/qingflow-cli，主命令 qingflow）。包内捆绑两个 stdio MCP 入口：
| 入口 | 用途 |
|---|---|
qingflow-app-user-mcp |
终端用户侧：记录 CRUD、任务、导入导出、工作区等 |
qingflow-app-builder-mcp |
搭建侧：应用 schema、布局、流程、视图、图表等 |
references/qingflow-mcp-tools.md 列出上述 MCP 的公开工具名及与 CLI 的对应关系；references/qingflow-cli-overview.md 给出完整命令树与环境变量（如 QINGFLOW_MCP_DEFAULT_BASE_URL，默认 https://qingflow.com/api）。
Skill 内建工作流要点（摘自 SKILL.md）：
- 按日检查 CLI 版本：用临时文件记录当天是否已执行
npm install -g @qingflow-tech/qingflow-cli@latest，避免重复升级。 - 确认已安装：
npm list -g @qingflow-tech/qingflow-cli，缺失则全局安装。 - 鉴权：
qingflow auth whoami；未登录时由用户提供邮箱密码，Agent 使用qingflow auth login --email … --password …（避免交互式阻塞）。 - 可选 MCP 配置：在 WorkBuddy 场景下将两个 MCP 写入
~/.workbuddy/mcp.json，并在连接器管理页 Trust。 - 执行请求：优先
qingflow <command> --json；若 MCP 已连接，则按工具表调用；先record_browse_schema_get_public/record_insert_schema_get_public，再record_list/record_insert_public。
触发关键词在 SKILL.md 中包括：轻流、qingflow、轻流表单、轻流记录、轻流应用、轻流任务等。
安装与启用¶
通过 SkillHub 安装 Skill¶
官方页面给出的安装提示为：依据 SkillHub 安装文档，安装 @user_2b6572ff/qingflow-mcp-skill。
若本机已有 skillhub CLI，需把 Skill 装到当前 Agent 识别的 skills 目录（文档强调必须用 --dir，否则默认 ./skills/ 可能不被加载）：
command -v skillhub && skillhub --version
skillhub install @user_2b6572ff/qingflow-mcp-skill --dir <你的 Agent skills 目录>
常见路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
也可从 SkillHub 详情页下载 qingflow-mcp-skill-1.0.3.zip 解压到对应 skills 目录。安装 Skill 后，按 Agent 产品说明重启或刷新技能列表。
Qingflow CLI（Skill 运行时会自动处理）¶
Skill 要求全局 CLI，手动预装命令为：
npm install -g @qingflow-tech/qingflow-cli@latest
Agent 按 Skill 步骤也会执行同等安装与按日更新逻辑。
MCP（可选，以 WorkBuddy 为例）¶
仅在需要 MCP 工具且尚未连接时，向 ~/.workbuddy/mcp.json 增加：
{
"mcpServers": {
"qingflow-user": {
"command": "qingflow-app-user-mcp",
"args": [],
"env": {
"QINGFLOW_MCP_DEFAULT_BASE_URL": "https://qingflow.com/api"
}
},
"qingflow-builder": {
"command": "qingflow-app-builder-mcp",
"args": [],
"env": {
"QINGFLOW_MCP_DEFAULT_BASE_URL": "https://qingflow.com/api"
}
}
}
}
保存后在连接器管理页信任对应 MCP。Cursor 等其它客户端的 MCP 配置方式以各自文档为准；Skill 内仅给出 WorkBuddy 示例。
典型用法¶
以下示例均来自 Skill 与参考文档，可在装好 CLI 且已登录后复现。
查看当前登录与工作区：
qingflow auth whoami
qingflow workspace list
查记录前先取浏览 schema（与 MCP 约定一致）：
qingflow record schema browse --json
qingflow record list --json
Agent 侧 MCP 鉴权（credential 模式，摘自参考文档）：
对工具 auth_use_credential 传入形如：
{
"profile": "default",
"base_url": "https://qingflow.com/api",
"credential": "<credential_string>",
"persist": false
}
在对话中触发 Skill： 用户自然语言提及「轻流」或具体诉求（例如「列出某应用的待办任务」），Agent 应加载本 Skill，走完 CLI/MCP 检查与鉴权后，按 references/qingflow-cli-overview.md 或 references/qingflow-mcp-tools.md 选用命令或工具。
适用场景与注意¶
适合谁： 已在使用轻流（Qingflow）做表单、流程、任务与数据运维的团队；希望在 Cursor、Claude Code、WorkBuddy 等 Agent 里用统一话术操作轻流，而不是每次从零查 CLI。
限制与注意：
- Skill 依赖 Node 全局包与（MCP 场景下）Python 3.9+；遇
Transport closed、Python 未找到等，参考SKILL.md与qingflow-cli-overview.md中的排障表（如设置QINGFLOW_MCP_PYTHON、重装@qingflow-tech/qingflow-cli）。 - 未登录时必须用户提供轻流账号；
SKILL.md含注册引导链接https://qingflow.com/passport/login?utm_source=workbuddy，请勿在日志中泄露密码。 - SkillHub 统计（以抓取资料为准）：评分 100000，下载 901，安装 0；页面数据会变动，以 SkillHub 详情为准。
- 搭建类 MCP 写操作通常涉及编辑锁；用户域操作需在正确工作区下执行，必要时先
workspace_select。
结尾¶
轻流 Skill 的价值在于：把「装 CLI → 鉴权 → 选 CLI 或双域 MCP → 先 schema 再 CRUD」写成 Agent 可执行的固定流程，并附带完整工具与命令索引。需要安装或查看版本时，可打开官方地址：https://api.skillhub.cn/user_2b6572ff/qingflow-mcp-skill（SkillHub 展示页：https://www.skillhub.cn/skills/user_2b6572ff/qingflow-mcp-skill）。
