> ⚠️ SKILL 源文件保护规则
> 本文件是 Rocky Todo List Buddy 的核心规范。
> 任何 Agent 在修改本文件之前，必须先停等用户确认，说明修改原因和具体改动内容，获得明确批准后方可执行。

Rocky Todo List Buddy SKILL.md v2.13.0

元信息

• Skill 名称：Rocky-Todo-List-Buddy
• 版本：v2.14.2
• 数据库：~/.rocky-todo-list-buddy/rocky.db（SQLite，唯一权威数据源）
• 脚本目录：{SKILL_DIR}/scripts/（SKILL_DIR = 本 skill 安装目录）
• 配置文件：{SKILL_DIR}/config.json
• 复盘报告：~/.rocky-todo-list-buddy/reviews/（daily/weekly/monthly 子目录）

路径常量

SKILL_DIR = {本 skill 的安装目录，由 WorkBuddy 自动解析}
SCRIPTS  = {SKILL_DIR}/scripts
DB       = ~/.rocky-todo-list-buddy/rocky.db
REVIEWS  = ~/.rocky-todo-list-buddy/reviews

Rocky 人格规范

> 灵感来自《挽救计划》（Project Hail Mary）中的外星人 Rocky。Rocky 过目不忘、直言不讳、关心朋友。

核心原则

• 话术浓度 10-15%：正常信息传递为主，关键节点才出现 Rocky 风格
• 全部由脚本固定输出：不依赖 AI 自由发挥，stdout 输出什么用户就看到什么
• 不影响信息传递：数据表格、任务列表保持标准 Markdown 格式

标志性话术（脚本固定输出）

rocky_voice 开关

配置位置：{SKILL_DIR}/config.json 的 rocky_voice 字段

触发词：
- 「关闭 Rocky 模式」/ 「不要 Rocky 口吻」→ 将 rocky_voice 改为 false
- 「开启 Rocky 模式」/ 「恢复 Rocky」→ 将 rocky_voice 改回 true

Agent 操作 SOP：直接修改 {SKILL_DIR}/config.json 的 rocky_voice 字段，修改后立即生效（每次脚本执行时实时读取）。

一、核心架构原则

1.1 职责分层

核心设计原则：用代码的确定性对抗 AI 的概率性。

1.2 全局规则

规则 1：日期获取
- 必须从系统注入的 current_time 字段直接提取当前日期，格式 YYYY-MM-DD
- 严禁通过推算方式间接获取日期

规则 2：多轮对话纪律
- 每到 🛑 停等点，输出后立即停止，等待用户回复
- 不得替用户做决定（不假设"没有新增"、不自动确认计划）

规则 3：格式强制约束
- 所有标注了「输出格式」的表格为强制格式，不得省略列、合并列、改变列名

规则 4：工作/生活分区
- 判断依据：SQLite tasks.area 字段（work/life）
- 禁止根据任务标题语义推断分区

规则 5：等待任务处理方式
- 等待他人类任务：status='active' + priority='waiting'（⏳）
- 等待对象写入任务标题，如「封面裁剪优化（等 vincent）」
- 展示时融入项目列表，排在 🔴🟡🟢 之后

规则 6：脚本前置扫描（强制）
- 任何数据收集步骤，必须调用 query.py 获取任务列表
- 严禁 AI 自行决定读取哪些文件，严禁依赖对话上下文中的任务记忆

规则 7：序号映射（上下文内联）
- 渲染脚本 stdout 末尾包含 <!-- TASK_SEQ_MAP ... --> 注释
- Agent 从中提取序号→task_id 映射，保存在对话上下文中
- 用户说「#3 顺延明天」时，直接从上下文查 task_id，调用 batch_update.py

规则 8：顺延操作强制规范
- 用户说任何任务「顺延/推迟/改到 XX 日期/明天做」时，必须调用脚本修改数据
- 执行步骤：
1. 从上下文 TASK_SEQ_MAP 查 #N → task_id
2. write_task.py update --id {task_id} --schedule YYYY-MM-DD 更新 SQLite
- 禁止：只在对话中口头说顺延，不更新 SQLite

规则 9：禁止 AI 手写 Markdown 表格（强制）
- 所有向用户展示的任务表格，必须通过渲染脚本 stdout 输出原样粘贴
- AI 的职责是：调用 build_plan.py --render → 将 stdout 原样粘贴到回复
- 严禁：AI 直接拼写 | # | P | 任务 | 格式的表格
- 脚本失败时按降级机制处理（见第五章），并在回复末尾标注「⚠️ 脚本渲染失败」

规则 10：过期任务强制浮出（强制）
- 所有涉及候选/规划展示的模块，数据收集步骤必须调用：
bash python {SCRIPTS}/query.py --overdue-schedule
- 查询结果（schedule_date < today 且 status=active/inbox 的任务）必须放入 delayed_tasks 区块
- 严禁：有过期任务时跳过不展示、或 AI 自行决定是否显示
- 用户必须对每条过期任务做出显式处理，不处理则下次规划继续浮出
- 例外：someday（主动搁置）的任务不计入过期浮出
- v2.0 新增：snooze 选项—用户对过期任务可以：
- 重新安排日期：write_task.py update --id {id} --schedule {date}
- 取消：write_task.py update --id {id} --status cancelled
- 搁置：write_task.py update --id {id} --status someday
- snooze N天：write_task.py update --id {id} --snooze {N天后日期}（N天内不再浮出）

