diary-assistant

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Diary Assistant

日记写作助手，提供完整的日记工作流，包含任务回顾、Work Log 自动化、启发提问和任务捕获。

Diary writing assistant that provides a complete diary workflow, including task review, Work Log automation, inspirational questioning, and task capture.

Prerequisites

Tool	Type	Required	Install
macOS	system	Yes	This skill requires macOS
reminders-cli	cli	Yes	`brew install keith/formulae/reminders-cli`
schedule-manager	skill	Yes	Included in `npx skills add niracler/skill`
worklog	skill	No	Included in `npx skills add niracler/skill`
anki-card-generator	skill	No	Included in `npx skills add niracler/skill`

Do NOT proactively verify these tools on skill load. If a command fails due to a missing tool, directly guide the user through installation and configuration step by step.

Tool	Type	Required	Install
macOS	system	Yes	This skill requires macOS
reminders-cli	cli	Yes	`brew install keith/formulae/reminders-cli`
schedule-manager	skill	Yes	Included in `npx skills add niracler/skill`
worklog	skill	No	Included in `npx skills add niracler/skill`
anki-card-generator	skill	No	Included in `npx skills add niracler/skill`

Do NOT proactively verify these tools on skill load. If a command fails due to a missing tool, directly guide the user through installation and configuration step by step.

核心原则

Core Principles

原则	说明
45 分钟约束	完整流程控制在一个番茄钟内完成
GTD 集成	开始时回顾今日任务，结束时捕获新计划
启发而非代写	用提问引导思考，不替用户决定内容
工作日必须 Work Log	周一至周五自动获取，不询问

Principle	Description
45-minute Constraint	Keep the entire workflow within one Pomodoro session
GTD Integration	Review today's tasks at the start, capture new plans at the end
Inspire Instead of Write for User	Guide thinking through questions, don't decide content for the user
Work Log Mandatory on Workdays	Automatically retrieve on Monday to Friday, no need to ask

完整流程

Complete Workflow

text

┌─────────────────────────────────────────────────────────────────────┐
│          diary-assistant 完整流程（目标 ≤45min）                     │
└─────────────────────────────────────────────────────────────────────┘

  ┌──────────────┐
  │ 用户触发日记  │
  └──────┬───────┘
         │
         ▼
  ┌────────────────────────────────────┐
  │ 1. Pre-Diary Clarification  (~1min) │
  │    确认日期：2026-01-29.md         │
  └──────┬─────────────────────────────┘
         │
         ▼
    ┌────┴──────────┐
    │ 日记文件已存在？ │
    └────┬──────────┘
      是 │         │ 否
         ▼         │
  ┌─────────────┐  │
  │ 选择模式：   │  │
  │ 继续/追加/  │  │
  │ 重新开始    │  │
  └──────┬──────┘  │
         └────┬────┘
              ▼
  ┌─────────────────────────────────────────────────────────────┐
  │ 2. 并行获取数据（subagent）                    (~2-3min)    │
  │                                                            │
  │    ┌─ Reminders (今日任务)                                 │
  │    └─ subagent: worklog skill (daily, 仅工作日)            │
  │                                                            │
  └──────┬────────────────────────────────────────────────────┘
         │
         ▼
  ┌────────────────────────────────────┐
  │ 3. 今日任务回顾（简化）    (~2min)   │
  │                                    │
  │    「今日计划 5 件事：              │
  │     1.写文档 2.修bug 3.开会...」    │
  │    「哪些完成了？输入序号」          │
  │    「未完成的延期到什么时候？」       │
  └──────┬─────────────────────────────┘
         │
         ▼
    ┌────┴────┐
    │ 是工作日？│
    └────┬────┘
     是  │      │ 否
         ▼      │
  ┌──────────┐  │
  │ Work Log │  │  整理 subagent 获取的数据
  │ 云效+GH  │  │
  └────┬─────┘  │
       └───┬────┘
           ▼
  ┌────────────────────────────────────┐
  │ 3. 启发提问（适应性）    (~20-25min) │
  │                                    │
  │    工作日：                         │
  │    Q1「工作之外还有什么想记录的？」  │
  │    Q2「之后有什么计划？」           │
  │                                    │
  │    周末：                           │
  │    Q1「今天做了什么？」             │
  │    Q2「有什么收获或感受？」         │
  │    Q3「之后有什么计划？」           │
  │                                    │
  │    → 计划直接解析为 Reminders       │
  └──────┬─────────────────────────────┘
         │
         ▼
  ┌────────────────────────────────────┐
  │ 4. 整理成文              (~10min)   │
  └──────┬─────────────────────────────┘
         │
         ▼
  ┌────────────────────────────────────┐
  │ 5. 智能收尾              (~0-5min)  │
  │    检测到 TIL → 「要生成 Anki 吗？」│
  └──────┬─────────────────────────────┘
         │
         ▼
      ┌──────┐
      │ 完成  │  总计 ~35-45min
      └──────┘

