Skip to content

beisen-approval

北森审批中心查询。本 Skill 用于查询审批流程的当前状态、节点、审批人等信息,覆盖本人待办、已办;支持按流程状态(在途/已结束)和时间范围筛选。当用户询问'我有什么审批待办'、'审批进度'、'已办事项'、'流程到哪了'、'在途流程'、'已结束流程'等审批相关问题时触发。每人仅能查询自己发起或参与过的流程,不支持创建、审批、转交等写操作。

2,390
installs
0 up / 0 down, score 0.00
votes
In the catalog since
1 Oct 2026
From
senclaw-cdn.italent.cn
Get it through your agent

Skill instructions

Rendered from the published SKILL.md, 181 lines.

审批中心

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

路由优先级

本 Skill 处理:审批流程状态、节点、审批人查询(本人待办 / 已办 )

不归本 Skill 处理:

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

触发场景

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

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

命令速查

场景 CLI 命令 说明
查询自己的待办 beisen-cli approval task queryMyPendingTasks 返回当前用户待处理的审批列表
查询自己的已办 beisen-cli approval task queryMyCompletedTasks 返回当前用户已处理的审批列表(默认近 30 天)

命令示例

# 查询待办审批(可按 --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,外层为信封,内层为业务数据:

{
  "ok": true,
  "identity": "user",
  "data": {
    "code": "200",
    "data": [ { "...": "审批条目" } ]
  }
}
  • ok:CLI 调用是否成功
  • identity:身份标识
  • data.code:状态码("200" 表示成功)
  • data.data:审批条目数组

审批条目字段

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

字段 类型 说明
approvalObjectId string 审批对象ID(UUID 格式),审批实例的唯一标识
taskId string 任务ID(UUID 格式),当前任务实例标识
processTitle string 流程标题
approvalCategory number 审批类型编码
approvalCategoryName string|null 审批类型名称(可能为 null)
bizAppName string 业务应用名称(如 BeisenCloudStepAAA、BeisenCloudDemo、ServiceCenter)
processStatus number 流程状态值(1=审批中、2=通过、3=不通过、4=已完成、5=已终止、6=已驳回、7=已撤回)
processStatusName string 流程状态名称(如"审批中")
currentNode string 当前审批节点名称
currentApproverId number[] 当前审批人ID列表
currentApproverName string 当前审批人姓名
startTime string 流程发起时间(ISO 8601 格式,如 2025-05-08T15:30:47.36)
arrivalTime string 任务到达时间(格式 YYYY-MM-DD HH:mm,如 2025-05-08 15:30)
detailPageUrl string 审批详情页URL(用于在流程标题上做超链展示)

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

输入输出实例

查询本人的待办信息

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

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

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

Show the whole skill (61 more lines)

待你处理(1条)

流程标题 审批类型 当前节点 当前审批人 发起时间 到达时间
李四的晋升审批 晋升审批 部门总监审批 李四 2026-06-10T09:30:00 2026-06-12 14:00

查询本人的已办信息

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

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

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

你已处理(2条)

序号 流程标题 审批类型 状态 当前节点 当前审批人 发起时间
1 张三的请假审批 请假 审批中 部门总监审批 李四 2026-06-10T09:30:00
2 张三的请假审批 请假 已通过 -- -- 2026-06-12T10:00:00

边界情况

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

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. 如返回结果较多,提示存在更多记录

详细参考

不在本 Skill 范围

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