日周月待办联动管理系统 v6.3

环境配置

本 Skill 依赖以下环境变量（在 Claude Code 的 settings.json 中配置）：

首次使用时，系统会自动检测 $TODO_DIR 是否存在。如果不存在或缺少必要子目录（daily/projects/memory），会在用户说"早上好"时自动运行初始化脚本，无需手动操作。

⚠️ 日期校验规则

每次操作前必须确认当前日期！

当前日期获取方式：
1. 系统提示中的 currentDate
2. 或使用 dayjs().format('YYYY-MM-DD')

日期计算规则：
- 今天 = 0天
- 明天 = 1天
- 截止日期 - 今天 = 剩余天数
- 周一 = 本周第1天，周日 = 本周第7天

常见错误：

• 混淆日期（如把4月19日说成4月20日）
• 周几计算错误（如把周五说成周四）
• 剩余天数计算错误

正确做法：

• 生成待办前，先明确输出"今天是 YYYY年MM月DD日 周X"
• 涉及日期计算时，先确认再输出

⚠️ 操作优先规则

核心原则：

1. 禁止用 Write 覆盖整个文件 — 必须用 Edit 增量更新
2. 先读取后修改 — 任何写入前必须先 Read 最新内容
3. 保留已有数据 — 时间线、感悟、已完成任务、历史记录都不能丢
4. 冲突处理 — 如文件内容与预期不符，停止操作、重新读取、合并变更、告知用户

🚀 缓存优化

核心原则：生成今日待办只需读 2 个文件，不逐个读项目文件！

缓存文件

$TODO_DIR/memory/project-tasks-cache.json — 所有项目的任务摘要

缓存自动重建

触发条件：

• 缓存文件不存在
• 缓存 lastUpdated != 今天
• 缓存版本过期

重建流程：

1. 运行 python scripts/scan_projects.py
2. 缓存自动写入 memory/project-tasks-cache.json
3. lastUpdated 自动更新为今天

⚠️ 缓存过期时，必须先跑脚本再读缓存，不要手动逐文件扫描。

读取策略

📊 数据收集机制

核心原则：智能功能依赖数据积累，关键操作时自动写入数据！

数据收集触发点

数据文件说明

$TODO_DIR/memory/
├── task-time-history.json   # 任务用时历史 → 用于时间预测
└── session-context.json     # 会话上下文 → 用于多轮对话

数据收集时机

用户说"现在开始 [任务]"
  ↓
写入 session-context.json: { currentTask, startTime }

用户说"完成了"
  ↓
写入 task-time-history.json: { task, type, actual, timeSlot }

用户说"结束工作"
  ↓
同步所有项目进展

数据用途

🌅 每日工作触发

触发条件： 用户说"开始工作"、"早上好"、"开工"、"今天开始工作"

执行步骤：

1. 首次使用检测：检查 $TODO_DIR 是否存在且包含 daily/、projects/、memory/ 子目录。任一缺失则自动运行 python scripts/init_todo_dir.py，无需用户手动操作
2. 如缓存过期（lastUpdated != 今天），先运行 python scripts/scan_projects.py
3. 读取 $TODO_DIR/daily/YYYY-MM-DD.md（今天）
4. 读取 $TODO_DIR/memory/project-tasks-cache.json（缓存）
5. 检测是否有实证任务（关键词：回归、面板、Stata、数据、基准回归等，可配置）
6. 如有实证任务，随机选择一种激励风格输出
7. §11 风险预警（自动触发）：检查是否有紧急deadline（3天内）、逾期任务、效率异常，如有则在待办前输出预警
8. 输出今日任务概览

输出格式：

🌅 早上好！今天是 YYYY年MM月DD日 周X

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[激励/威胁内容 - 如有实证任务]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 今日待办提醒

⚠️ 紧急任务：
- [项目名] - 任务名（截止：今天）

📌 今日重点：
- [项目名] - 任务名

✅ 已完成：X 个
⏳ 待办：X 个

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 今日可用功能
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• "上班/下班" — 打卡记录
• "现在开始 [任务]" — 开始任务+时间预测
• "完成了" — 完成任务
• "暂停/继续" — 暂停计时
• "检查风险" — 查看截止风险
• "结束工作" — 生成今日总结

