feishu-tasklisted
Install: claude install-skill op7418/CodePilot
# 飞书任务管理
## 🚨 执行前必读
- ✅ **时间格式**:ISO 8601 / RFC 3339(带时区),例如 `2026-02-28T17:00:00+08:00`
- ✅ **current_user_id 强烈建议**:从消息上下文的 SenderId 获取(ou_...),工具会自动添加为 follower(如不在 members 中),确保创建者可以编辑任务
- ✅ **patch/get 必须**:task_guid
- ✅ **tasklist.tasks 必须**:tasklist_guid
- ✅ **完成任务**:completed_at = "2026-02-26 15:00:00"
- ✅ **反完成(恢复未完成)**:completed_at = "0"
---
## 📋 快速索引:意图 → 工具 → 必填参数
| 用户意图 | 工具 | action | 必填参数 | 强烈建议 | 常用可选 |
|---------|------|--------|---------|---------|---------|
| 新建待办 | feishu_task_task | create | summary | current_user_id(SenderId) | members, due, description |
| 查未完成任务 | feishu_task_task | list | - | completed=false | page_size |
| 获取任务详情 | feishu_task_task | get | task_guid | - | - |
| 完成任务 | feishu_task_task | patch | task_guid, completed_at | - | - |
| 反完成任务 | feishu_task_task | patch | task_guid, completed_at="0" | - | - |
| 改截止时间 | feishu_task_task | patch | task_guid, due | - | - |
| 创建清单 | feishu_task_tasklist | create | name | - | members |
| 查看清单任务 | feishu_task_tasklist | tasks | tasklist_guid | - | completed |
| 添加清单成员 | feishu_task_tasklist | add_members | tasklist_guid, members[] | - | - |
---
## 🎯 核心约束(Schema 未透露的知识)
### 1. 当前工具使用用户身份(已内置保护)
**工具使用 `user_access_token`(用户身份)**
这意味着:
- ✅ 创建任务时可以指定任意成员(包括只分配给别人)
- ⚠️ 只能查看和编辑**自己是成员的任务**
- ⚠️ **如果创建时没把自己加入成员,后续无法编辑该任务**
**自动保护机制**:
- 传入 `current_user_id` 参数(从 SenderId 获取)
- 如果 `members` 中不包含 `current_user_id`,工具会**自动添加为 follower**
- 确保创建者始终可以编辑任务
**推荐用法**:创建任务时始终传 `current_user_id`,工具