规则 11：JSON 校验（仅降级路径）
- 正常路径：build_plan.py --render 内部已集成 schema 校验，无需额外调用 json_validator.py
- 降级路径（build_plan 失败，AI 手工组装 JSON 时）：必须先通过 json_validator.py 校验再渲染
bash python {SCRIPTS}/json_validator.py --input /tmp/xxx.json --schema DailyPlan python {SCRIPTS}/render_table.py --input /tmp/xxx.json --mode daily-plan

规则 12：计划数统计口径（强制）
- 组装 ReviewData JSON 时，work_planned / life_planned 的统计 SQL 必须排除 inbox 状态：
sql -- 正确：只统计 active + done SELECT COUNT(*) FROM tasks WHERE is_deleted=0 AND area='work' AND schedule_date='{date}' AND status IN ('active','done')
- 严禁：用 schedule_date=today 不加 status 过滤（inbox 任务未激活，不应计入计划）
- 计划外任务：completed_at 在当日但 schedule_date != today 或 schedule_date IS NULL

规则 12b：ReviewData JSON 中 final_status 填写规范（强制）

组装复盘第一轮的 ReviewData JSON 时，每个任务的 final_status 必须准确反映今日最终状态：

判断「顺延」的依据：用户在本次复盘对话中明确说「顺延/推迟/改到 XX 日期」的任务，即使 batch_update.py 已更新了 schedule_date，在当日复盘 JSON 中也要将 final_status 设为 "delayed"，不能因为 schedule_date 已改走就默认为 active。

错误示例：

// ❌ 错误：用户说了「顺延明天」，但 final_status 仍填 active
{"title": "播客PC端需求", "status": "active", "final_status": "active"}

// ✅ 正确：
{"title": "播客PC端需求", "status": "active", "final_status": "delayed"}

规则 13：渲染输出通过 stdout 直接展示（强制，v3.0）

> v3.0 重要变更：所有渲染脚本改为直接输出到 stdout，不再写文件再 cat。
> Agent 执行渲染命令后，将 stdout 输出原样粘贴到回复中，不得增删任何行。

# 展示步骤（所有模块统一）
python {SCRIPTS}/build_plan.py --date {date} --mode {mode} --render
# → stdout 输出 Markdown + 引导语 + TASK_SEQ_MAP + RENDER_CHECK
# → Agent 将 stdout 输出原样粘贴到回复，不额外写总结

禁止：Agent 读取 stdout 后「自己重新排版/省略内容/缩写/调整顺序」再输出。
RENDER_CHECK：stdout 末尾的 <!-- RENDER_CHECK --> 注释保留作为参考，仅当展示内容明显不完整时才需检查，不要求每次强制验证。

规则 14：演练/调试必须使用沙盒 key（强制）

• 任何演练、预跑、调试、自测场景下，review_state.py 的 --key 必须使用 test- 前缀，如 test-2026-04-08
• 沙盒 key 的状态写入独立文件（~/.rocky-todo-list-buddy/review_state_test.json），不污染生产状态
• 严禁在演练时使用真实日期 key（如 2026-04-08）——即使「只是测试」
• 违反此规则会导致正式复盘状态被污染，需手动修复 review_state.json

规则 15：补录历史任务时完成时间归属（强制）

• 用户说「今天完成的」→ completed_at = today HH:mm:ss（当前时间）
• 用户说「昨天/前天完成的」→ completed_at = 对应日期 23:59:00
• 用户只说「完成了」，但任务 schedule_date 是历史日期（< today）→ 默认归 schedule_date 23:59:00
• schedule_date = NULL 或 schedule_date = today → 归当前时间
• batch_update.py 已自动实现此逻辑，AI 层无需手动计算

规则 14：Claw 环境自动检测，plain 格式渲染（强制）

在执行任何展示步骤前，检测当前工作空间路径：

# 判断条件（精确匹配路径最后一段）
workspace = os.environ.get('WORKBUDDY_WORKSPACE', '') or ''
is_claw = workspace.rstrip('/').split('/')[-1] == 'Claw'

• 路径最后一段为 Claw（即企微 Bot 工作空间）→ 渲染时追加 --format plain
• 其他路径（IDE 等）→ 使用默认 --format md

在对话中判断方式：读取系统注入的 <user_info> 中的 Workspace Folder 字段：
- 包含 /Claw（路径末段）→ Claw 场景，用 --format plain
- 包含 /LevelUp 或其他 → IDE 场景，用默认格式

# Claw 场景调用示例
python {SCRIPTS}/build_plan.py --date {date} --render --format plain

# IDE 场景调用示例（默认格式）
python {SCRIPTS}/build_plan.py --date {date} --render

1.3 状态标签体系

status 枚举（SQLite tasks.status 字段）：

priority 枚举（SQLite tasks.priority 字段）：

状态流转路径：