text

┌─────────────────────────────────────────────────────────────────────┐
│          diary-assistant Complete Workflow (Goal ≤45min)           │
└─────────────────────────────────────────────────────────────────────┘

  ┌──────────────┐
  │ User Triggers Diary │
  └──────┬───────┘
         │
         ▼
  ┌────────────────────────────────────┐
  │ 1. Pre-Diary Clarification  (~1min) │
  │    Confirm Date: 2026-01-29.md         │
  └──────┬─────────────────────────────┘
         │
         ▼
    ┌────┴──────────┐
    │ Does the diary file exist? │
    └────┬──────────┘
      Yes │         │ No
         ▼         │
  ┌─────────────┐  │
  │ Select Mode:   │  │
  │ Continue/Append/  │  │
  │ Restart    │  │
  └──────┬──────┘  │
         └────┬────┘
              ▼
  ┌─────────────────────────────────────────────────────────────┐
  │ 2. Parallel Data Retrieval (subagent)                    (~2-3min)    │
  │                                                            │
  │    ┌─ Reminders (Today's Tasks)                                 │
  │    └─ subagent: worklog skill (daily, workdays only)            │
  │                                                            │
  └──────┬────────────────────────────────────────────────────┘
         │
         ▼
  ┌────────────────────────────────────┐
  │ 3. Today's Task Review (Simplified)    (~2min)   │
  │                                    │
  │    "5 planned tasks for today:              │
  │     1.Write docs 2.Fix bugs 3.Attend meeting..."    │
  │    "Which are completed? Enter serial numbers like '1,3'"          │
  │    "When to reschedule the uncompleted ones?"       │
  └──────┬─────────────────────────────┘
         │
         ▼
    ┌────┴────┐
    │ Is it a workday?│
    └────┬────┘
     Yes  │      │ No
         ▼      │
  ┌──────────┐  │
  │ Work Log │  │  Organize data retrieved by subagent
  │ CloudEffect+GH  │  │
  └────┬─────┘  │
       └───┬────┘
           ▼
  ┌────────────────────────────────────┐
  │ 3. Inspirational Questioning (Adaptive)    (~20-25min) │
  │                                    │
  │    Workdays:                         │
  │    Q1"What else do you want to record besides work?"  │
  │    Q2"What are your future plans?"           │
  │                                    │
  │    Weekends:                           │
  │    Q1"What did you do today?"             │
  │    Q2"What gains or feelings do you have?"         │
  │    Q3"What are your future plans?"           │
  │                                    │
  │    → Plans are directly parsed into Reminders       │
  └──────┬─────────────────────────────┘
         │
         ▼
  ┌────────────────────────────────────┐
  │ 4. Organize into Text              (~10min)   │
  └──────┬─────────────────────────────┘
         │
         ▼
  ┌────────────────────────────────────┐
  │ 5. Intelligent Wrap-up              (~0-5min)  │
  │    Detect TIL → "Want to generate Anki cards?"│
  └──────┬─────────────────────────────┘
         │
         ▼
      ┌──────┐
      │ Completed  │  Total ~35-45min
      └──────┘

1. Pre-Diary Clarification

开始前确认日期和文件：

text

Claude: 「今天的日记是 2026-01-29.md 吗？」
用户: 「是」/ 「不是，是昨天的」

Confirm date and file before starting:

text

Claude: "Is today's diary 2026-01-29.md?"
User: "Yes" / "No, it's yesterday's"

文件已存在处理

Handling Existing Files

如果文件已存在，提供选项：

选项	说明
继续	在现有内容基础上继续编辑
追加	在文件末尾添加新内容
重新开始	清空重写（会确认）

If the file already exists, provide options:

Option	Description
Continue	Continue editing based on existing content
Append	Add new content at the end of the file
Restart	Clear and rewrite (confirmation required)

2. 今日任务回顾（简化版）

2. Today's Task Review (Simplified Version)

调用

schedule-manager

获取今日 Reminders，然后批量确认：

text

今日计划的 5 件事：
1. 写文档
2. 修 bug
3. 开会
4. 回复邮件
5. 复习英语

哪些完成了？（输入序号，如「1,3」，或「全部」/「都没完成」）

处理逻辑：

用户说「1,3」→ 标记 1、3 为完成，追问「2、4、5 延期到什么时候？」
用户说「全部」→ 全部标记完成
用户说「都没完成」→ 追问「延期到什么时候？」

延期时间解析：

「明天」→ tomorrow
「后天」→ 2 days
「周五」→ friday
「下周」→ next monday

无任务时跳过此步骤。

Call

schedule-manager

to retrieve today's Reminders, then confirm in batch:

text

5 planned tasks for today:
1. Write docs
2. Fix bugs
3. Attend meeting
4. Reply to emails
5. Review English

Which are completed? (Enter serial numbers like "1,3", or "All" / "None")

Processing Logic:

User inputs "1,3" → Mark 1 and 3 as completed, ask "When to reschedule 2,4,5?"
User inputs "All" → Mark all as completed
User inputs "None" → Ask "When to reschedule them?"

Reschedule Time Parsing:

"Tomorrow" → tomorrow
"The day after tomorrow" → 2 days
"Friday" → friday
"Next week" → next monday

Skip this step if there are no tasks.

命令参考

Command Reference

bash

undefined

bash

undefined

获取今日任务

Retrieve today's tasks

reminders show-all --due-date today

完成任务

Complete task

reminders complete "<列表名>" <index>

reminders complete "<List Name>" <index>

延期到指定日期（删除后重建）

Reschedule to specified date (delete then recreate)

reminders delete "<列表名>" <index> reminders add "<列表名>" "<任务名>" --due-date "<用户指定的日期>"

undefined

reminders delete "<List Name>" <index> reminders add "<List Name>" "<Task Name>" --due-date "<User-specified Date>"

undefined

3. Work Log 自动化

3. Work Log Automation

工作日（周一至周五）自动执行，不询问。周末跳过，直接进入启发提问。

调用

worklog

skill（daily 模式）获取当日工作回顾，将输出直接嵌入日记的 Work Log 部分。

在步骤 2 中已通过 subagent 并行启动 worklog skill，此处使用其结果。

worklog skill 会自动整合本地 git 统计、GitHub 和云效数据，输出结构化 Markdown（概览 + 按项目明细 + Bug 跟踪）。

如果 worklog skill 不可用，可手动回顾当天的工作内容。

Automatically execute on workdays (Monday to Friday) without asking. Skip on weekends and proceed directly to inspirational questioning.

Call

worklog

skill (daily mode) to retrieve today's work review, and embed the output directly into the Work Log section of the diary.

The worklog skill was started in parallel via subagent in Step 2, use its results here.

The worklog skill automatically integrates local git statistics, GitHub and CloudEffect data, and outputs structured Markdown (Overview + Project-specific Details + Bug Tracking).

If worklog skill is unavailable, manually review the day's work content.

4. 启发提问（适应性）

4. Inspirational Questioning (Adaptive)

根据工作日/周末问不同的问题：

Ask different questions based on workdays/weekends:

工作日（Work Log 已记录工作内容）

Workdays (Work Log has recorded work content)

顺序	问题
Q1	「工作之外，今天还有什么想记录的？」
Q2	「之后有什么计划？」

Order	Question
Q1	"What else do you want to record besides work?"
Q2	"What are your future plans?"

周末（无 Work Log）

Weekends (No Work Log)

顺序	问题
Q1	「今天做了什么？」
Q2	「有什么收获或感受？」
Q3	「之后有什么计划？」

Order	Question
Q1	"What did you do today?"
Q2	"What gains or feelings do you have?"
Q3	"What are your future plans?"

提问节奏

Questioning Rhythm

text

Claude: 「工作之外，今天还有什么想记录的？」
用户: [回答]
Claude: [确认/追问] → 「好的，下一个问题：之后有什么计划？」

text

Claude: "What else do you want to record besides work?"
User: [Answer]
Claude: [Confirm/Follow-up] → "Okay, next question: What are your future plans?"

5. 任务捕获

5. Task Capture

最后一个问题「之后有什么计划？」的回答会自动解析为任务：

The answer to the last question "What are your future plans?" will be automatically parsed into tasks:

日期解析示例

Date Parsing Examples

用户输入	解析结果
「明天要交报告」	明天
「周五开会」	本周五
「下周一复习」	下周一
「月底前提交」	本月最后一天
「下个月初」	下月 1 号

User Input	Parsed Result
"Need to submit report tomorrow"	tomorrow
"Attend meeting on Friday"	This Friday
"Review on next Monday"	Next Monday
"Submit by end of month"	Last day of this month
"Early next month"	1st day of next month

确认后创建

Create After Confirmation

text

Claude: 「检测到以下计划，确认创建到 Reminders 吗？」
  - 明天：交报告
  - 周五：开会

用户: 「好」

Claude: [调用 schedule-manager 创建]

bash

reminders add "提醒" "交报告" --due-date "tomorrow"
reminders add "提醒" "开会" --due-date "friday"

text

Claude: "Detected the following plans, confirm to create in Reminders?"
  - Tomorrow: Submit report
  - Friday: Attend meeting

User: "Yes"

Claude: [Call schedule-manager to create]

bash

reminders add "Reminders" "Submit report" --due-date "tomorrow"
reminders add "Reminders" "Attend meeting" --due-date "friday"

6. 智能收尾

6. Intelligent Wrap-up

根据日记内容推荐后续操作：

检测内容	推荐操作
TIL（今天学到的东西）	「检测到你今天学了新东西，要生成 Anki 卡片吗？」→ 调用 `anki-card-generator`

注意： 日记存储在 Obsidian（iCloud 同步），不需要 git 提交。

Recommend follow-up actions based on diary content:

Detected Content	Recommended Action
TIL (Today I Learned)	"Detected you learned something new today, want to generate Anki cards?" → Call `anki-card-generator`

Note: Diaries are stored in Obsidian (synced via iCloud), no need for git commit.

时间预算

Time Budget

步骤	时间
确认日期 + 文件处理	~1 min
任务回顾（简化）	~2 min
Work Log（自动）	~2-3 min
启发提问（含计划）	~20-25 min
整理成文	~10 min
智能收尾（可选）	~0-5 min
总计	~35-45 min

Step	Time
Confirm Date + File Processing	~1 min
Task Review (Simplified)	~2 min
Work Log (Automatic)	~2-3 min
Inspirational Questioning (Including Plans)	~20-25 min
Organize into Text	~10 min
Intelligent Wrap-up (Optional)	~0-5 min
Total	~35-45 min

用户配置

User Configuration

见 user-config.md 配置日记路径和工作仓库。

See user-config.md to configure diary path and work repositories.