返回顶部
f

feishu-task-management飞书任务管理

Manage Feishu tasks through a local Python toolkit that always has app credentials and can optionally act as a user for task APIs when OAuth user tokens are available. Use when Codex needs to create, inspect, update, complete, reopen, delete, or change task members in Feishu Task, especially when member names must be resolved through a locally synced member table and alias mapping instead of ad hoc contact lookups.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 0.0.1
安全检测
已通过
241
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

feishu-task-management

飞书任务管理

概述

使用此技能通过 feishu-task-management/toolkit/ 中的配套工具包操作飞书任务。核心工作流程保留在此文件中:决定命令、本地解析成员、应用写入安全规则,除非请求属于边缘情况,否则不加载额外引用。

核心工作流程

  1. 1. 通过本地工具包确认请求与飞书任务管理相关。
  2. 在首次基于API的操作前,确保工具包已配置。若未配置,请使用:
python3 feishu-task-management/toolkit/scripts/feishu_config.py guide
  1. 3. 将应用凭证视为强制基础配置。任务API优先使用已配置的 useraccesstoken,但联系人和成员同步操作仍使用应用认证。
  2. 如果操作涉及人员,通过工具包使用本地成员表。不要进行临时的联系人查询。
  3. 选择最精确的任务命令,而不是构建通用的HTTP请求。
  4. 对于破坏性或状态变更操作,在实际操作前先检查当前任务。
  5. 如果成员解析不明确或缺失,则停止操作。

命令路由

成员表维护

  • - 同步授权联系人范围:
python3 feishu-task-management/toolkit/scripts/feishu_members.py sync
  • - 检查同步状态:
python3 feishu-task-management/toolkit/scripts/feishu_members.py stats
  • - 测试成员查找:
python3 feishu-task-management/toolkit/scripts/feishu_members.py resolve --query 张三
  • - 验证手动别名:
python3 feishu-task-management/toolkit/scripts/feishu_members.py validate-aliases

工具包配置

  • - 显示配置指南:
python3 feishu-task-management/toolkit/scripts/feishu_config.py guide
  • - 写入本地运行时配置:
python3 feishu-task-management/toolkit/scripts/feishu_config.py set --app-id ... --app-secret ...
  • - 使用现有用户OAuth令牌扩展配置:
python3 feishu-task-management/toolkit/scripts/feishu_config.py set --app-id ... --app-secret ... --user-access-token ...
  • - 检查有效配置:
python3 feishu-task-management/toolkit/scripts/feishu_config.py show
  • - 验证当前配置:
python3 feishu-task-management/toolkit/scripts/feishu_config.py validate

读取操作

  • - 获取单个任务:
python3 feishu-task-management/toolkit/scripts/feishu_task.py get --task-guid ...
  • - 列出任务:
python3 feishu-task-management/toolkit/scripts/feishu_task.py list

写入操作

  • - 创建任务:
python3 feishu-task-management/toolkit/scripts/feishu_task.py create --summary ...
  • - 更新核心字段:
python3 feishu-task-management/toolkit/scripts/feishu_task.py update --task-guid ...
  • - 完成任务:
python3 feishu-task-management/toolkit/scripts/feishu_task.py complete --task-guid ...
  • - 重新打开任务:
python3 feishu-task-management/toolkit/scripts/feishu_task.py reopen --task-guid ...
  • - 添加成员:
python3 feishu-task-management/toolkit/scripts/feishu_task.py add-members --task-guid ... --member ...
  • - 移除成员:
python3 feishu-task-management/toolkit/scripts/feishu_task.py remove-members --task-guid ... --member ...
  • - 删除任务:
python3 feishu-task-management/toolkit/scripts/feishu_task.py delete --task-guid ... --yes

成员解析

仅使用本地解析,按以下顺序:

  1. 1. 显式标识符:openid、userid、email、mobile
  2. 来自 feishu-task-management/toolkit/data/memberaliases.json 的手动别名映射
  3. 对 name、enname、nickname 和 email 的精确规范匹配
  4. 有限的模糊匹配

应用以下安全规则:

  • - 零匹配:停止并报告需要更新成员表或别名。
  • 一个匹配:继续执行。
  • 多个匹配:停止并返回候选列表。

如果授权范围仅产生标识符字段而没有个人资料字段,自然语言匹配依赖于手动别名。当任务API后续使用用户令牌时,此规则不变。

写入安全规则

  • - 使用工具包,而不是在技能主体中构建原始HTTP请求。
  • 当存在专用命令时,优先使用专用命令而非通用更新负载。
  • 使用专用完成命令,而不是直接编辑 completed_at。
  • 将 origin 视为仅创建时设置。
  • 显式清除 start 和 due,而不是依赖省略。
  • 删除前需要显式确认。

支持的v1范围

  • - 创建任务
  • 获取任务
  • 列出任务
  • 更新摘要、描述、开始时间和截止时间
  • 删除任务
  • 完成任务
  • 重新打开任务
  • 添加成员
  • 移除成员

以下内容有意不在v1范围内:

  • - 提醒
  • 任务列表
  • 依赖关系
  • 重复规则
  • 自定义完成
  • 附件

条件引用

仅当请求偏离主路径时加载额外上下文:

  • - 仅在成员同步、别名验证或授权范围覆盖出现问题时,阅读 member-sync-troubleshooting.md
  • 仅在处理时间字段清除、origin、完成语义或延迟任务功能时,阅读 task-edge-cases.md
  • 仅在任务操作因权限相关行为(如 1470403)失败时,阅读 permission-errors.md
  • 仅在更改工具包负载或将CLI默认值与较新的飞书API示例对齐时,阅读 api-alignment.md

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 feishu-task-management-skill-1776158412 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 feishu-task-management-skill-1776158412 技能

通过命令行安装

skillhub install feishu-task-management-skill-1776158412

下载

⬇ 下载 feishu-task-management v0.0.1(免费)

文件大小: 30.99 KB | 发布时间: 2026-4-15 11:27

v0.0.1 最新 2026-4-15 11:27
Initial release of feishu-task-management-skill.

- Provides Feishu Task management via a local Python toolkit with app credentials and optional user token support.
- Supports creating, updating, completing, reopening, deleting tasks, and managing task members.
- Resolves members using a locally synced member table and alias mapping—no ad hoc lookups.
- Includes strict write-safety and command selection rules to avoid destructive or ambiguous operations.
- Scope excludes reminders, tasklists, dependencies, repeat rules, custom complete, and attachments.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部