alextangson/feishu_skills/feishu-approval

Name: feishu-approval
Author: alextangson

Claude Code and agent skill by alextangson/feishu_skills

Trust tier 3

community

Source check pending

Checking that the SKILL.md file is still in the repository.

Install

npx vskill@latest install alextangson/feishu_skills/feishu-approval

SKILL.md

飞书审批

通过 Approval API 创建和查询审批实例。

Base URL: https://open.feishu.cn/open-apis/approval/v4

认证与 Token 获取

从 feishu_skills 根目录执行共享脚本：

bash

TOKEN="$(./scripts/get_feishu_token.sh)"

请求头统一使用 Authorization: Bearer ${TOKEN}。

如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求：

bash

TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"

环境变量:

FEISHU_APP_ID
FEISHU_APP_SECRET

本地缓存: ./.feishu_token_cache.json（未过期直接复用，默认提前 5 分钟刷新）

审批实例

API	端点	方法	请求体示例	说明
创建实例	`/instances`	POST	`{"approval_code":"7C46...","user_id":"ou_xxx","form":"{\"widget1\":\"value1\"}"}`	发起审批
查询实例	`/instances/{instance_id}`	GET	-	获取审批状态
审批操作	`/instances/{instance_id}/approve`	POST	`{"comment":"同意","task_id":"xxx"}`	同意/拒绝审批
撤回审批	`/instances/{instance_id}/cancel`	POST	`{"user_id":"ou_xxx"}`	申请人撤回
转交审批	`/instances/{instance_code}/transfer`	POST	`{"user_id":"ou_xxx","transfer_user_id":"ou_yyy","comment":"转交"}`	转交给他人
催办审批	`/instances/{instance_id}/urge`	POST	-	发送催办提醒
获取实例列表	`/instances`	GET	查询参数：`page_size=50&page_token=xxx&user_id=ou_xxx`	支持筛选参数（分页）
查询实例详情	`/instances/detail`	POST	`{"instance_code":"xxx"}`	查询完整详情

创建实例:

json

{
  "approval_code": "7C468A54-8745-2245-9675-08B7C63E7A85",
  "user_id": "ou_xxx",
  "form": "{\"widget1\":\"value1\"}"
}

审批任务

API	端点	方法	请求体示例	说明
获取任务列表	`/tasks`	GET	-	查询待办任务
获取任务详情	`/tasks/{task_id}`	GET	-	查询任务详情
审批任务	`/tasks/{task_id}/approve`	POST	`{"comment":"同意"}`	处理审批任务
转交任务	`/tasks/{task_id}/transfer`	POST	`{"transfer_user_id":"ou_xxx"}`	转交任务

审批定义

API	端点	方法	请求体示例	说明
获取定义列表	`/approvals`	GET	-	查询所有审批模板
获取定义详情	`/approvals/{approval_code}`	GET	-	查询模板详情
获取定义表单	`/approvals/{approval_code}/forms`	GET	-	查询表单字段定义

审批抄送

API	端点	方法	请求体示例	说明
获取抄送列表	`/cc`	GET	-	查询抄送我的审批
已读抄送	`/cc/{instance_id}/read`	POST	-	标记抄送已读

审批评论

API	端点	方法	请求体示例	说明
添加评论	`/instances/{instance_id}/comments`	POST	`{"content":"评论内容","user_id":"ou_xxx"}`	添加审批评论
获取评论	`/instances/{instance_id}/comments`	GET	-	查询评论列表

常见参数说明

user_id_type: 用户 ID 类型

open_id（默认）
user_id
union_id

分页参数:

page_size: 每页数量（默认 20，最大 100）
page_token: 分页标记

实例状态:

PENDING: 审批中
APPROVED: 已通过
REJECTED: 已拒绝
CANCELED: 已撤回
DELETED: 已删除

测试示例

获取审批定义列表:

bash

curl -X GET "https://open.feishu.cn/open-apis/approval/v4/approvals?page_size=10" \
  -H "Authorization: Bearer ${TOKEN}"

创建审批实例:

bash

curl -X POST "https://open.feishu.cn/open-apis/approval/v4/instances" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "approval_code": "7C468A54-8745-2245-9675-08B7C63E7A85",
    "user_id": "ou_xxx",
    "form": "{\"widget1\":\"请假3天\"}"
  }'

查询实例列表:

bash

curl -X GET "https://open.feishu.cn/open-apis/approval/v4/instances?page_size=20&user_id=ou_xxx" \
  -H "Authorization: Bearer ${TOKEN}"

最佳实践

先获取审批定义（确认 form 字段）
form 必须字符串化 JSON
审批操作需审批人权限
分页查询：大量数据用 page_token 分页
user_id 必填：创建实例和查询列表都需要指定 user_id

Security

Security scanPassed, 100 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingfeishu-approval/SKILL.md

Popularity

Repository stars: 62
Repository forks: 6
7-day trend score: 21

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 19 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/alextangson/feishu_skills/feishu-approval/badge)](https://verified-skill.com/skills/alextangson/feishu_skills/feishu-approval)

Something wrong with this skill or its page? Tell us.