工作辅助01

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

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。

配置

# 自定义数据库路径（默认：~/.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 次）保障

常见问题

提醒没有推送？

1. 检查 pa-morning-reminder 等 cronjob 是否已注册：cronjob(action='list')
2. 检查 reminder_log 表确认是否触发过提醒
3. 手动测试：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 统计信息正常