Task Sync_AI Agent skill-PHP中文网

Task Sync

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

双向同步滴答清单与 Google Tasks，支持清单/项目映射、任务内容与完成状态同步以及智能清单导出。用于处理 OAuth 设置、同步执行、任务不一致或重复问题的排查。

任务同步 : 操作和故障排除双向任务同步在 TickTick 和 Google 任务之间.

功能概述

任务同步 : 操作和故障排除双向任务同步在 TickTick 和 Google 任务之间.是一项面向实际任务的技能，主要用于Setup Check : Python 3.10+ , 使用: google- auth- oth- oathlib google- api- python- client req。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

使用与执行

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

任务同步

操作并排查 TickTick 与 Google Tasks 之间的双向任务同步问题。

运行

python {baseDir}/sync.py

配置检查清单

安装 Python 3.10 或更高版本，并确保已安装以下依赖：google-auth google-auth-oauthlib google-api-python-client requests

启用 Google Tasks API，然后运行：

python {baseDir}/scripts/setup_google_tasks.py

在 TickTick 开发者平台创建应用，然后运行：
```
python {baseDir}/scripts/setup_ticktick.py
```
配置 {baseDir}/config.json 中的 token 和数据路径。

预期行为

按名称匹配，同步 Google Task 列表 <-> TickTick 项目。
任务标题、完成状态及备注/内容支持双向同步。
将 TickTick 优先级映射为 Google 任务标题前缀：[★] 表示高优先级，[!] 表示中优先级。
将 TickTick 智能列表（Today、Next 7 Days、All）单向导出至 Google Tasks。

截止日期规则（日历重复项）

仅在 “All” 智能列表中保留截止日期。
对于其他已同步的列表，将截止日期同步至 TickTick 后，清除 Google Tasks 中对应的截止日期。
调试日历重复项时，请将此规则视为事实来源（source-of-truth rule）。

自动化

# Cron：每 10 分钟执行一次
*/10 * * * * /path/to/python {baseDir}/sync.py >> /path/to/sync.log 2>&1

如可用，请使用 OpenClaw cron。

故障排查流程

若出现认证错误，请重新运行两个 OAuth 配置脚本。
确认 config.json 中的路径指向有效的 token 文件。
运行 python {baseDir}/sync.py，并检查 sync_log.json 和 sync_db.json。
检查 API 封装模块：
- {baseDir}/utils/google_api.py
- {baseDir}/utils/ticktick_api.py