Beisen Approval

审批中心

CRITICAL — 开始前 MUST 读取 ../beisen-shared/SKILL.md

路由优先级

本 Skill 处理：审批流程状态、节点、审批人查询（本人待办 / 已办 ）

不归本 Skill 处理：

• 创建审批定义、审批同意/拒绝/转交/撤回 → 走后台管理界面

触发场景

当用户表达以下意图时触发：

• 查流程、查审批、流程进度、审批到哪了
• 我的流程状态、XX的审批进度
• 当前节点、审批人是谁
• 在途流程、进行中的流程、审批中的流程
• 已结束流程、已通过/已驳回的流程
• 某段时间内的流程、最近的流程

命令速查

命令示例

bashCopy code
# 查询待办审批（可按 --data 传入日期 / 状态 / 类型筛选）
beisen-cli approval task queryMyPendingTasks
beisen-cli approval task queryMyPendingTasks --data '{"startDate":"2026-08-01","endDate":"2026-08-31"}'
# 查询已办审批（默认近 30 天）
beisen-cli approval task queryMyCompletedTasks

工作流程

1. 查本人待办：用户需要查询自己的待办时，执行 beisen-cli approval task queryMyPendingTasks，结果按到达时间降序排列，需保证统计的数量与查询到的数量一致

2. 查本人已办：用户需要查询自己的已办时，执行 beisen-cli approval task queryMyCompletedTasks，默认查询近 30 天的已办任务，结果按发起时间降序排列，需保证统计的数量与查询到的数量一致

3. 时间范围提取：用户提到时间范围时，自行提取查询的开始/结束时间，格式 YYYY-MM-DD，作为 startDate / endDate 传入 --data。

4. 流程状态：流程状态的名称与值见 references/processstate.md（审批中=1、通过=2、不通过=3、已完成=4、已终止=5、已驳回=6、已撤回=7）。筛选在途/已结束流程时，按对应状态值作为 approvalStatuses 传入 --data。

5. 结果输出：根据查询结果先进行总结，再以 Markdown 表格展示详细内容；若结果中返回了 detailPageUrl 任务链接，将链接作为流程标题的超链形式展示。

处理链

1. 查待办 → approval task queryMyPendingTasks 获取待办列表，提取 processTitle、currentNode、currentApproverName、startTime、arrivalTime、detailPageUrl 等关键字段
2. 用户明确需要详情时 → 根据返回的 approvalObjectId 或 taskId 补查详情（如有对应命令）
3. 查已办 → approval task queryMyCompletedTasks 获取已处理记录，提取 processStatus/processStatusName（审批状态）和 arrivalTime（到达时间）
4. 已拿到 approvalObjectId 后，不要重复查询列表

执行原则

• 待办 / 已办命令查询当前登录用户的审批数据；按发起人查询需传入 ownerId（员工ID），且仅能查询自己发起或参与过的流程
• 筛选条件通过 --data 的 JSON 传入（approvalStatuses / approvalTypes / startDate / endDate），均为可选
• approvalStatuses 取值见 references/processstate.md；
• 审批列表属于 L1 内部数据，正常展示；批量结果较多时使用摘要模式
• 返回的 approvalObjectId、taskId、currentApproverId 等 ID 必须从 CLI 返回中提取，严禁编造
• 审批标题和审批人信息直接展示，无需额外转换

返回字段说明

响应结构

CLI 返回为 JSON，外层为信封，内层为业务数据：

jsonCopy code
{
  "ok": true,
  "identity": "user",
  "data": {
    "code": "200",
    "data": [ { "...": "审批条目" } ]
  }
}

• ok：CLI 调用是否成功
• identity：身份标识
• data.code：状态码（"200" 表示成功）
• data.data：审批条目数组

审批条目字段

以下字段在 queryMyPendingTasks、queryMyCompletedTasks 返回的每条审批记录中一致出现：

所有字段必须从 CLI 返回中提取真实值，严禁编造。

输入输出实例

查询本人的待办信息

约束：基于 queryMyPendingTasks 查询出的结果，按到达时间降序排列。

问题实例：帮我查下我还有哪些没审批的待办

回复实例：你有一条李四的晋升审批待审批

待你处理（1条）

查询本人的已办信息

约束：基于 queryMyCompletedTasks 查询出的结果，按发起时间降序排列。

问题实例：帮我查下我有哪些已办

回复实例：你已处理了以下数据

你已处理（2条）

边界情况

• 查询结果为空时，说明"该员工暂无相关审批流程"
• 时间范围参数只传了开始时间或结束时间时，按单边筛选处理

Playbook 案例

案例 1：查询待办审批

用户问："我有什么待办审批？"

执行步骤：

1. 前置检查（beisen-shared 的 Step 1-3）
2. 执行 beisen-cli approval task queryMyPendingTasks
3. 解析返回的 data.data 数组，按 arrivalTime 降序展示流程标题（processTitle）、当前节点（currentNode）、当前审批人（currentApproverName）、发起时间（startTime）、到达时间（arrivalTime）
4. 如返回结果较多，提示"还有更多待办，是否继续查看？"

案例 2：查询已办审批

用户问："我最近处理了哪些审批？"

执行步骤：

1. 前置检查
2. 执行 beisen-cli approval task queryMyCompletedTasks（默认近 30 天）
3. 按发起时间（startTime）降序展示流程标题（processTitle）、状态（processStatusName）、当前节点（currentNode）、当前审批人（currentApproverName）、发起时间（startTime）
4. 如返回结果较多，提示存在更多记录

详细参考

• references/pending-list.md：待办命令详细参数与返回格式
• references/done-list.md：已办命令详细参数与返回格式
• references/processstate.md：审批流程状态名称与值

不在本 Skill 范围

• 创建审批定义（走后台管理）
• 非审批类待办（如招聘待办 → beisen-recruiting-todo）
• 审批操作（同意/拒绝/转交/撤回）— 当前版本不支持