| name | qingflow-build |
| description | 轻流全栈搭建方法技能。提供从连接预检、需求分析、方案设计到搭建实施、验证测试的标准化流程。
触发词：搭建轻流应用、设计审批流程、创建表单、配置权限、搭建看板
|
轻流搭建方法
参考资料
- 5 个 HR 场景完整索引：@references/skills-index.md
- 人才管理端到端协作链路：@references/collaboration-chains.md
概述
这是人力资源 HR 专家的标准化搭建方法技能。当用户在轻流平台上需要搭建 HR 相关应用时使用此技能，遵循"先设计后搭建"的原则。
适用场景
- 新建轻流应用（表单 + 流程）
- 在现有应用上增加模块
- 搭建数据看板和报表
- 设计审批流程
- 配置权限和角色
连接策略
WorkBuddy 已内置轻流连接器。按用户意图分三种情况：
情况 1：愿意连接，但尚未连接
- 引导用户打开 WorkBuddy → 连接器，搜索并连接「轻流」连接器
- 无轻流账号 → 引导 qingflow.com 注册后再连接
- 有账号无 Token → 轻流个人设置 → OpenAPI → 生成 Token → 填入连接器
- 验证
workspace_list 通过后，进入 Phase 3 搭建实施
情况 2：不想连接 / 暂不方便连接
进入 咨询模式：只做需求分析与方案建议（表单/流程/权限思路），不调用 MCP，不输出逐步手动搭建教程。流程止于 Phase 2。
情况 3：已连接
走完整 Phase 0–4 流程。
搭建流程
Phase 0：连接预检（情况 1、3 适用；情况 2 跳过）
在开始任何需要实际操作轻流的搭建任务前，确认用户愿意连接且连接器可用：
A. 未连接
- A1. 连接器未连接 → 引导 WorkBuddy 连接器 中连接「轻流」
- A2. 已连接但未认证 → 引导填入 OpenAPI Token
B. 账号与认证
- B1. 没有轻流账号 → 引导 qingflow.com 注册
- B2. 不知道 Token → 轻流 → 个人设置 → OpenAPI → 生成 Token
- B3. Token 无效 → 检查格式，建议重新生成
C. 认证后
- C1. 无工作区 → 引导去轻流后台创建
- C2. 多个工作区 → 列出供用户选择
- C3. Token 过期 → 重新生成并在连接器中更新
D. 运行时异常
- D1. 网络/服务异常 → 检查网络，稍后重试
- D2. 限流（429）→ 等待约 30 秒
- D3. 权限不足（403）→ 确认工作区与账号权限
执行策略：
- 用户不想连接时，不执行 Phase 0，直接进入 Phase 1–2（咨询模式）
- 用户愿意连接时，先调用
workspace_list 验证；异常则引导连接/注册，不降级为手动搭建教程
- MCP 失败最多重试 2 次，仍失败则说明原因并引导排查
- 连接恢复后从断点继续
Phase 1：需求分析
与用户确认以下 4 要素：
- 使用者：谁会用？多少人？什么角色？
- 数据：管什么核心业务数据？
- 流转：数据怎么流转？谁审批？条件是什么？
- 输出：需要什么报表/看板/通知？
Phase 2：方案设计
输出结构化方案，包含：
表单结构：
- 主表单：{名称} — {用途}
- 子表单（如需）：{名称} — {用途}
字段清单：
流程设计：
A → B（条件：xxx）→ C → 结束
权限矩阵：
Phase 3：搭建实施（仅搭建模式，情况 3；或情况 1 连接完成后）
前提：用户已连接轻流且同意直接操作。
- 创建应用：设定名称和分类
- 设计表单：添加字段、设置联动规则、配置计算公式
- 配置流程：添加节点、设置审批人、配置条件分支
- 设置权限：定义角色、分配数据权限
- 搭建视图：配置数据列表、图表、看板
- 联调测试：写入测试数据、走通全流程
Phase 4：验证测试（仅搭建模式）
至少测试以下场景：
- 正常流程走通（标准数据完整流转）
- 边界条件（必填项为空、超金额阈值等）
- 异常路径（退回、驳回、超时等）
常用公式参考
| 场景 | 公式 |
|---|
| 自动编号 | CONCAT("QJ-", YEAR(NOW()), "-", LPAD(ROW_NUMBER(), 4, "0")) |
| 请假天数计算 | DATEDIFF({结束日期}, {开始日期}) + 1 |
| 金额大写 | RMB({金额}) |
| 条件求和 | SUMV({子表单}-{金额}, WHERE({子表单}-{状态}="已确认")) |
| 时间差 | TIMEDIFF({结束时间}, {开始时间}, "h") |
常见流程模式
模式 1：线性审批
提交 → 直属上级 → 部门负责人 → HR → 归档
模式 2：条件分支
提交 → （金额<5000 → 部门负责人）→（金额>=5000 → 部门负责人 → 总经理）→ 归档
模式 3：并行审批
提交 → [并行] 人事部审批 + 财务部审批 + IT部审批 → 汇总 → 归档
模式 4：会签/或签
提交 → 部门负责人（会签：多人同时审批，全票通过才通过）→ 归档
MCP 工具速查
创建应用时优先使用以下 MCP 工具（实际工具名以 mcp__qingflow-app-builder__ 和 mcp__qingflow-app-user__ 为前缀）：
| 操作 | 工具 |
|---|
| 创建/更新应用结构 | qingflow-app-builder: app_schema_apply |
| 获取应用字段 | qingflow-app-builder: app_get_fields |
| 配置流程 | qingflow-app-builder: app_flow_apply |
| 获取流程设计 | qingflow-app-builder: app_flow_get / app_flow_get_schema |
| 配置视图 | qingflow-app-builder: app_views_apply |
| 配置图表 | qingflow-app-builder: app_charts_apply |
| 配置布局 | qingflow-app-builder: app_layout_apply |
| 配置门户 | qingflow-app-builder: portal_apply |
| 查询工作区 | qingflow-app-builder: workspace_list |
| 写入数据 | qingflow-app-user: record_insert |
| 查询数据 | qingflow-app-user: record_list / record_get |
| 更新数据 | qingflow-app-user: record_update |
| 执行流程任务 | qingflow-app-user: task_action_execute |
| 数据导入 | qingflow-app-user: record_import_start |
| 数据导出 | qingflow-app-user: record_export_start |
