飞书任务(feishu-task)用于通过飞书 Task API 管理任务,支持创建任务、更新任务、查询任务等操作。
用途 该技能面向飞书开放平台的任务管理接口,帮助用户在飞书环境中以 API 方式创建、查询、更新、完成和删除任务。
主要能力 基于 Task API(Base URL: https://open.feishu.cn/open-apis/task/v2),提供以下端点:
- 创建任务:POST /tasks
- 获取任务:GET /tasks/{task_guid}
- 更新任务:PATCH /tasks/{task_guid}
- 完成任务:POST /tasks/{task_guid}/complete
- 删除任务:DELETE /tasks/{task_guid}
认证与 Token 获取 从 feishu_skills 根目录执行共享脚本获取 Token: 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 分钟刷新)。
使用方式 创建任务示例请求体: { "summary": "任务标题", "description": "任务描述", "due": {"timestamp": "1770508800"}, "members": [{"id": "ou_xxx", "role": "assignee"}] }
最佳实践
- due 使用秒级时间戳。
- members 指定角色(assignee/follower)。
适用场景 适用于需要在飞书环境中通过 API 自动化管理任务的场景,例如批量创建任务、更新任务状态、查询任务详情、完成任务或删除任务。
限制 关于该技能的收费、价格、平台支持范围、具体效果等事实,资料中暂未提供。