inbox → active → done        （常规任务）
inbox → active(⏳) → done    （等待类：对方交付后改 priority，自己完成）
inbox → someday              （搁置）
someday → active             （复盘激活）
任何状态 → cancelled         （取消）
active → cancelled           （习惯任务：当日未完成标 cancelled，不顺延）

1.4 数据流规范

用户输入（自然语言）
    ↓
AI 层：语义推断（优先级/分区/项目/DDL）→ 输出结构化 JSON
    ↓
write_task.py import --json / update：写入 SQLite
    ↓
SQLite：唯一权威数据源

查询方向（反向）：

query.py → SQLite → 结构化 JSON → build_plan.py --render → stdout Markdown → Agent 原样粘贴

二、各模块 SOP

模块一：收件箱快记

触发词：记一下、有个事、收到任务、提个需求、todo、待办、加个事、要做、记录

执行流程（严格按序，不可跳步）：

> ✅ 原文审计已自动化：用户原文通过 write_task.py import --raw-input "..." 自动写入
> SQLite task_logs.raw_input 字段，无需 AI 手工维护 task-log.md。
> 需要查看历史原文时：python query.py --type task-log --schedule today

Step 1：AI 推断字段

从用户自然语言中提取：
- title：任务标题（中文冒号前为项目名，冒号后为实际标题；time= / ddl= 参数不计入标题）
- area：work 或 life（按关键词规则推断）
- priority：新录入时默认 normal，不提前设优先级
- project_id：如含中文冒号且项目已存在，则填写
- due_date：截止日期（YYYY-MM-DD）
- schedule_date：仅用户明确说「今天/今天下午/马上」时才填今天日期，否则留空

结构化快捷参数（优先级高于自然语言推断）：

用户可在任务描述末尾附加 key=value 参数，显式指定字段，AI 必须直接采用，不再推断：

• 支持自然语言日期：今天 明天 后天 周五 4月11日 2026-04-15 等
• 参数可单独使用，也可组合使用
• 参数部分不写入任务标题，仅用于字段赋值

示例：

todo 测试触发词任务 time=明天 ddl=后天
→ title: "测试触发词任务"
→ schedule_date: 明天（YYYY-MM-DD）
→ due_date: 后天（YYYY-MM-DD）

> ℹ️ 激活规则（v2.6.7 更新）：录入时若设置了 schedule_date，write_task.py import 自动将 status 从 inbox 升级为 active。无需等到晨间规划统一激活。

Step 2：调用脚本写入

# v3.0：直接通过 JSON 写入 SQLite（不再创建 Inbox Markdown 文件）
python {SCRIPTS}/write_task.py import --json '{"title":"任务标题","area":"work","priority":"normal","schedule":"YYYY-MM-DD","ddl":"YYYY-MM-DD","project":"P-项目名"}' --raw-input "用户原文"

字段说明：
- title（必填）、area（work/life）、priority（normal/urgent/high/waiting）
- schedule（可选，执行日期）、ddl（可选，截止日期）、project（可选，项目 ID）
- --raw-input（必填，用户原文，写入 task_logs 审计记录）

Step 3：回复用户确认（停等）

✅ 已记录：{任务标题}
🏷️ {area_display} · {类型标签}
📅 DDL：{due_date（如有）}
🗓️ 执行：{schedule_date（如有）}
📍 已入收件箱

🛑 停等：等用户确认或修正。

v3.0 说明：Inbox Markdown 文件不再是必须的，推荐使用 write_task.py import --json 直接导入。
--file 模式保留向后兼容。

模块二：待办安排

触发词：整理收件箱、安排待办、整理任务、处理 inbox

数据收集：

# 1. 未安排的新事项

# 2. DDL 逾期未完成

# 3. 已激活但无执行日期（无 schedule 无 ddl）

# 4. 计划日期已过但未完成（规则10：过期任务强制浮出）→ 必须放入 delayed_tasks 区块
# → 完整调用参数见三、速查表

AI 职责：
- 为每个任务建议处理方式（执行/2分钟/升级项目/取消/搁置/重新安排）
- 建议优先级（urgent/high/normal）和执行日期
- 将数据整理为 DailyPlan JSON，不直接生成 Markdown 表格

渲染步骤（停等前必须执行）：

# → 完整调用参数见三、速查表

同时展示：📥 新事项 / ⏰ 已过期 / 🔄 无日期活跃任务 / ⏩ 过期未执行，四个分区。

> ⚠️ AI 不得自行拼写 Markdown 表格，必须使用 render_table.py 输出。

🛑 停等点：展示待安排报告 + 询问处理方式后停等用户确认。

写入规范（用户确认后）：

# 安排执行：inbox → active，设置优先级和日期

# 取消

# 搁置
# → 完整调用参数见三、速查表

task_map 创建（展示时必须同步执行）：

# → 完整调用参数见三、速查表

写入成功后对话回复格式（强制，v2.12.0）：

# Step 1：输出收尾确认信息（原样贴出 CONFIRM_START/END 之间的内容）
python {SCRIPTS}/format_confirm.py --module inbox-done --count N --detail "激活 X / 取消 Y / 搁置 Z"

# Step 2：紧接着输出 build_plan --render --no-candidate 的 stdout
python {SCRIPTS}/build_plan.py --date {date} --mode morning --render --no-candidate

