feishu-doc-todo 技能

描述

飞书文档待办自动识别与日历创建工具。自动读取飞书文档中的待办表格（时间节点 + 里程碑 + 负责人），解析模糊时间，创建飞书日历日程并设置 deadline 提醒。

触发词

• "创建日历"
• "设置日程"
• "待办提醒"
• "deadline 提醒"
• "飞书文档待办"
• "文档待办转日历"

执行流程

步骤 1：读取飞书文档内容

使用 feishu_doc read 读取文档内容，提取待办表格。

# 读取文档
feishu_doc read --doc_token \x3C文档 token>

待办表格格式识别：

| 时间节点 | 里程碑 | 负责人 |
|---------|--------|--------|
| 下周 | xxx | xxx |
| 4 月 8 日 | xxx | xxx |
| 4 月份 | xxx | xxx |

步骤 2：解析待办事项

Python 解析脚本：

import re
from datetime import datetime, timedelta

def parse_todo_table(markdown_table):
    """解析待办表格，返回待办事项列表"""
    todos = []
    
    # 解析表格行
    lines = markdown_table.strip().split('\
')
    headers = []
    data_rows = []
    
    for i, line in enumerate(lines):
        if i == 0:  # 表头
            headers = [h.strip() for h in line.split('|')[1:-1]]
        elif i == 1:  # 分隔线
            continue
        else:  # 数据行
            cells = [c.strip() for c in line.split('|')[1:-1]]
            if len(cells) >= 3:
                data_rows.append({
                    'time': cells[0],
                    'task': cells[1],
                    'owner': cells[2]
                })
    
    return data_rows

def parse_fuzzy_time(time_str, reference_date=None):
    """解析模糊时间为具体日期"""
    if reference_date is None:
        reference_date = datetime.now()
    
    time_str = time_str.strip()
    
    # 精确日期：4 月 8 日
    match = re.match(r'(\d{1,2}) 月 (\d{1,2}) 日？', time_str)
    if match:
        month, day = int(match.group(1)), int(match.group(2))
        year = reference_date.year
        return datetime(year, month, day)
    
    # 模糊时间：下周
    if '下周' in time_str:
        return reference_date + timedelta(days=7)
    
    # 月份：4 月份
    match = re.match(r'(\d{1,2}) 月份', time_str)
    if match:
        month = int(match.group(1))
        # 取月中
        return datetime(reference_date.year, month, 15)
    
    # 默认：返回参考日期 +7 天
    return reference_date + timedelta(days=7)

# 使用示例
todos = parse_todo_table(table_markdown)
for todo in todos:
    deadline = parse_fuzzy_time(todo['time'])
    print(f"任务：{todo['task']}")
    print(f"负责人：{todo['owner']}")
    print(f"截止日期：{deadline.strftime('%Y-%m-%d')}")
    print("---")

步骤 3：创建飞书日历日程

使用 feishu_calendar create 创建日程。

# 创建单个日程
feishu_calendar create \
    --title "【待办】xxx" \
    --start_time "2026-04-05T09:00:00+08:00" \
    --end_time "2026-04-05T18:00:00+08:00" \
    --attendees "XXX" \
    --description "里程碑：xxx\
负责人：XXX\
来源文档：https://XXX" \
    --reminder_minutes 1440

参数说明：

步骤 4：批量创建日程

批量处理脚本：

import subprocess
import json
from datetime import datetime

def create_calendar_event(todo, source_doc_url):
    """创建单个日历事件"""
    deadline = parse_fuzzy_time(todo['time'])
    
    # 构建命令
    cmd = [
        'feishu_calendar', 'create',
        '--title', f'【待办】{todo["task"]}',
        '--start_time', deadline.strftime('%Y-%m-%dT09:00:00+08:00'),
        '--end_time', deadline.strftime('%Y-%m-%dT18:00:00+08:00'),
        '--attendees', todo['owner'],
        '--description', f'里程碑：{todo["task"]}\
负责人：{todo["owner"]}\
来源文档：{source_doc_url}',
        '--reminder_minutes', '1440'  # 提前 1 天提醒
    ]
    
    # 执行命令
    result = subprocess.run(cmd, capture_output=True, text=True)
    
    if result.returncode == 0:
        print(f"✅ 创建成功：{todo['task']}")
        return json.loads(result.stdout)
    else:
        print(f"❌ 创建失败：{todo['task']}")
        print(result.stderr)
        return None

# 批量创建
source_doc = "https://XXX"
for todo in todos:
    create_calendar_event(todo, source_doc)

完整示例

输入

Thomas 消息：

创建日历，从以下文档提取待办：
https://XXX

执行过程

1. 读取文档：

feishu_doc read --doc_token XXX

2. 解析待办表格：

todos = [
    {
        'time': '下周',
        'task': 'xxx',
        'owner': 'xxx'
    },
    {
        'time': '4 月 8 日',
        'task': 'xxx',
        'owner': 'xxx'
    },
    {
        'time': '4 月份',
        'task': 'xxx',
        'owner': 'xxx'
    },
    {
        'time': '5 月或 6 月底',
        'task': 'xxx',
        'owner': '全体'
    }
]

3. 解析时间：

parse_fuzzy_time('下周') → 2026-04-05
parse_fuzzy_time('4 月 8 日') → 2026-04-08
parse_fuzzy_time('4 月份') → 2026-04-15
parse_fuzzy_time('5 月或 6 月底') → 2026-06-30

4. 创建日历：

# 待办 1
feishu_calendar create \
    --title "【待办】xxx" \
    --start_time "2026-04-05T09:00:00+08:00" \
    --end_time "2026-04-05T18:00:00+08:00" \
    --attendees "xxx" \
    --description "里程碑：xxx\
负责人：xxx\
来源文档：https://XXX" \
    --reminder_minutes 1440

# 待办 2
feishu_calendar create \
    --title "【待办】xxx" \
    --start_time "2026-04-08T09:00:00+08:00" \
    --end_time "2026-04-08T18:00:00+08:00" \
    --attendees "xxx" \
    --description "里程碑：xxx\
负责人：xxx\
来源文档：https://XXX" \
    --reminder_minutes 1440

# ... 其他待办

输出

创建结果：

✅ 创建成功：xxx (2026-04-05)
✅ 创建成功：xxx (2026-04-08)
✅ 创建成功：xxx (2026-04-15)
✅ 创建成功：xxx (2026-06-30)

总计：4 个日程已创建

技术配置

前置条件

1. 飞书应用权限

   • 飞书文档读取权限
   • 飞书日历创建权限
   • 飞书联系人读取权限（解析负责人）

2. 依赖

   • Python 3.8+
   • OpenClaw 2026.3.13+

错误处理

常见错误及解决方案

错误 1：文档无待办表格

错误：未找到待办表格
解决：检查文档是否包含"时间节点 | 里程碑 | 负责人"格式的表格

错误 2：时间解析失败

错误：无法解析时间"下个月"
解决：添加更多模糊时间解析规则，或手动指定日期

错误 3：负责人不在通讯录

错误： attendees "XXX" 不在通讯录
解决：使用飞书用户 ID 或 open_id 代替姓名

错误 4：日历创建失败

错误：权限不足
解决：检查飞书应用是否有日历创建权限

最佳实践

1. 时间解析规则优先级

2. 日程标题规范

【待办】+ 里程碑内容

示例：
✅ 【待办】xxx
✅ 【待办】xxx

3. 提醒设置

版本历史

许可证

MIT License

维护者

OpenClaw Community\r