请问今天想先处理哪个任务？

功能提醒规则：

• 始终显示：打卡、开始任务、完成任务、结束工作
• 有紧急任务时：显示"检查风险"
• 有实证任务时：显示"预测"

核心功能触发表

基础操作（§0-§7）

智能功能（§8-§10）

分析功能（§10-§12）

文件操作规范

daily 文件增量规则

• ✅ 可更新：## 📋 今日待办
• ✅ AI生成：## 📝 经验教训（结束工作时AI自动生成，分类展示）
• ✅ AI提取：## 💭 今日感悟（AI从对话中提取用户非工作内容，分类展示）
• ❌ 不可覆盖：## 🕐 时间线记录、## ✅ 今日已完成
• ❌ AI绝对不碰：## 📓 今日日记（用户手写区块，AI不得修改、删除或添加内容）

⚠️ 打卡记录防重复规则（关键！）

写入打卡前必须执行以下检查：

1. Read daily/YYYY-MM-DD.md
2. 检查 ## 🕰️ 打卡记录 下已有的时段区块（上午/下午/晚上/凌晨）
3. 对同时段：更新已有数据，不追加新区块
   例：已有"### 上午 - 上班：09:00"，用户说"上午下班12:00"
   → 更新该区块的下班时间，不新建第二个"### 上午"
4. 对不同时段：追加新区块
   例：已有上午区块，用户说"下午上班14:00"
   → 在上午区块后追加"### 下午"区块
5. 绝对禁止：同一时段出现两个区块（如两个"### 上午"）

每次打卡操作后，必须验证文件中没有重复时段区块！

⚠️ 经验教训强制生成规则（关键！）

## 📝 经验教训 区块不得为空或缺失。AI在"结束工作"时自动生成，必须分类展示。

触发时机：用户说"结束工作"时，自动从今日时间线+已完成任务提炼，按类别（实证方法/工具使用/项目管理/论文写作/其他）分组，每条标记 ✅做得好的 / ⚠️需改进 / 💡新发现。禁止空区块。完整规则见 references/features.md §8-§9。

生活感悟提取规则

从 JSONL 对话中标记非工作类消息，按分类（饮食健康/情绪心理/生活习惯/日常琐事）提炼为1-2句感悟。完整规则见 references/features.md §8。

projects 文件增量规则

• ✅ 可更新：## 任务列表、## 🟡 活跃临时任务
• ❌ 不可覆盖：## 📅 时间线记录、## ✅ 历史记录、## 经验教训

操作检查清单

□ 是否已读取目标文件？
□ 是否使用 Edit 而非 Write？
□ 是否会覆盖已有数据？
□ 截止日期是否准确？
□ 格式是否符合规范？
□ 日志是否回答了：为什么做/做了什么/怎么做/结果是什么？（见下方标准）

⚠️ 日志详细程度标准（关键！）

唯一目标：几个月甚至一年后打开，只读这一条就能完全复现你的工作。

五要素（每日 + 项目通用）：目的 + 对象 + 操作 + 数据/文件 + 结果。

1. 每日日志 — 写入 daily/YYYY-MM-DD.md 的 ## 🕐 时间线记录

✅ 正确示例：

• 10:10-10:50 [项目名] - 论文§4.1图1（专利申请趋势：横轴2000-2020/纵轴申请量对数/法庭城市vs非法庭城市/2014政策虚线）。目的：DiD平行趋势视觉证据。修改：(1)Y轴→对数刻度压缩量纲差异；(2)2014年添加红色政策虚线；(3)NBER灰色衰退阴影(2008-2009)。数据：patent_main_2021.dta。产出：results/figures/fig1_trend_v3.png
• 15:00-16:00 [项目名] - 论文§5.2 H2（数智化→缓解融资约束→降低尾部风险）。回归：基准DiD基础上加入SA×Digital×Post三重交互项。数据：3src_mech.dta。代码：05_机制检验.do §3.3。结果：SA×Digital×Post系数=-0.032, t=-2.15, 5%显著，支持融资约束渠道。下一步：KZ/WW替代检验