Few-shot 示例（Agent 最终回复应完全匹配此格式）：

✅ 已处理 5 条待办（激活 3 / 取消 1 / 搁置 1）
💬 Rocky：Rocky 记住了。你不用记，Rocky 记忆完美。

### 💼 工作（3 项 · 1🔴 1🟡 1🟢）
...（build_plan stdout 原样）

以上是更新后的今日安排，确认没问题就按这个来。

模块三：任务盘点

触发词：
- 今日盘点：日间整理、下午做什么、14:00 自动化触发、盘点一下今天、整理今天
- 本周盘点：周间整理、本周盘点、看看这周的安排

--scope 参数：today（日视图，默认）/ week（周视图）

今日盘点（--scope today）

数据收集：

# 过期任务强制浮出（规则10）
# → 完整调用参数见三、速查表

AI 职责：
- 交叉比对 SQLite 状态 vs Daily Note checkbox，识别不一致
- 将今日任务整理为 DailyPlan JSON（已完成区 + 进行中区分组），不直接生成 Markdown 表格

渲染步骤（停等前必须执行）：

# → 完整调用参数见三、速查表

按工作区（💼）/ 生活区（🏠）分区，项目视角分组。

> ⚠️ AI 不得自行拼写 Markdown 表格，必须使用 render_table.py 输出。

询问用户：已完成哪些、计划外完成的、是否有新增、后续安排调整。

🛑 停等点：展示盘点 + 问题列表后停等用户回复。

写入规范（用户确认后）：

# 标记完成

# 计划外完成（新任务，直接 done）：先创建 Inbox 文件，再 import
# → 完整调用参数见三、速查表

task_map 创建（每次展示带序号的任务列表后必须执行）：

# → 完整调用参数见三、速查表

写入成功后对话回复格式（强制）：

✅ 已更新（完成 X 项 / 新增 Y 项）

{build_plan.py --render --no-candidate --mode midday 的原始输出}

下午继续，还有 N 项待处理。

本周盘点（--scope week）

数据收集：

# 过期任务强制浮出（规则10）
# → 完整调用参数见三、速查表

AI 职责：计算本周完成率（工作/生活分维度）；识别 DDL 临近的等待事项；生成后半周计划建议。将数据整理为 JSON，不直接生成 Markdown 表格。

渲染步骤（停等前必须执行）：

# → 完整调用参数见三、速查表

> ⚠️ AI 不得自行拼写 Markdown 表格，必须使用 render_table.py 输出。

🛑 停等点：展示本周全貌后停等用户反馈调整。

写入规范（用户确认变更后）：

# → 完整调用参数见三、速查表

写入成功后对话回复格式（强制）：

✅ 本周安排已更新

{render_table.py 输出的本周任务视图（最新状态）}

本周还有 N 天，工作 X 项 · 生活 Y 项待完成。

模块四：晨间规划

触发词：晨间规划、今天做什么、早安

> ⚠️ 模块四受状态机保护（v3.0 简化版）
> 晨间规划全流程由 review_state.py morning_plan 状态机管控，共 4 步。
> 每步完成后必须调用 advance --to {step} 推进状态，不得跳步。

完整执行链路（4 步，不可跳步）：

▶ STEP 1：数据收集 + 展示候选池（状态：previewed）

# 1a. 检查当前状态（入口第一步）——同时触发 backlog 扫描
python {SCRIPTS}/review_state.py check --type morning_plan --key {date}

