一站式管理你的工作任务、OKR、周期事项和进展汇报。
Personal Assistant 是一个个人工作任务管理技能，通过 CLI 脚本 scripts/personal_assistant.py 操作本地 SQLite 数据库，支持任务的增删改查、进展跟踪、周期任务管理、OKR 同步和自动报告生成。
当用户消息包含以下意图时自动加载本技能：
ZHULI# 显式触发在对话中自然描述即可，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 | 查看任务详情 |
task update | 更新任务字段 |
task done | 完成任务 |
task delete | 删除任务 |
task search | 搜索任务 |
progress log | 记录任务进展 |
progress history | 查看进展历史 |
progress milestone-add | 添加里程碑 |
progress milestone-done | 完成里程碑 |
progress milestone-list | 列出里程碑 |
progress timeline | 查看进展时间线 |
recurring add | 添加周期任务 |
recurring list | 列出周期任务 |
recurring generate | 手动生成周期任务实例 |
recurring toggle | 暂停/恢复周期任务 |
recurring delete | 删除周期任务 |
okr add-objective | 添加 Objective |
okr add-kr | 添加 Key Result |
okr list | 查看 OKR 列表 |
okr show | 查看 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/
--hard 可物理删除~/.hermes/reports/ 目录pa-morning-reminder 等 cronjob 是否已注册：cronjob(action='list')reminder_log 表确认是否触发过提醒python3 scripts/personal_assistant.py remind trigger --type morningpa-recurring-sync cronjob 每天凌晨 1:00 运行python3 scripts/personal_assistant.py recurring list 查看待生成的周期任务recurring_tasks.enabled 是否为 1PA_OKR_DOC_TOKEN 环境变量已设置~/.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(action='create', ...) 注册python3 scripts/personal_assistant.py db stats 统计信息正常共 1 个版本