--- name: openclaw-timebox-cpr description: 基于潘农菲翻译的《时间盒》,为 OpenClaw 打造的全天任务执行系统。早晨用一段对话规划全天、讨论优先级、锁定时间盒;执行时 AI 完全不打扰;每盒结束做 30 秒快速收集;全天结束生成每日总结并自动同步到 Flomo、Notion 等工具。支持苹果日历、飞书、Google 日历自动占位,以及将时间盒任务双向同步到滴答清单(TickTick)。触发词:"时间盒"、"timebox"、"开始今天的规划"、"帮我规划任务"、"start timebox"、"task planning"。 version: 2.7.0 metadata: author: vincent based_on: OpenClaw Timebox 工作法 --- # OpenClaw Timebox 一套**全天维度**的任务管理工作法,分四个阶段: ``` 早晨规划(PLAN)→ 执行时间盒(RUN)→ 单盒收集(CHECK)→ 全天复盘(REVIEW) ``` 每个时间盒是一个**不可拆分的执行单元**,AI 不干预盒内执行细节,只负责规划、衔接和复盘。 --- ## 使用方式 ```bash /openclaw-timebox-cpr # 开始今天的规划 /openclaw-timebox-cpr --run # 跳过规划,直接开始一个时间盒 /openclaw-timebox-cpr --check # 完成一个时间盒后做快速收集 /openclaw-timebox-cpr --review # 全天结束后做整体复盘 /openclaw-timebox-cpr --log # 查看今日日志摘要 ``` --- ## 偏好配置(EXTEND.md) 按优先级搜索以下路径,找到即用: 1. 项目级:`{project}/.baoyu-skills/openclaw-timebox-cpr/EXTEND.md` 2. 用户级:`~/.baoyu-skills/openclaw-timebox-cpr/EXTEND.md` **如果 EXTEND.md 不存在,MUST 执行首次配置(见下方章节),完成后继续。** ```yaml default_timebox: 25 # 默认单个时间盒时长(分钟) calendar: macos # 日历工具(见支持列表) calendar_name: 工作 # 日历名称/账户 calendar_alert_before: 2 # 提醒提前几分钟 log_backend: local # 日志工具(见支持列表) log_dir: ~/.openclaw/logs # 仅 local 模式使用 log_token: # 第三方日志工具的 Token/Key(如需要) log_workspace: # 第三方日志工具的空间/数据库 ID(如需要) task_sync: none # 任务同步:ticktick(国际版)| dida365(中国版,使用 dida-cli)| none ticktick_token_file: ~/.config/timebox/ticktick.json # ticktick 国际版 token 文件路径 ticktick_project_id: # ticktick 国际版:同步到哪个清单(留空则用收件箱) dida_project_id: # dida365 中国版:同步到哪个清单 ID(留空则用收件箱) lang: zh # zh | en runtime: codebuddy # 运行环境:codebuddy | openclaw ``` --- ## 首次配置 EXTEND.md 不存在时,**一次性**提问以下四项,创建文件后继续。 ### 问题 1:默认时间盒时长 > 你常用的专注时长是多少分钟? > 推荐:**25 分钟**(番茄钟)/ **45 分钟**(深度工作)/ **90 分钟**(长任务)/ 自定义 ### 问题 2:日历工具 > 你用哪个日历记录时间安排?时间盒会自动在日历里创建占位事件。 | 选项 | 说明 | |------|------| | `macos` | 苹果日历(Apple Calendar),本地,无需配置 | | `wecom` | 企业微信日历,需要企业微信登录态 | | `feishu` | 飞书日历,需要飞书 API Token | | `google` | Google 日历,需要 Google OAuth | | `none` | 不使用日历 | 选择后追问: - 若 `macos`:使用哪个日历名称?(默认"工作",不存在则用默认日历) - 若 `feishu` / `google` / `wecom`:需要提供对应 Token 或引导完成授权 ### 问题 3:任务同步到滴答清单(TickTick) > 是否将每个时间盒任务自动同步到滴答清单?规划时创建任务,完成时标记勾选。 | 选项 | 说明 | |------|------| | `ticktick` | 同步到 TickTick **国际版**(ticktick.com) | | `dida365` | 同步到滴答清单**中国版**(dida365.com,使用 dida-cli) | | `none` | 不同步(默认)| > ⚠️ **国际版与中国版账号完全独立,token 不互通**,请根据你的实际登录平台选择。 --- #### 若选择 `dida365`(中国版,推荐) 使用 [dida-cli](https://clawhub.ai/ilooch/dida-cli) 方案,无需注册开发者 App,一条命令完成授权。 **Step 1:检查 dida-cli 是否已安装且已登录** ```bash dida auth status ``` - 输出已登录 → 跳到 Step 3 - 命令不存在 → 继续 Step 2 安装 - 输出未登录 → 直接执行 Step 2 登录 **Step 2:安装 dida-cli 并授权** ```bash npm install -g @suibiji/dida-cli dida auth login ``` 浏览器弹出滴答清单授权页,登录并授权后返回命令行即完成。授权完成后再次执行 `dida auth status` 确认。 **Step 3:选择同步清单** > "要同步到哪个清单?(留空用收件箱,或告诉我清单名称)" AI 拉取用户现有清单并展示: ```bash dida project list --json ``` 用户选择后,将清单 ID 写入 `dida_project_id`(留空则用收件箱)。 --- #### 若选择 `ticktick`(国际版) **Step 1:检查 token 是否已存在且有效** ```bash python3 -c " import json, urllib.request try: t = json.load(open('$HOME/.config/timebox/ticktick.json')) req = urllib.request.Request('https://api.ticktick.com/open/v1/project') req.add_header('Authorization', f'Bearer {t[\"access_token\"]}') urllib.request.urlopen(req); print('ok') except Exception as e: print('fail') " ``` - 输出 `ok` → 跳到 Step 4 - 输出 `fail` → 继续 Step 2 **Step 2:引导注册开发者 App(首次必做,约 3 分钟)** AI 告知用户: > "需要先在 TickTick 开放平台注册一个 App,获取 client_id 和 client_secret,整个过程约 3 分钟,只需做一次。 > > 请按以下步骤操作: > 1. 访问 https://developer.ticktick.com/ 用 TickTick 账号登录 > 2. 点击「Register App」 > 3. App Name 随意填(如 `timebox-local`) > 4. Redirect URI 填:`http://localhost:8765/callback` > 5. 提交后复制 **Client ID** 和 **Client Secret**,告诉我。" **Step 3:写入授权脚本并执行** AI 收到 client_id 和 client_secret 后,将授权脚本写入 `~/.config/timebox/ticktick_auth.py`(填入真实 credentials,见滴答清单集成章节脚本模板),然后告知用户运行: ```bash python3 ~/.config/timebox/ticktick_auth.py ``` 用户完成浏览器授权后,AI 重新执行 Step 1 验证。 **Step 4:选择同步清单** > "要同步到哪个清单?(留空用收件箱,或告诉我清单名称)" ```bash python3 -c " import json, urllib.request t = json.load(open('$HOME/.config/timebox/ticktick.json')) req = urllib.request.Request('https://api.ticktick.com/open/v1/project') req.add_header('Authorization', f'Bearer {t[\"access_token\"]}') data = json.loads(urllib.request.urlopen(req).read()) for p in data: print(p['id'], '|', p['name']) " ``` 用户选择后,将清单 ID 写入 `ticktick_project_id`(留空则用收件箱)。 ### 问题 4:日志工具 > 你用什么记录工作日志?每个时间盒的执行记录和复盘会自动写入。 | 选项 | 说明 | |------|------| | `local` | 本地 Markdown 文件(默认,无需配置)| | `feishu_doc` | 飞书文档,需要飞书 API Token + 文档 ID | | `wecom_doc` | 企业微信文档,需要企业微信登录态 | | `notion` | Notion,需要 Integration Token + Database ID | | `google_doc` | Google Docs,需要 Google OAuth | | `flomo` | Flomo,需要 Flomo API URL(在 Flomo 个人设置页面获取)| 选择后追问对应的 Token / ID / 路径配置项(若需要)。 ### 问题 5:交互语言 > 中文 / English --- ## 日历集成 ### 通用行为 - PLAN 阶段时间分配确认后,为每个时间盒批量创建日历事件 - 事件标题格式:`[Timebox #{N}] {任务名}` - 事件描述:任务名 + 优先级 + 紧急程度 - CHECK 收集完成后,更新对应事件备注(追加实际完成情况) - **任何日历操作失败,仅提示,不阻断主流程** ### 各平台实现 **macOS Apple Calendar(AppleScript)** ```applescript tell application "Calendar" set targetCal to first calendar whose name is "{calendar_name}" -- 若不存在则用 first calendar whose writable is true tell targetCal make new event with properties { summary: "[Timebox #{N}] {任务名}", start date: {开始时间}, end date: {开始时间} + {时长} * minutes, description: "优先级:{priority} · 紧急程度:{urgency}" } end tell end tell ``` **飞书日历(Feishu Calendar API)** ``` # 请求方式:POST # 接口:https://open.feishu.cn/open-apis/calendar/v4/calendars/{calendar_id}/events # 请求头:需携带飞书 API Token(header: X-Token: {log_token}) # 请求体: { "summary": "[Timebox #{N}] {任务名}", "start_time": { "timestamp": "{unix_ts}" }, "end_time": { "timestamp": "{unix_ts}" }, "description": "优先级:{priority} · 紧急程度:{urgency}" } ``` **企业微信日历(WeCom)** > 企业微信日历暂无开放 API,使用 AppleScript 控制企业微信桌面端或提示用户手动创建。 **Google Calendar API** ``` # 请求方式:POST # 接口:https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events # 请求头:需携带 Google OAuth Token(header: X-Token: {oauth_token}) # 请求体: { "summary": "[Timebox #{N}] {任务名}", "start": { "dateTime": "{ISO8601}" }, "end": { "dateTime": "{ISO8601}" } } ``` --- ## 日志集成 ### 通用行为 - 每天在 PLAN 阶段确认时间分配后,创建当日日志并写入今日规划 - RUN 阶段每个时间盒启动时,追加启动记录到本地日志 - CHECK 阶段收集每个时间盒结果后,追加结果记录到本地日志 - REVIEW 阶段将每日总结写入本地日志 - **外部工具同步(flomo、Notion 等)**:仅在 REVIEW 完成后推送每日总结,不推送逐条执行记录 - **任何日志写入失败,仅提示,不阻断主流程** ### 各平台实现 **本地 Markdown(local)** 存储结构: ``` {log_dir}/ ├── {YYYY-MM}/ │ └── {YYYY-MM-DD}.md └── index.md ``` **飞书文档(feishu_doc)** ``` POST https://open.feishu.cn/open-apis/docx/v1/documents/{document_id}/blocks -- 在指定文档末尾追加当天日志块 ``` **企业微信文档(wecom_doc)** > 通过企业微信文档 API 写入,需要企业自建应用 Token。 **Notion** ``` # 请求方式:POST # 接口:https://api.notion.com/v1/pages # 请求头:需携带 Notion Integration Token(header: X-Token: {log_token}) # 在指定 Database 创建新 Page,每天一条 # 追加内容通过 PATCH blocks endpoint 实现 ``` **Google Docs** ``` # 通过 Google Docs API batchUpdate 在文档末尾追加内容 # 接口:https://docs.googleapis.com/v1/documents/{documentId}:batchUpdate ``` **Flomo** ``` # 请求方式:POST # 接口:{flomo_api_url}(在 Flomo 个人设置中获取) # 请求体:{ "content": "[Timebox #{N}] {任务名}\n{执行记录}\n{复盘内容}" } # Flomo 每条为独立笔记,建议每个时间盒一条,复盘单独一条 ``` --- ## 滴答清单(TickTick / 滴答清单)集成 > 仅当 `task_sync: ticktick` 或 `task_sync: dida365` 时生效。 ### 国际版 vs 中国版 | | 国际版(ticktick) | 中国版(dida365) | |--|--|--| | 授权方式 | Python OAuth 脚本(需注册 App) | dida-cli(`dida auth login`,无需注册 App) | | 任务操作 | REST API(`api.ticktick.com`) | `dida task` CLI 命令 | | 清单配置字段 | `ticktick_project_id` | `dida_project_id` | > **两个版本账号独立,token 不互通。** --- ### dida365(中国版)—— 使用 dida-cli 所有操作通过 `@suibiji/dida-cli` 完成,无需手动管理 token。 #### 通用行为 - PLAN 阶段确认时间分配后,为每个时间盒**创建对应任务** - CHECK 阶段收集完毕后,**更新任务**(追加 CHECK 结果到 content) - REVIEW 完成后,将完成的时间盒任务**标记为已完成** - 未完成的时间盒任务保留在清单中,便于次日处理 - **任何 dida-cli 操作失败,仅提示,不阻断主流程** #### 检查 dida-cli 可用性 每次操作前先确认 CLI 已安装且已登录: ```bash dida auth status ``` 若未登录,提示用户执行 `dida auth login`;若未安装,提示先运行 `npm install -g @suibiji/dida-cli`。 #### 创建时间盒任务(PLAN 完成时) ```bash dida task create \ --title "[Timebox #{N}] {任务名}" \ --project {dida_project_id} \ --content "优先级:{priority} · 紧急程度:{urgency}\n计划时间:{HH:MM},时长 {duration} 分钟" \ --dueDate "{ISO8601_end}" \ --json ``` > `--project` 留空则创建到收件箱(dida_project_id 为空时省略该参数)。 > 从返回 JSON 中取 `id` 字段,写入日志:`[ticktick_id: {id}]` #### 更新任务(CHECK 完成时) 从日志取出该时间盒的 `ticktick_id`(即 dida task id): ```bash dida task update {task_id} \ --project {dida_project_id} \ --content "原有 content\n\n── CHECK 结果 ──\n{结果}\n{一句话描述}\n实际用时:{N} 分钟(计划 {M} 分钟)" ``` #### 标记完成(REVIEW 完成时) ```bash dida task complete {dida_project_id} {task_id} ``` --- ### ticktick(国际版)—— 使用 REST API #### 运行时配置 ```python API_BASE = "https://api.ticktick.com/open/v1" ``` #### 通用行为 - PLAN 阶段确认时间分配后,为每个时间盒**创建对应任务** - CHECK 阶段收集完毕后,**更新任务** - REVIEW 完成后,将完成的时间盒任务**标记为已完成** - 未完成的时间盒任务保留在清单中 - **任何 API 调用失败,仅提示,不阻断主流程** #### Token 读取 每次调用前从 `ticktick_token_file` 读取 access_token: ```python import json, os token_data = json.load(open(os.path.expanduser(ticktick_token_file))) access_token = token_data["access_token"] headers = {"Authorization": f"Bearer {access_token}", "Content-Type": "application/json"} ``` 若读取失败或文件不存在,提示用户重新运行 `ticktick_auth.py`。 #### 创建时间盒任务(PLAN 完成时) ```python # POST {API_BASE}/task payload = { "title": "[Timebox #{N}] {任务名}", "content": "优先级:{priority} · 紧急程度:{urgency}\n计划时间:{HH:MM},时长 {duration} 分钟", "startDate": "{ISO8601_start}", "dueDate": "{ISO8601_end}", "priority": {ticktick_priority}, # 高→3, 中→1, 低→0 "projectId": "{ticktick_project_id}", # 留空用收件箱 "tags": ["timebox"] } # 返回值取 task["id"] 存入日志:[ticktick_id: {task_id}] ``` #### 更新任务(CHECK 完成时) ```python # POST {API_BASE}/task/{taskId} payload = { "id": "{task_id}", "projectId": "{ticktick_project_id}", "content": "原有 content\n\n── CHECK 结果 ──\n{结果}\n{一句话描述}\n实际用时:{N} 分钟(计划 {M} 分钟)" } ``` #### 标记完成(REVIEW 完成时) ```python # POST {API_BASE}/task/{taskId}/complete # 无需 body,返回 200 即成功 ``` ### 授权脚本(ticktick 国际版专用) 脚本存放在 `~/.config/timebox/ticktick_auth.py`: ```python #!/usr/bin/env python3 """TickTick 国际版一次性 OAuth 授权脚本 - 由 timebox skill 自动生成""" import http.server, webbrowser, json, urllib.parse, urllib.request, base64, threading, sys from pathlib import Path CLIENT_ID = "{user_client_id}" CLIENT_SECRET = "{user_client_secret}" REDIRECT_URI = "http://localhost:8765/callback" TOKEN_FILE = Path.home() / ".config" / "timebox" / "ticktick.json" PORT = 8765 AUTH_URL = "https://ticktick.com/oauth/authorize" TOKEN_URL = "https://ticktick.com/oauth/token" received_code = None class Handler(http.server.BaseHTTPRequestHandler): def do_GET(self): global received_code params = urllib.parse.parse_qs(urllib.parse.urlparse(self.path).query) if "code" in params: received_code = params["code"][0] self.send_response(200); self.send_header("Content-type","text/html;charset=utf-8"); self.end_headers() self.wfile.write("