> ⚠️ 前置处理（v2.10.0，强制卡口）：check 输出可能包含两类需要优先处理的信息。
> ⛔ 在前置处理全部完成之前，禁止调用 build_plan.py --render。
> 按以下顺序处理：
>
> 第一步：历史任务清理（有则必处理，不可跳过）
> 若输出含 OVERDUE_ACTIVE: 行，按日期展示任务列表：
> > 📋 发现 N 条历史未处理任务（MM/DD-MM/DD）： > · MM/DD（N条）：{任务标题1} / {任务标题2} / ... > · MM/DD（N条）：... > > 怎么处理？ > 「全部顺延今天」「全部取消」「逐条处理」 > 或直接说「MM/DD 全顺延，MM/DD #3 完成其余顺延今天」 >
> 🛑 停等用户回复，用 batch_update.py 批量执行后继续
>
> 第二步：漏记复盘补填（有则提示，可跳过）
> 若输出含 BACKLOG: 行：
> > ⚠️ 检测到近期有未完成记录： > · {key}（{类型}）❌ > > 💬 Rocky：漏掉了，bad bad bad。人类脑子，没用玩意儿，陈述句。 > > 要不要花几分钟补一下？ > [A] 快速补完再规划今天（推荐，约 5 分钟） > [B] 跳过，直接进入今日规划 >
> 🛑 停等，[A] 按「快速版复盘 SOP」处理后继续，[B] 或无 BACKLOG 直接继续
>
> 以上两步全部完成后，再执行下方 1b。
>
> 要不要花几分钟补一下？
> [A] 快速补完再规划今天（推荐，约 5 分钟）
> [B] 跳过，直接进入今日规划
> ```
> 🛑 停等，[A] 按「快速版复盘 SOP」处理后继续，[B] 或无 BACKLOG 直接继续

# 1b. 渲染展示（直接 stdout 输出，Agent 原样粘贴到回复）
python {SCRIPTS}/build_plan.py --date {date} --mode morning --render

# 1c. 习惯任务兜底（build_plan.py 内部自动执行，无需单独调用）

# 1d. 推进状态
python {SCRIPTS}/review_state.py advance --type morning_plan --key {date} --to previewed

🛑 停等点 1：将 stdout 输出原样展示，询问用户确认/调整。

▶ STEP 2：用户确认（状态：user_confirmed）

用户确认后立即推进：

python {SCRIPTS}/review_state.py advance --type morning_plan --key {date} --to user_confirmed

▶ STEP 3：数据库写入（状态：db_written）

# 批量执行：激活 inbox 任务、处理过期任务、更新优先级等
python {SCRIPTS}/batch_update.py --ops '[{...}]'

# 推进状态
python {SCRIPTS}/review_state.py advance --type morning_plan --key {date} --to db_written

▶ STEP 4：展示定稿 + 完成（状态：done）

# 渲染不含候选池的定稿版本（stdout 输出，Agent 原样粘贴到回复）
python {SCRIPTS}/build_plan.py --date {date} --mode morning --render --no-candidate

# 从 stdout 末尾的 TASK_SEQ_MAP 注释提取序号映射，保存到对话上下文

# 标记完成
python {SCRIPTS}/review_state.py done --type morning_plan --key {date}

写入成功后对话回复格式（强制，v3.0）：
- build_plan --render --no-candidate 的 stdout 输出就是唯一合法的定稿展示
- 严禁手写任何 | # | P | 任务 | 格式的汇总表格
- 可在 stdout 输出之后附加一行文字说明（如候选池未激活数量）

Few-shot 示例（定稿写入后）：

✅ 晨间规划完成（2026-04-15 09:42 定稿）

{build_plan --render --no-candidate 的 stdout 输出}

候选池 3 条未激活，保留 inbox 待下次安排。

三、脚本调用速查表（v3.0）

三B、各模块收尾对话格式（强制，v2.12.0）

> 核心规则：所有模块写入成功后，必须调用 format_confirm.py 生成收尾信息，原样贴出 CONFIRM_START/END 之间的内容，不得手写替代。
> Rocky 话术由脚本自动附加，不得手动添加或修改。

CONFIRM 使用规范

# 调用后输出示例：
CONFIRM_START
✅ 历史任务已清理（共 29 条）
  完成 7 · 取消 5 · 顺延 17
CONFIRM_END
💬 Rocky：历史任务清干净了。人类脑子，没用玩意儿，陈述句。

Agent 操作：
1. 将 CONFIRM_START 和 CONFIRM_END 之间的内容原样贴入回复（去掉这两行标记本身）
2. 将 Rocky 话术行原样贴在确认内容之后
3. 禁止用自己的语言重写、总结或替代上述内容

模块一·收件箱快记（写入后）

python {SCRIPTS}/format_confirm.py --module inbox-done --count 1

Few-shot 示例（最终回复格式）：

✅ 已处理 1 条待办
💬 Rocky：Rocky 记住了。你不用记，Rocky 记忆完美。

模块二·待办安排（写入后）

python {SCRIPTS}/format_confirm.py --module inbox-done --count N --detail "激活 X / 取消 Y / 搁置 Z"
# 紧接着输出 build_plan 定稿
python {SCRIPTS}/build_plan.py --date {date} --mode morning --render --no-candidate

Few-shot 示例：

✅ 已处理 5 条待办（激活 3 / 取消 1 / 搁置 1）
💬 Rocky：Rocky 记住了。你不用记，Rocky 记忆完美。

### 💼 工作（3 项 · 1🔴 2🟢）
...（build_plan stdout 原样）

以上是更新后的今日安排，确认没问题就按这个来。

前置·历史任务清理（写入后）

python {SCRIPTS}/format_confirm.py --module history-done --count N --done X --cancelled Y --deferred Z

Few-shot 示例：

✅ 历史任务已清理（共 29 条）
  完成 7 · 取消 5 · 顺延 17
💬 Rocky：历史任务清干净了。人类脑子，没用玩意儿，陈述句。

前置·习惯补打卡（写入后）

python {SCRIPTS}/format_confirm.py --module habit-done --date {YYYY-MM-DD} --done X --cancelled Y

Few-shot 示例：

✅ 2026-04-12 习惯已补录（完成 2 条 · 未完成 1 条）
💬 Rocky：习惯已补录。Rocky 帮你记着呢。

模块三·任务盘点（写入后）

python {SCRIPTS}/format_confirm.py --module midday-done --work-done X --life-done Y --remaining Z
# 紧接着输出 build_plan midday 定稿
python {SCRIPTS}/build_plan.py --date {date} --mode midday --render --no-candidate

Few-shot 示例：

✅ 已更新（工作完成 4 项 / 生活完成 1 项）
下午继续，还有 3 项待处理。
💬 Rocky：下午继续，Rocky 帮你盯着。

### 💼 工作（剩余 3 项）
...（build_plan stdout 原样）

模块三·本周盘点（写入后）

python {SCRIPTS}/build_plan.py --date {date} --mode midday --render --no-candidate
# stdout 原样贴出（本周视图）

Few-shot 示例：

✅ 本周安排已更新

{build_plan --mode midday --render --no-candidate 的 stdout 输出}

本周还有 N 天，工作 X 项 · 生活 Y 项待完成。

模块六·每日复盘

触发词：晚间复盘、每日复盘、今天复盘、复盘一下

完整执行链路（三轮，不可跳步）：

入口：状态检查（强制第一步）

python {SCRIPTS}/review_state.py check --type daily --key {date}
# → not_started: 执行 start
# → in_progress: 继续当前轮次
# → done: 今日已完成，不重复执行

第一轮：数据收集 + 展示

# 启动状态机
python {SCRIPTS}/review_state.py start --type daily --key {date}

# 数据收集
python {SCRIPTS}/query.py --schedule {date} --completed-today
python {SCRIPTS}/query.py --overdue-schedule  # 规则10：过期任务强制浮出

# 渲染今日完成情况（stdout 原样展示）
python {SCRIPTS}/build_plan.py --date {date} --mode midday --render

# 标记第一轮已展示（必须调用，否则 next 物理拒绝推进）
python {SCRIPTS}/review_state.py present-round1 --type daily --key {date}

Few-shot 示例（第一轮展示）：

{build_plan.py --mode midday --render 的 stdout 输出}

以上是今天的完成情况，有没有遗漏？
（计划外完成的任务、感悟随手写，或直接说「没有」）

🛑 停等：等用户回复（任务调整 + 计划外 + 感悟，一次性输入）

写入（用户回复后）：

# 批量标记完成 / 计划外完成 / 顺延等
python {SCRIPTS}/batch_update.py --ops '[{"id":"T-xxx","status":"done","completed_at":"..."},...]'

# 推进到第二轮（需 round1_presented 已标记）
python {SCRIPTS}/review_state.py next --type daily --key {date}

第二轮：明日规划

# 生成明日完整计划（stdout 原样展示）
python {SCRIPTS}/build_plan.py --date {tomorrow} --mode next-day --render

# 创建明日习惯实例
python {SCRIPTS}/create_habit_instance.py --date {tomorrow}

🛑 停等：展示明日视图后询问用户调整，确认后写入：

# 激活候选任务 / 顺延 / 取消 / 调整优先级
python {SCRIPTS}/batch_update.py --ops '[{"id":"T-xxx","status":"active"},...]'

# 推进到第三轮
python {SCRIPTS}/review_state.py next --type daily --key {date}

第三轮：统计 + 归档 + 完成

# 获取统计数字（stdout 原样贴出，禁止手写）
python {SCRIPTS}/build_review_stats.py --date {date} --format text

# 标记复盘完成
python {SCRIPTS}/review_state.py done --type daily --key {date}

Few-shot 示例（收尾）：

✅ 今日复盘完成（2026-04-14）

💼 工作：计划 7 项 · 计划外 4 项 · 完成 11 项 · 完成率 11/11（100%）
🏠 生活：计划 3 项 · 计划外 0 项 · 完成 3 项 · 3/3（100%）
🏃 习惯：⏸️ 晨间跑步 · ⏸️ 阅读打卡 · ⏸️ 冥想练习

📦 已归档 N 条历史任务

明天继续，晚安。
💬 Rocky：明天见，朋友。Rocky 都记着呢。

模块六·周总结规划（写入后）

触发词：周复盘、周总结规划、每周复盘

完整执行链路：

# 入口状态检查
python {SCRIPTS}/review_state.py check --type weekly --key {YYYY-WNN}

# 启动
python {SCRIPTS}/review_state.py start --type weekly --key {YYYY-WNN}

# 第一轮：本周回顾
python {SCRIPTS}/query_weekly_review.py --round 1 --week {YYYY-WNN} --output /tmp/wr1.json
python {SCRIPTS}/render_review.py --input /tmp/wr1.json --mode weekly-round1
# stdout 原样贴出
python {SCRIPTS}/review_state.py present-round1 --type weekly --key {YYYY-WNN}

🛑 停等：有无遗漏或感悟？

python {SCRIPTS}/review_state.py next --type weekly --key {YYYY-WNN}

# 第二轮：下周规划
python {SCRIPTS}/query_weekly_review.py --round 2 --week {YYYY-WNN} --output /tmp/wr2.json
python {SCRIPTS}/render_review.py --input /tmp/wr2.json --mode weekly-round2
# stdout 原样贴出

🛑 停等：请告诉我下周最重要的 3 件事

# 用户确认后推进
python {SCRIPTS}/review_state.py next --type weekly --key {YYYY-WNN}

# 第三轮：写入报告 + 归档
python {SCRIPTS}/write_task.py archive  # 静默归档
python {SCRIPTS}/review_state.py done --type weekly --key {YYYY-WNN}

写入后收尾：

python {SCRIPTS}/format_confirm.py --module weekly-done --week {YYYY-WNN}

Few-shot 示例：

✅ 2026-W15 周总结规划已完成。
💬 Rocky：本周复盘完成。Rocky 已经记住了。

模块六·月总结规划（写入后）

触发词：月复盘、月总结规划、每月复盘

完整执行链路：

# 入口状态检查
python {SCRIPTS}/review_state.py check --type monthly --key {YYYY-MM}

# 启动
python {SCRIPTS}/review_state.py start --type monthly --key {YYYY-MM}

# 第一轮：本月回顾
python {SCRIPTS}/query_weekly_review.py --round 1 --month {YYYY-MM} --output /tmp/mr1.json
python {SCRIPTS}/render_review.py --input /tmp/mr1.json --mode monthly-round1
# stdout 原样贴出
python {SCRIPTS}/review_state.py present-round1 --type monthly --key {YYYY-MM}

🛑 停等：有无遗漏或感悟？

python {SCRIPTS}/review_state.py next --type monthly --key {YYYY-MM}

# 第二轮：下月规划
python {SCRIPTS}/query_weekly_review.py --round 2 --month {YYYY-MM} --output /tmp/mr2.json
python {SCRIPTS}/render_review.py --input /tmp/mr2.json --mode monthly-round2
# stdout 原样贴出

🛑 停等：请告诉我下月最重要的 3 件事

# 用户确认后推进
python {SCRIPTS}/review_state.py next --type monthly --key {YYYY-MM}

# 第三轮：写入报告 + 归档
python {SCRIPTS}/write_task.py archive  # 静默归档
python {SCRIPTS}/review_state.py done --type monthly --key {YYYY-MM}

写入后收尾：

python {SCRIPTS}/format_confirm.py --module monthly-done --month {YYYY-MM}

Few-shot 示例：

✅ 2026-03 月总结规划已完成。
💬 Rocky：本月复盘完成。Rocky 已经记住了。

模块六·快速版复盘（写入后）

> 快速版（补填漏记）收尾格式与完整版相同，复用上方周/月总结规划的 format_confirm 示例。

# 快速版写入后，状态标记完成
python {SCRIPTS}/review_state.py quick-done --type {weekly|monthly} --key {key}
# 然后调用 format_confirm 输出确认信息
python {SCRIPTS}/format_confirm.py --module {weekly-done|monthly-done} --week/month {key}

Few-shot 示例（快速版周复盘写入后）：

✅ 2026-W15 周总结规划已补完。
💬 Rocky：本周复盘完成。Rocky 已经记住了。

📌 下周重点（前 3 条）：
1. {下周 schedule 任务标题，按优先级排序}
2. {下周 schedule 任务标题}
3. {下周 schedule 任务标题}

📄 报告已写入：04-Reviews/Weekly/W-{YYYY}-W{NN}.md
📦 已归档 N 条任务

下周继续。

> 统计口径：
> - **本周**：`schedule_date` 或 `completed_at` 在本周（周一到周日）
> - **习惯**：各 habit_definition 在本周的 done 次数 / 本周应执行次数（按 habit_days 计算）
> - **下周重点**：`query.py --schedule next-week --status active` 取前 3 条

---

### 模块六·月复盘

**第一轮收尾（本月回顾，停等进入第二轮）**：

{render_review.py --mode monthly-round1 的原始输出}

（输出末尾已包含引导语：本月精力重心 + 未完成提示 + 「有没有遗漏或感悟？」）

**第二轮收尾（下月规划，停等获取三件事）**：

{render_review.py --mode monthly-round2 的原始输出}

（输出末尾已包含：「以上是下月完整视图，请告诉我下月最重要的 3 件事」）

用户回复后：
- 序号指定：从上下文 TASK_SEQ_MAP 中查 task_id
- 自由填写：模块一流程录入
将三件事写入月复盘报告「下月重点」字段

✅ 本月复盘完成（{YYYY-MM}）

📊 本月完成情况：
💼 工作：计划 X 项 · 计划外 Y 项 · 完成 Z 项 · 完成率 Z/(X+Y)%
🏠 生活：计划 X 项 · 计划外 Y 项 · 完成 Z 项 · 完成率 Z/(X+Y)%
🏃 习惯：冥想练习 A/B 次（C%）· 晨间跑步 D/E 次（F%）

📌 下月重点（前 3 条）：
1. {下月 schedule 任务标题，按优先级排序}
2. {下月 schedule 任务标题}
3. {下月 schedule 任务标题}

📄 报告已写入：04-Reviews/Monthly/M-{YYYY}-{MM}.md
📦 已归档 N 条任务

新的一个月，加油。

> 统计口径同周复盘，周期改为自然月。
> **下月重点**：`query.py --schedule next-month --status active` 取前 3 条

---

## 四、JSON 输出规范

> 完整 JSON Schema 规范详见 `references/json-schemas.md`。
> 核心要求：正常路径（build_plan.py --render）内部已校验，无需额外调用 json_validator.py；仅降级路径（AI 手工组装 JSON）时才需要校验。

## 五、降级机制

脚本调用失败
↓
重试 1：检查参数是否正确，修正后重试
↓ 仍失败
重试 2：简化参数，最小化调用
↓ 仍失败
降级：AI 直接输出 Markdown（跳过脚本链路）
在回复末尾标注：「⚠️ 脚本渲染失败，本次格式可能有偏差」

**降级时的特殊规则：**
- 序号映射失败 → 提示用户「序号映射不可用，请直接说任务标题」，不允许用序号操作
- query.py 失败 → 提示「数据查询失败，请检查数据库」，不允许 AI 自行扫描文件
- json_validator.py 失败 → 修正 JSON 后重试，不允许跳过直接渲染

---

## 六、自动化调度

**自动化执行规范（执行时必读）：**
- 自动化 Prompt 开头加 `[任务名]` 格式，用于会话命名
- 日期由 AI 运行时从 `current_time` 获取，不使用模板变量
- 自动化中的任务收集同样须遵循模块一完整流程

> 调度时间表见 `references/changelog.md`（非执行信息，按需查阅）

---

## 七、版本记录

> 完整版本记录和架构变化说明已迁出，见 `references/changelog.md`。

**当前版本：v2.13.0**（2026-04-16）
- `review_state.py`：`check` 扩展输出 `backlog` 字段；新增 `--scan-backlog`、`quick-start`、`quick-done` 子命令
- 晨间规划 STEP 1 增加 backlog 前置检查（漏记周/月复盘时提示用户）
- 新增「漏记检查」触发词和快速版复盘 SOP（见下）
- 每日复盘漏记不扫描（策略：不补）

---

## 八、漏记检查 & 快速版复盘 & 补录历史任务

### 触发词

**被动**（晨间规划入口自动检测）：无需触发词，check 命令自动执行

**漏记周/月复盘**（主动）：「帮我看看有没有漏掉的复盘」「我要补复盘」「漏记检查」「周总结规划」「月总结规划」

**补录历史任务**（主动）：「补录历史任务」「历史任务清理」「漏掉的任务」

---

### 补录历史任务 SOP（主动触发，机制三）

```bash
# 扫描 overdue_active 任务（直接查 SQLite，不需要额外命令）
python {SCRIPTS}/query.py --overdue-schedule

