Agentic-feishu feishu-task

飞书任务（承诺与待办追踪）。用于创建、查看、更新任务，设置截止日期，指派负责人。当用户提到任务（任务/待办/todo）、截止日期（ddl）、承诺（记得提醒我/别忘了/下周之前要）时触发。任务回答「什么事要记得做完」——需要完成追踪的状态项。

install

source · Clone the upstream repo

git clone https://github.com/MidnightV1/agentic-feishu

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/MidnightV1/agentic-feishu "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/feishu_task" ~/.claude/skills/midnightv1-agentic-feishu-feishu-task && rm -rf "$T"

manifest: skills/feishu_task/SKILL.md

source content

Feishu Tasks

把对话中的承诺固化为可追踪状态。聊天里说的"下周搞一下"很容易被淹没，但变成一条有 deadline 的任务就不会。

触发场景（不只是用户显式说"建个任务"）：

隐式承诺 — 用户说"记得提醒我..."、"别忘了..."、"下周之前要..."
讨论后的 action items — 文档/方案讨论结束后，结论中的待办事项
Bot 发现的待跟进项 — 审查代码发现 TODO、定时任务失败需要处理
异步交接 — "帮我查一下X，周五前给我" → 给自己建任务，到期交付

与日历的边界：日历管理时间锚点（有开始/结束、需要"在场"的事件），任务管理承诺追踪（有状态流转、需要"做完"的事项）。

CLI 调用方式

cd ~/Agent\ Space/agentic-feishu && python3 tools/builtin/skill_task.py <action> --params '<json>'

示例：

python3 tools/builtin/skill_task.py list --params '{}'

Actions

调用方式：

python3 tools/builtin/skill_task.py <action> --params '<json>'

create — 创建任务。params:
```
{title, due_date?, description?}
```
。
```
due_date
```
支持多种格式（见下方 Due Date Formats）。
get — 获取任务详情。params:
```
{task_id}
```
。
list — 列出任务。params:
```
{completed?}
```
。默认返回未完成任务；传
```
completed=true
```
返回已完成任务。
update — 更新任务字段。params:
```
{task_id, title?, due_date?, description?}
```
。只传需要修改的字段。
complete — 标记任务完成。params:
```
{task_id}
```
。
delete — 删除任务（两阶段确认）。第一次调用（不带
```
confirmed
```
）返回确认提示；第二次调用加
```
confirmed=true
```
才执行删除。params:
```
{task_id, confirmed?}
```
。
assign — 指派用户。params:
```
{task_id, open_ids}
```
。
```
open_ids
```
必须为逗号分隔字符串，不能传 list（如
```
"ou_aaa,ou_bbb"
```
）。
unassign — 取消指派。params:
```
{task_id, open_ids}
```
。同上，CSV 字符串。
snapshot — 获取所有未完成任务的分类概览（逾期 / 即将到期 / 进行中）。无需参数。无未完成任务时静默返回，不产生输出。

Due Date Formats

格式	示例	说明
ISO datetime	`2026-03-10T15:00` 或 `2026-03-10 15:00`	完整日期时间
ISO date only	`2026-03-10`	当天午夜
Time only	`15:00`	今天该时刻；若已过则顺延至明天
Relative	`+2h` 、 `+30m`	从当前时刻起偏移
Natural	`tomorrow 15:00` 、 `tomorrow`	自然语言，代码自动解析

Coded Behaviors

代码保证的行为，无需 LLM 判断：

CSV auto-parse —
```
assign
```
/
```
unassign
```
的
```
open_ids
```
只接受字符串，代码内部自动按逗号拆分。禁止传 list，否则类型错误。
Confirmation-gated deletion —
```
delete
```
不带
```
confirmed
```
时返回「确认删除？」提示，不执行任何写操作；加
```
confirmed=true
```
后才真正删除。
Snapshot silent exit —
```
snapshot
```
检测到无未完成任务时静默返回空结果，不向用户输出任何内容，减少心跳噪声。
Due date auto-parse —
```
create
```
/
```
update
```
的
```
due_date
```
字段自动处理 ISO、自然语言、相对偏移和飞书毫秒时间戳格式。

Params Examples

# 创建任务，自然语言 due_date
feishu_task("create", {"title": "提交周报", "due_date": "tomorrow 17:00", "description": "Q1 summary"})

# 列出未完成任务（默认）
feishu_task("list", {})

# 列出已完成任务
feishu_task("list", {"completed": true})

# 指派多人，open_ids 必须是 CSV 字符串
feishu_task("assign", {"task_id": "xxx", "open_ids": "ou_aaa,ou_bbb"})

# 标记完成
feishu_task("complete", {"task_id": "xxx"})

# 删除（两阶段：第一次无 confirmed → 提示；第二次加 confirmed=true → 执行）
feishu_task("delete", {"task_id": "xxx", "confirmed": true})

# 任务概览（心跳/定期检查用）
feishu_task("snapshot", {})