# Send feishu-task-integration-skill to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "feishu-task-integration-skill",
    "name": "feishu-task-integration-skill",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/showdownagain/feishu-task-integration-skill",
    "canonicalUrl": "https://clawhub.ai/showdownagain/feishu-task-integration-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/feishu-task-integration-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-task-integration-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/feishu_task_integration.py",
      "scripts/feishu_task_integration_clean.py",
      "scripts/todo_handler.py",
      "scripts/todo_handler_clean.py",
      "references/api_guide.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/feishu-task-integration-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/feishu-task-integration-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/feishu-task-integration-skill",
    "agentUrl": "https://openagent3.xyz/skills/feishu-task-integration-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-task-integration-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-task-integration-skill/agent.md"
  }
}
```
## Documentation

### 功能概述

飞书任务对接集成技能实现了本地待办事项系统与飞书任务平台的无缝对接，提供智能化的任务管理和同步功能。

### 1. 自动任务创建

使用 todo任务内容 命令自动创建飞书任务
自动设置任务负责人和关注人
生成任务唯一标识符和访问链接

### 2. 智能时间解析

支持自然语言时间表达："今天"、"明天"、"本周"、"下周"、"本月"
支持具体时间："下午3点"、"晚上11点"
自动转换为标准时间戳格式

### 3. 任务负责人管理

自动指派任务给配置的用户
支持多人协作（关注人和负责人分离）
符合飞书任务API规范

### 4. 状态同步

本地完成任务自动同步到飞书
实时获取任务完成状态
双向数据一致性保证

### 基本使用

# 创建任务（自动同步到飞书）
todo完成项目报告

# 查看任务列表
todo

# 完成任务（同步到飞书）
done0

### 时间表达式示例

# 今天截止
todo今天完成文档整理

# 明天截止  
todo明天提交周报

# 本周截止
todo本周完成项目总结

# 具体时间
todo今天晚上8点之前完成演示准备

### 必要配置

在 feishu_config.json 中配置以下信息：

{
  "app_id": "your_app_id",
  "app_secret": "your_app_secret", 
  "assignee_user_id": "ou_your_user_id"
}

### 获取配置信息

App ID & Secret: 在飞书开发者后台创建应用获取
User ID: 用户的open_id，格式为 ou_xxxxxxxx

### 文件结构

todo_handler.py - 主处理器，处理todo命令
feishu_task_integration.py - 飞书任务API集成
feishu_config.json - 配置文件

### API集成

使用飞书任务v2 API
正确的字段命名：members、assignee_list
符合飞书API规范和权限要求

### 常见问题

任务创建失败: 检查API密钥和用户ID配置
负责人设置无效: 确认用户ID格式正确（ou_开头）
时间解析错误: 使用标准时间表达格式

### 调试信息

查看详细日志输出：

python3 todo_handler.py "todo测试任务" 2>&1

### scripts/

包含核心功能脚本：

todo_handler.py - 待办事项处理器
feishu_task_integration.py - 飞书API集成

### references/

包含参考文档：

api_guide.md - 飞书任务API使用指南
configuration.md - 详细配置说明

### assets/

包含配置文件模板：

feishu_config_template.json - 配置文件模板
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: showdownagain
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/feishu-task-integration-skill)
- [Send to Agent page](https://openagent3.xyz/skills/feishu-task-integration-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/feishu-task-integration-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/feishu-task-integration-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/feishu-task-integration-skill)