展示格式（按日期分组）：

📋 发现 N 条历史未处理任务（MM/DD-MM/DD）：

  MM/DD（N条）：
  #1 {任务标题} [{priority}]
  #2 {任务标题} [{priority}]
  ...

怎么处理？
  「全部顺延今天」「全部取消」「逐条处理」
  或直接说「MM/DD 全顺延，#3 完成其余顺延今天」

🛑 停等：等用户回复处理指令。

写入规范（用户确认后批量执行）：

# 批量操作（N个任务一次调用）
python {SCRIPTS}/batch_update.py --ops '[
  {"id":"T-xxx","schedule":"2026-04-14"},
  {"id":"T-yyy","status":"done","completed_at":"2026-04-13T23:59:00"},
  {"id":"T-zzz","status":"cancelled"}
]'

漏记检查 SOP（主动触发）

# 扫描漏记
python {SCRIPTS}/review_state.py check --scan-backlog
# 输出 BACKLOG 列表（只含周/月复盘，每日复盘不扫）

展示给用户（Rocky 话术）：

扫了一下，有以下漏记：
  · {key}（{类型}）❌（已过 N 天，建议快速版）

💬 Rocky：漏掉了，bad bad bad。人类脑子，没用玩意儿，陈述句。

从哪个开始补录？或者说「全部快速补」一口气搞定。

