mcpField
F
feishu-task

feishu-task

github.com/alextangson生产力6491 次安装31 周前更新
代码仓库

关于 feishu-task

feishu-task 是通过 Feishu Task API 管理任务的技能,支持创建、获取、更新、完成和删除任务,并通过共享脚本获取及刷新认证令牌。

主要功能

  1. 01创建、获取和更新任务
  2. 02完成或删除任务
  3. 03获取并刷新 Bearer 令牌
  4. 04设置截止时间和成员角色

适用场景

  1. 01创建带描述和截止时间的任务
  2. 02修改任务信息或负责人
  3. 03完成或删除现有任务

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/alextangson/feishu_skills --skill feishu-task

安装后在 Claude Code 中输入/feishu-task确认已加载。

详细介绍

飞书任务

通过 Task API 管理任务。

基础 URL:https://open.feishu.cn/open-apis/task/v2

认证与 Token 获取

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

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

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

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

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

环境变量:

  • FEISHU_APP_ID
  • FEISHU_APP_SECRET

本地缓存:./.feishu_token_cache.json(未过期时直接复用,默认提前 5 分钟刷新)


任务操作

API端点说明
创建任务POST /tasks-
获取任务GET /tasks/{task_guid}-
更新任务PATCH /tasks/{task_guid}-
完成任务POST /tasks/{task_guid}/complete-
删除任务DELETE /tasks/{task_guid}-

创建任务:

{
  "summary": "任务标题",
  "description": "任务描述",
  "due": {"timestamp": "1770508800"},
  "members": [{"id": "ou_xxx", "role": "assignee"}]
}

最佳实践

  1. due 使用秒级时间戳
  2. members 指定角色(assignee/follower)

评论

支持 Markdown