工作辅助01

个人工作任务管理助手。使用场景：记录待办事项、查看今日任务、更新任务进展、管理周期性任务、同步 OKR、生成工作月报/半年报。触发关键词：任务、待办、提醒、进展、OKR、月报、周报、报告。显式触发命令：ZHULI#。

Install

openclaw skills install @tomm1399/gongzuofuzhu01

Personal Assistant — 个人工作任务管理

一站式管理你的工作任务、OKR、周期事项和进展汇报。

概述

Personal Assistant 是一个个人工作任务管理技能，通过 CLI 脚本 scripts/personal_assistant.py 操作本地 SQLite 数据库，支持任务的增删改查、进展跟踪、周期任务管理、OKR 同步和自动报告生成。

触发条件

当用户消息包含以下意图时自动加载本技能：

输入 ZHULI# 显式触发
记录/添加/创建任务或待办事项
查看今日/明天/本周任务列表
更新任务状态或进展
管理周期/定期/重复任务
同步或查看 OKR
生成工作月报/半年报/周报
手动触发任务提醒

快速开始

添加任务

在对话中自然描述即可，Agent 会自动调用本技能的 CLI 工具：

"帮我记一下：周五前完成 Q2 述职 PPT，优先级高" "添加任务：修复登录 bug，明天中午前完成"

查看任务

"今天有哪些待办？" "列出所有进行中的高优先级任务"

更新进展

"任务 #42 进展更新为 60%，已完成数据收集" "把修复登录 bug 标记为完成"

生成报告

"生成本月工作月报" "生成 2026 上半年工作报告"

定时提醒

技能注册了 5 个 cronjob，自动推送提醒和同步：

任务名称	Cron 表达式	说明
`pa-morning-reminder`	`0 9 * * 1-5`	☀️ 工作日上午 9:00 — 今日待办概览
`pa-afternoon-reminder`	`0 14 * * 1-5`	🌤️ 工作日下午 14:00 — 下午任务提醒 + 进度检查
`pa-evening-reminder`	`0 20 * * *`	🌙 每天 20:00 — 明日预告 + 今日完成总结
`pa-recurring-sync`	`0 1 * * *`	🔄 每天凌晨 1:00 — 自动生成周期任务实例
`pa-okr-sync`	`0 10 * * 1`	📊 每周一 10:00 — 从飞书文档同步 OKR

提醒内容包含：任务列表（按优先级和截止时间排序）、OKR 关联进展、个性化的日程安排建议。

可用工具

本技能的核心 CLI 入口为 scripts/personal_assistant.py，子命令如下：

命令	说明
`task add`	添加新任务（使用 `--parent-id` 可创建子任务）
`task list`	列表查询（支持按状态、分类、优先级过滤）
`task today`	查看今日待办
`task show <id>`	查看任务详情
`task update <id>`	更新任务字段
`task done <id>`	完成任务
`task delete <id>`	删除任务
`task search <keyword>`	搜索任务
`progress log <id>`	记录任务进展
`progress history <id>`	查看进展历史
`progress milestone-add <id>`	添加里程碑
`progress milestone-done <id>`	完成里程碑
`progress milestone-list <id>`	列出里程碑
`progress timeline`	查看进展时间线
`recurring add`	添加周期任务
`recurring list`	列出周期任务
`recurring generate`	手动生成周期任务实例
`recurring toggle <id>`	暂停/恢复周期任务
`recurring delete <id>`	删除周期任务
`okr add-objective`	添加 Objective
`okr add-kr`	添加 Key Result
`okr list`	查看 OKR 列表
`okr show <id>`	查看 OKR 详情及关联任务
`okr tree`	查看 OKR 全景树
`okr link`	关联任务到 OKR
`okr sync`	从飞书文档同步 OKR
`remind trigger`	手动触发提醒
`remind preview`	预览待提醒任务（dry-run）
`remind history`	查看提醒历史
`report monthly`	生成月度报告
`report semiannual`	生成半年度报告
`advice`	生成 LLM 智能建议上下文
`db stats`	查看数据库统计信息
`db export`	数据导出（JSON）
`db import`	数据导入
`db cleanup`	清理历史数据

详细用法参见 references/commands.md。

数据存储

所有数据存储在 ~/.hermes/data/personal_assistant/tasks.db（SQLite），包含 6 张表：

表名	用途
`tasks`	核心任务表（标题、状态、优先级、截止时间、进展等）
`milestones`	任务里程碑
`progress_logs`	进展日志
`recurring_tasks`	周期任务模板
`okr_items`	OKR 本地缓存
`reminder_log`	提醒推送记录（去重）

数据库支持 WAL 模式、自动迁移和 JSON 导出备份。数据模型详见 references/schema.md。

配置

bash

# 自定义数据库路径（默认：~/.hermes/data/personal_assistant/tasks.db）
export PA_DB_PATH=~/.hermes/data/personal_assistant/tasks.db

# 提醒时段（覆盖默认值）
export PA_MORNING_TIME=9
export PA_AFTERNOON_TIME=14
export PA_EVENING_TIME=20

# OKR 飞书文档 token
export PA_OKR_DOC_TOKEN=YOUR_DOC_TOKEN_HERE

# 报告输出目录（默认：~/.hermes/reports/）
export PA_REPORT_DIR=~/.hermes/reports/

注意事项

所有时间使用 北京时间 (UTC+8)
任务删除默认为软删除（status → 'cancelled'），使用 --hard 可物理删除
OKR 同步依赖飞书文档可读，需确保 bot 有文档访问权限；同步失败时保留最近一次成功缓存
报告默认输出到 ~/.hermes/reports/ 目录
数据库文件自动创建，无需手动初始化
并发写入通过 SQLite WAL 模式 + 自动重试（最多 3 次）保障

常见问题

提醒没有推送？

检查 pa-morning-reminder 等 cronjob 是否已注册：cronjob(action='list')
检查 reminder_log 表确认是否触发过提醒
手动测试：python3 scripts/personal_assistant.py remind trigger --type morning

周期任务没有自动生成实例？

pa-recurring-sync cronjob 每天凌晨 1:00 运行
手动触发：python3 scripts/personal_assistant.py recurring list 查看待生成的周期任务
检查 recurring_tasks.enabled 是否为 1

OKR 同步失败？

确认 PA_OKR_DOC_TOKEN 环境变量已设置
确认飞书 bot 对目标文档有读取权限
查看错误日志：~/.hermes/logs/agent.log

验证检查清单

~/.hermes/data/personal_assistant/tasks.db 数据库已创建
python3 scripts/personal_assistant.py task add --title "测试任务" 可成功添加
python3 scripts/personal_assistant.py task list 可列出任务
python3 scripts/personal_assistant.py remind preview --type morning 可预览提醒
cronjob 已通过 cronjob(action='create', ...) 注册
python3 scripts/personal_assistant.py db stats 统计信息正常