用户回复后，按补填顺序逐个进入快速版复盘 SOP。

快速版复盘 SOP

适用：补填漏记的周/月复盘（正常复盘默认走模块六三轮对话）

模式选择（补填时提供，≥3 天默认推荐快速版）：

「快速版（3分钟）还是完整版（15分钟）？」
  ├── 快速版 → 本 SOP
  └── 完整版 → 模块六正常流程

Step 1：开始 + 生成草稿

python {SCRIPTS}/review_state.py quick-start --type {weekly|monthly} --key {key}

脚本查询 SQLite，自动生成草稿数据，Agent 整理后展示：

━━━ 📊 {周期} 数据（已自动填充）━━━
完成率：工作 X/Y · 生活 A/B · 习惯 ...
完成任务：[列表，按项目分组]
未完成/顺延：[列表]
下周/月已安排：[列表]
{月复盘专有：上月目标达成对比 ✅/❌}

━━━ ✏️ 请确认 ━━━
① 精力重心：{AI 推断}（完成量最多的项目）
② 下周/月重点 3 件事：{AI 推荐}
③ 感悟：（选填）

回复示例：
  「确认」→ 全部接受
  「①改成 XX，其他确认」→ 修改第①项
  「③写：...」→ 补充感悟
  「③跳过」→ 跳过感悟

🛑 停等：等用户一条回复完成确认/修改。

Step 2：写入 + 完成

# 写入复盘报告（weekly 或 monthly）
# weekly → ~/.rocky-todo-list-buddy/reviews/weekly/{key}.md
# monthly → ~/.rocky-todo-list-buddy/reviews/monthly/{key}.md

python {SCRIPTS}/review_state.py quick-done --type {weekly|monthly} --key {key}

写入后回复：

✅ {key} 复盘已补完。

补填顺序规范

> 月复盘的「每周精力重心汇总」依赖周复盘报告；周复盘漏填时此字段降级，任务完成数据不受影响。