❌ 错误示例：

• 修改fig1趋势图 — 缺目的/对象/数据/产出
• 跑机制检验 — 缺假设/设定/结果

2. 项目日志 — 写入 projects/*.md 的 ## 📅 项目日志（同样强制！）

✅ 正确示例：

### 2026-05-21
- **背景/目的**：5/19和导师开会，导师要求修改特征化事实图（9条修改意见第1-3条），当前论文在§4.1
- **做了什么**：修改fig1（专利申请趋势图）：Y轴水平值→对数刻度；添加2014年法庭设立红色竖虚线；添加NBER衰退阴影(2008-2009)。数据：patent_main_2021.dta。代码：03_特征化事实.do §1
- **结果/产出**：产出 results/figures/fig1_trend_v3.png，两组的趋势差异更清晰，满足会议要求；fig2-fig5尚未开始
- **关键决策**：Y轴对数刻度 vs 双Y轴——考虑到两组量纲差异大(10^3 vs 10^4)，对数刻度更简洁且学术界通用

自检（每日+项目通用）： (1)为什么做？(2)在论文哪部分？(3)能找到对应数据/代码吗？(4)能复现结果吗？四个必须全为"是"。

文件格式模板

完整模板见 references/file-formats.md。核心区块顺序（严格固定）：

🕰️ 打卡记录 → 🕐 时间线记录 → 📝 经验教训 → 💭 今日感悟 → 📋 今日待办 → ✅ 今日已完成 → 📋 明日待办 → 📓 今日日记

禁止出现： ## 🍅 番茄统计、## 📊 今日统计、## 🌅 明日建议

项目文件格式和缓存格式同样见 references/file-formats.md。

详细功能说明

• references/features.md — 基础功能 §0-§12 详细实现
• references/intelligence.md — 智能模块（跨对话搜索/缓存/数据收集/时间预测/风险预警）
• references/file-formats.md — 所有文件格式模板
• references/pitfalls.md — 常见错误与预防

PITFALLS — 常见错误

详见 references/pitfalls.md

核心陷阱：

1. 用 Write 覆盖整个文件 → 必须用 Edit
2. 多 Agent 同时操作冲突 → 检查修改时间
3. 截止日期信息不准确 → 向用户确认
4. 临时任务文件被清空 → 先读取再追加
5. 待办格式不正确 → 必须是 - [ ] 任务内容
6. JSONL 跨对话搜索遗漏 → 必须运行脚本扫描所有会话

📂 跨对话搜索与日志更新

⚠️ 强制第一步：跑脚本（不可跳过）

Agent 的上下文只包含当前会话。凭记忆判断"哪些项目有进展"必然遗漏并行会话的工作。

触发以下任一操作时，必须先跑脚本：

• "更新日志" / "结束工作" / "更新项目文档和日志"
• "今天干了什么" / "跨对话搜索"

python scripts/search_recent_sessions.py --days 7

# 只搜今天
python scripts/search_recent_sessions.py --today

# 只搜昨天
python scripts/search_recent_sessions.py --yesterday

脚本默认扫描 $CLAUDE_TRANSCRIPT_DIR 下的 JSONL 对话文件。可通过 --transcript-dir 参数指定目录。

脚本输出：按日期分组的用户消息摘要，每条的 session / 时间 / 文本 / 检测到的项目。Agent 据此判断每天涉及哪些项目，再逐一更新。

搜索原理

脚本扫描 $CLAUDE_TRANSCRIPT_DIR 下所有 *.jsonl，按 mtime 粗筛，提取 type: "user" 消息，按日期分组，自动检测项目关键词。过滤 skill 加载/system-reminder/command-message 等噪音。

分流规则

去重与关联

• 已有时间线不重复添加，按北京时间排序
• 通过关键词匹配判断归属，无法归类只写 daily
• 日期范围内的每一天都要检查 daily 文件是否已被更新（防止多会话覆盖）

最后更新： 2026-05-25

版本： v6.3 (开源版 — 13项功能 + 跨对话搜索)

功能数量： 13项