CLIAI 技能【免费下载链接】cliThe official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200 commands and 20 AI Agent Skills.项目地址https://gitcode.com/gh_mirrors/cli414/cli点击查看免费下载本文档基于 Lark/飞书官方 CLI 工具larksuite 团队维护面向人类与 AI Agent 设计的命令行工具覆盖 200 命令与 20 AI Agent Skills中的 lark-approval Skill 编写完整讲解lark-cli approval tasks reject命令如何安全地拒绝一个审批任务、如何正确获取instance_code与task_id参数、以及如何规避高风险写操作带来的误操作风险。读完本文你将掌握「查待办 → 看详情 → 预览 → 确认拒绝」的完整处理链并能正确处理confirmation_required、1395001等常见失败场景。命令定位tasks reject在审批处理链中的角色飞书审批approval领域的命令由lark-approvalSkill 统一管理。根据 skills/lark-approval/SKILL.md 的路由规则只要用户的核心对象是审批单据 / 审批待办 / 审批实例就优先使用lark-approval不要让渡给lark-task后者只负责非审批类待办。审批处理链处理待办为tasks query 拿 instance_code task_id → 按需instances get 看详情 → 执行操作approve / reject / transfer / ...其中环节命令说明查待办/已办列表tasks query获取instance_codetask_id操作必须成对带上查看详情/当前节点/表单instances get仅在用户明确要看详情、流程进度时才调用拒绝审批tasks reject本篇文章核心用户级写操作从 API 目录 internal/registry/catalog/services/approval.json 可以看到tasks.reject的底层定义API IDtasks.reject对应 HTTP 路径/open-apis/approval/v4/tasks/refuse方法为POST所需 scopeapproval:task:write鉴权方式useraccess token即必须以用户身份执行这也是文档要求显式加--as user的原因标记danger: true、risk: high-risk-write—— 这是 CLI 侧高风险写操作判定与--yes拦截机制的数据来源。前置步骤正确拿到instance_code与task_id拒绝操作的两个必填参数instance_code审批实例 Code与task_id审批任务 ID都来自待办任务列表。先执行tasks query查询待办topic1lark-cli approval tasks query --params {topic:1} --as usertasks query是只读操作不会修改审批状态需要的 scope 为approval:task:read。返回结果中与后续拒绝操作最相关的字段如下详见 skills/lark-approval/references/lark-approval-tasks-query.md字段说明tasks[].instance_code审批实例 Code执行 approve / reject / rollback 等操作时通常都需要tasks[].task_id审批任务 ID与instance_code配对使用tasks[].support_api_operate是否支持通过 API 同意或拒绝该任务false表示该任务可能无法通过 API 操作tasks[].status任务状态1待办、2已办、17未读、18已读、33处理中、34撤回tasks[].instance_status审批实例状态0无状态、1流转中、2已通过、3已拒绝、4已撤销、5已终止tasks[].definition_code/definition_name审批定义 Code 与名称tasks[].initiator/initiator_name发起人 ID 与姓名如果需要确认表单内容、当前节点、审批流进度再补充查询实例详情lark-cli approval instances get --params {instance_code:INSTANCE_CODE} --as user在 internal/registry/catalog/services/approval.json 中instances.get对应的 HTTP 路径为instances/detailGET同样使用用户身份鉴权。实例详情会返回当前节点、审批动态operation_records其中typeREJECT表示拒绝动作、评论等有助于在拒绝前确认单据状态。命令语法与完整示例tasks reject通过--data传入 JSON 请求体支持三种典型写法# 1. 先预览请求不实际执行 lark-cli approval tasks reject \ --data {instance_code:INSTANCE_CODE,task_id:TASK_ID,comment:拒绝} \ --as user \ --dry-run # 2. 拒绝审批任务并附带审批意见 lark-cli approval tasks reject \ --data {instance_code:INSTANCE_CODE,task_id:TASK_ID,comment:拒绝信息不完整} \ --as user \ --yes # 3. 通过文件传入请求体适合较长 comment lark-cli approval tasks reject \ --data ./reject-body.json \ --as user \ --yes第三种写法中reject-body.json的内容形如{ instance_code: INSTANCE_CODE, task_id: TASK_ID, comment: 拒绝缺少合同附件请补充后重新提交 }根据 internal/registry/catalog/services/approval.json请求体三个字段的类型与约束为instance_codestring必填、task_idstring必填、commentstring可选审批意见最多 500 字符。当拒绝原因较长时建议使用文件方式传入避免命令行转义出错。参数说明参数必填说明--data {...}是请求体 JSON使用 JSON 传入instance_code是审批实例 Code通常先通过tasks query或instances initiated/instances get获取task_id是审批任务 ID通常先通过tasks query获取comment否审批意见例如拒绝、拒绝信息不完整上限 500 字符--as user否建议显式指定用户身份审批拒绝通常必须以用户身份执行--yes否确认执行高风险写操作未带时可能返回confirmation_required/ exit 10--format否输出格式json默认、ndjson、table、csv--dry-run否预览 API 调用不执行注意--as user与 API 定义的accessTokens: [user]一一对应——拒绝是「人的动作」必须代表具体用户发起而不是以应用身份静默执行。高风险写操作保护机制为什么必须--dry-run--yestasks reject在 API 目录中被标记为danger: true/risk: high-risk-write见 internal/registry/catalog/services/approval.json。CLI 侧对风险等级的处理逻辑可在 cmd/service/affordance.go 中看到high-risk-write 操作必须经过用户明确确认才能执行Agent 不得自行追加--yes只有用户已明确确认后才可携带--yes运行。因此正确姿势是先用--dry-run预览 API 调用命令、请求体、目标对象是否正确不实际执行真正执行时仅在用户已明确要拒绝该审批、且目标任务无误的前提下才带--yes运行不要在未获用户明确同意时静默追加--yes。如果未带--yes命令可能返回confirmation_required并以 exit code 10 退出——这正是 CLI 强制人类确认高风险写操作的防线参见 cmd/root_help.go 中 high-risk-write needs --yes, only after the user confirms 的说明。失败处理1395001错误码决策树拒绝 / 转交 / 退回 / 撤回 / 同意等写操作可能返回错误码1395001任务状态异常 / 写前置校验失败。此时按 skills/lark-approval/SKILL.md 的决策树处理先停止盲目重试不要连续重复提交相同写操作最多重试 1 次优先从以下角度解释任务可能已被他人处理单据状态已变化当前动作已不再允许当前用户已不具备该任务的操作资格当前节点或单据状态不支持该操作如需确认只补一次状态查询tasks query或instances get不要陷入 query/write 循环最终给用户明确结论和下一步建议而不是继续无意义重试。特别提醒拒绝、转交、撤回这三类场景最容易因状态切换而失败更应严格执行上述规则——例如你在查看详情期间另一位审批人可能已经处理了该单据此时再执行拒绝自然会被前置校验拦截。使用建议与最佳实践instance_code和task_id要成对使用仅有实例 ID 或仅有任务 ID 都不足以准确执行拒绝操作两者必须同时来自同一条tasks query返回记录。优先从tasks query的待办列表拿参数尤其是topic1的待办审批最适合作为 reject 的输入来源topic枚举为1待办、2已办、17未读知会、18已读知会。先检查是否支持 API 操作如果tasks query返回的tasks[].support_api_operate为false说明该任务可能不支持通过 API 同意/拒绝继续执行拒绝没有意义应直接告知用户。comment建议写清拒绝原因例如拒绝缺少合同附件、拒绝预算字段填写不完整。这有助于发起人理解原因并补充材料注意 500 字符上限。先--dry-run再执行尤其在批量处理或任务来源不明确时先预览更安全。已知对象时直达动作用户已明确给出instance_code/task_id时不要先查列表再过滤skills/lark-approval/SKILL.md直接执行 reject压缩调用链。不要对非审批类待办使用本命令审批待办不是飞书任务非审批类待办请走 lark-task Skill。相关资源Skill 入口与命令路由skills/lark-approval/SKILL.md拒绝命令参考本文档源头skills/lark-approval/references/lark-approval-tasks-reject.md待办查询参考skills/lark-approval/references/lark-approval-tasks-query.md同意操作参考与拒绝对称skills/lark-approval/references/lark-approval-tasks-approve.md审批 API 目录tasks.reject定义于 v4 服务下internal/registry/catalog/services/approval.json高风险写操作与--yes拦截逻辑cmd/service/affordance.go、cmd/root_help.go赞分享CLIAI 技能【免费下载链接】cliThe official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200 commands and 20 AI Agent Skills.项目地址https://gitcode.com/gh_mirrors/cli414/cli点击查看免费下载相关推荐Cosmos-Predict2.5机器人多视图模型实战AgiBot 3摄像头数据处理与推理Cosmos Predict2.5机器人多视图模型实战AgiBot 3摄像头数据处理与推理 Cosmos Predict2.5作为最新一代世界基础模型WFMCLIAI 技能使用 lark-cli 转交审批任务approval tasks transfer 完整实战指南使用 lark cli 转交审批任务approval tasks transfer 完整实战指南 导读 审批任务的转交Transfer是飞书审批协作中最常CLIAI 技能飞书 CLI lark approval approvals search 实战指南从自然语言到可发起审批定义的精准定位飞书 CLI lark approval approvals search 实战指南从自然语言到可发起审批定义的精准定位 本指南以 larksuite CLICLIAI 技能上一篇Kotlin 2.2 FIR性能调优配置参数指南下一篇nixpkgs测试覆盖率使用NixOS测试框架实现全路径测试创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
