personal-worklist-via-feishu

飞书多维表格个人工作台账。双层读取：Frontmatter(每次触发必读) + Body(按需读)。 【触发词】 "创建个人工作台账"/"create worklist" | "记一下工作"+内容/"add task"+内容 | "完成了"/"cancelled"/"推迟"/"defer" | "复盘"/"review" | "诊断"/"diagnose" 【每次触发必验5条】 1.语言未设置→先问用户(中文/英文/c/e)，禁止跳过 2.三项必填逐一确认(任务名称/优先级①~④/截止日期)，未提供则追问，禁止自行编造 3.来源分类自动归类(未提及→临时任务[U]，协作→协作任务[C]，周期→例行任务[R]，计划内→计划任务[P])，无需追问 4.可选字段(工作要求/链接/干系人/备注/预计时长)：用户提供则写，未提供则留空，禁止推断 5.openclaw cron add/delete已授权(2026-04-27)，无需确认直接执行 【关键约束】 init_table.js必须带--open-id(用户open_id)，否则用户无法访问表格 add_task.js首次录入成功后脚本内部自动触发cron提醒(memory判断) 禁止语言未确认前执行任何脚本 【字段速查】 优先级：①紧急且重要/②重要不紧急/③紧急不重要/④不紧急不重要 状态：待办/进行中/已完成/取消 来源：计划任务[P]/临时任务[U]/例行任务[R]/协作任务[C]

⛔ 强制执行协议（按需读取）

双层读取机制：

层级	内容	读取时机
Frontmatter(每次)	5条必验规则+字段速查+触发词	每次 skill 触发时
Body 本节	分场景操作约束+禁止行为	遇到具体场景时

【分场景操作约束】按需读取 body 对应章节：

• 创建台账：node scripts/init_table.js --open-id USER_OPEN_ID --lang zh|en，--open-id 必填
• 录入任务：node scripts/add_task.js --task "名称" --priority "①" --deadline "2026-04-25" --lang zh|en，首次成功自动触发 cron
• 更新状态：node scripts/update_task.js --record-id ID --status "已完成"
• 进度复盘：AI 读取 list_tasks.js + PMBOK 五步复盘
• 健康诊断：node scripts/health_check.js --lang zh|en

【禁止行为】每次必验：

• 禁止语言未确认前执行任何脚本
• 禁止跳过必填字段确认（任务名称/优先级/截止日期）
• 禁止为可选字段自行推断值
• 禁止自行构造飞书 API，必须用内置脚本
• 禁止执行 gateway 重启/skill 安装卸载/配置文件修改（cron 例外）
• 禁止自行切换/操作锁定目标之外的工作台账 — 工作台账多维表格配置一旦确定（首次初始化并确认），配置立即锁定。此后所有任务操作（add_task / update_task / list_tasks / health_check 等）只能在该表格范围内进行；set_config / create_bitable_app 等变更操作一律禁止；如需切换目标表格，必须由 Jerry 明确授权

🚨 系统操作红线

以下操作未经用户明确确认,严禁自行执行:

禁止操作类型	示例	违规后果
修改 OpenClaw 配置文件	修改 gateway、plugins、agents 配置	立即停止,等待用户指令
修改系统环境变量	PATH、OpenClaw 相关变量	立即停止,等待用户指令
安装/卸载/更新 skill	openclaw skill install/uninstall	立即停止,等待用户指令
执行 gateway 重启	openclaw gateway restart	立即停止,等待用户指令
修改本地文件权限	chmod、icacls 等	立即停止,等待用户指令
执行系统级命令	注册表修改、系统设置变更	立即停止,等待用户指令
新用户首次配置完成后执行任何脚本前未确认语言	安装完成后跳过语言确认直接运行 health_check / init_table 等	立即停止语言确认流程,禁止跳过

✅ 例外（无需确认，可直接执行）:

• openclaw cron add/delete — 用于设置/删除本 skill 的定时提醒，无需用户确认，直接执行

规则说明:

• "明确确认"指用户口头或书面同意,不包括沉默、超时、推测
• 若用户说"等等"、"先不要"、"让我想想",均视为未确认,停止操作
• 任务数据读写(add_task.js / list_tasks.js / update_task.js)不属于系统操作,无需确认
• 飞书 API 调用(读写多维表格数据)不属于系统操作,无需确认
• 定时提醒设置(cron add/delete)属于本 skill 的正常功能扩展，无需单独确认

判断技巧:

如果一个操作会影响 OpenClaw 的运行状态、用户电脑的系统配置、或任何不可逆的系统变更,先问用户,再执行（cron 操作除外，见上方例外）。

---

核心功能

1. 创建台账 - 通过对话引导用户创建飞书多维表格
2. 任务录入 - 强触发或弱触发将任务写入台账
3. 定时提醒 - 每天三个时间点推送工作提醒(早晨/下午/下班前)
4. 进度复盘 - 下班前自动汇总当日完成率、明日预告

国际化支持

语言环境检测(强制)

【强制检查点】每次创建台账或录入任务前，必须确认语言环境。

规则:

• preferences.json 中无语言记录 → 必须立即询问用户，不得跳过
• preferences.json 中已有语言记录 → 直接使用，不得重复询问
• --lang 参数显式传入 → 直接使用，覆盖 preferences.json

首次使用（无语言记录）询问方式:

"您好！我是飞书工作台账助手。在开始之前，请确认您的运行环境：

• 输入 中文 或 c → 使用中文提示词和多维表格字段
• 输入 英文 或 e → 使用英文提示词和多维表格字段"

AI 禁止行为:

• 禁止在未确认语言前执行 node scripts/init_table.js
• 禁止在未确认语言前执行 node scripts/add_task.js
• 禁止在未确认语言前告知用户"创建成功"或"录入成功"
• 禁止在用户已用中文/英文发送消息后，AI 自行切换到另一种语言

语言偏好影响 skill 的所有输出,包括但不限于:

• 定时提醒(早晨/下午/下班前)
• 日常任务沟通(录入确认/状态更新/复盘对话)
• 输出文本(提示语/字段名/选项值/时间格式)
• AI 说的话、问的问题、给的建议

一旦确认,持续生效,不得在同一次会话中切换语言。

确认语言后的引导流程(强制): 用户完成语言选择后，立即发送以下触发词引导（不要等待用户主动询问）：

中文模式确认后发送：

🎉 语言已确认！下面是您可以使用的工作台账功能：

📝 任务录入（直接说）：

• "记一下这个工作：XXXX" → 立即录入任务
• "创建个人工作台账" → 创建新台账

🔔 定时提醒：

• 首次录入任务后，我会引导您设置每天三个时间点的提醒（早晨 08:28 / 下午 14:00 / 下班前 17:30）

📋 状态更新：

• 说"完成了"、"取消了"、"还在做"、"推迟到XX" → 自动更新表格

• 说"复盘" → 下班前 PMBOK 式进度复盘

🔧 异常诊断：

• 说"台账不工作了"、"诊断" → 5项健康检查

要开始录入任务吗？直接告诉我任务内容即可 😊

英文模式确认后发送：

🎉 Language confirmed! Here are your worklist commands:

📝 Task Entry:

• "add task: XXXX" → Add task immediately
• "create worklist" → Create new bitable

🔔 Scheduled Reminders:

• After your first task, I'll guide you to set up 3 daily reminders (08:28 / 14:00 / 17:30)

📋 Status Updates:

• Say "done", "cancelled", "still working", "defer to XX" → Auto-update table
• Say "review" → PMBOK-style progress review

🔧 Diagnostics:

• Say "worklist not working", "diagnose" → 5-item health check

Ready to add a task? Just tell me what you need to do 😊

语言切换规则:

场景	中文模式	英文模式
触发确认	"记一下工作" / "创建个人工作台账"	"add task" / "create worklist"
录入确认	"确认录入"	"confirm"
字段名称	中文(任务名称/优先级/截止日期等)	英文(Task Name / Priority / Deadline 等)
多维表格字段	使用中文选项值	使用英文选项值
提示语	中文自然语言	English natural language

多维表格字段对照表:

中文字段	英文字段	英文选项值
任务名称	Task Name	-
来源分类	Source Category	Planned[P]/Urgent[U]/Routine[R]/Collab[C]
优先级	Priority	① Urgent and Important / ② Not Urgent but Important / ③ Urgent but Not Important / ④ Not Urgent and Not Important
状态	Status	To Do / In Progress / Done / Cancelled
截止日期	Deadline	yyyy/MM/dd
预计时长	Estimated Time	如 1h、2h
开始时间	Start Time	如 9:00
工作链接	Work Link	URL
工作要求	Requirements	-
干系人	Stakeholder	-
存在问题	Issues	-
备注	Notes	-

存储用户偏好: 确认语言环境后,将偏好写入 memory/preferences.json,后续直接调用不再重复询问。

第一阶段:创建台账

触发条件

用户说"创建个人工作台账"(中文)或 "create worklist"(英文)时,执行以下流程。

Step 0: 检查必要技能与权限（强制）

在创建台账之前，必须完成以下两项检查：

1. 检查 feishu-api-bitable 技能是否已安装：

• 检查 ~/.openclaw/workspace-robotB/skills/ 目录下是否存在 eishu-api-bitable 目录
• 或通过 openclaw CLI 查询已安装的 skills

如果技能未安装：

• 立即告知用户需要安装相关技能
• 引导用户访问 https://clawhub.ai 搜索并安装 feishu-api-bitable
• 技能安装完成前不执行后续步骤

2. 检查飞书开放平台权限配置：

• 确认在 飞书开放平台 的应用权限管理中已开通以下权限：
  • itable:app — 多维表格权限
  • itable:table — 数据表权限
  • itable:record — 记录读写权限
• 若权限不足，引导用户前往开放平台的「权限管理」页面申请开通

示例提示语：

"创建台账前需要：

1. 安装【飞书多维表格 API 技能】— 访问 https://clawhub.ai 搜索 eishu-api-bitable 并安装
2. 确认【飞书开放平台权限】— 请检查您的应用是否已开通多维表格相关权限（bitable:app / bitable:table / bitable:record）

安装完成并确认权限后请告诉我，我将继续为您创建台账。"

Step 1:检查飞书 API 权限

凭证自动获取（本 skill 自动从 OpenClaw 配置读取，无需用户手动填写）：

• APP_ID → 自动从 openclaw.json 的 channels.feishu.appId 读取
• APP_SECRET → 自动从 openclaw.json 的 channels.feishu.appSecret 读取
• APP_TOKEN → 用户需提供（多用户场景，每个用户表格不同）
• Table ID → 用户需提供

如果用户已有飞书多维表格，可直接询问链接，从链接中提取 App Token 和 Table ID。 如果用户提供的是已有表格链接，AI 应主动询问："您希望套用标准工作台账模板来优化这个表格吗？这样会自动创建必要的字段和选项。" 如果用户没有表格，需要引导其调用node scripts/init_table.js 在飞书多维表格里创建标准工作台账。

权限检查：

bash

node scripts/check_permissions.js

（无需传参数，APP_ID 和 APP_SECRET 自动获取）

Step 2:应用工作台账模板

无论用户是新建表格还是提供已有表格链接，都应执行以下流程：

选项 A：新用户新建表格

• 用户没有多维表格 → 必须调用 node scripts/init_table.js 创建标准工作台账
• AI 禁止直接调飞书 API 创建表格，必须通过 init_table.js 脚本执行
• 脚本内部已内置完整字段模板，AI 必须严格遵循，不自行构造 API 调用

选项 B：用户提供已有表格

• 用户提供了多维表格链接 → AI 主动询问模板应用
• 询问语：您已有工作台账，是否需要套用标准模板来优化表格结构？（会自动创建缺失的字段和选项）
• 用户同意后 → 必须调用 node scripts/init_table.js 严格按照模板创建/补全字段
• 用户拒绝 → 仅记录当前表格信息，不做修改
• AI 禁止直接调飞书 API 修改用户已有表格结构，必须通过 init_table.js 执行

字段模板（强制）：

字段名	类型	选项/说明
任务名称	文本	必填
来源分类	单选	计划任务[P] / 临时任务[U] / 例行任务[R] / 协作任务[C]
优先级	单选	①紧急且重要 / ②重要不紧急 / ③紧急不重要 / ④不紧急不重要
状态	单选	待办 / 进行中 / 已完成 / 取消
截止日期	日期	yyyy/MM/dd
预计时长	文本	如 1h、2h
开始时间	文本	如 9:00 或 2026-04-23
工作链接	URL	链接格式
工作要求	多行文本	刚性要求、时间节点、执行标准
干系人	文本	支持多人(用中文顿号分隔)
存在问题	多行文本	复盘时记录阻碍原因
备注	多行文本	补充说明

Step 3:配置凭证

凭证自动获取（仅 APP_TOKEN 和 TABLE_ID 需要用户手动填写）：

javascript

const CONFIG = {
  APP_ID: '自动获取',        // 从 openclaw.json 自动读取
  APP_SECRET: '自动获取',    // 从 openclaw.json 自动读取
  APP_TOKEN: 'YOUR_APP_TOKEN',   // 用户手动填写
  TABLE_ID: 'YOUR_TABLE_ID'      // 用户手动填写
};

Step 4:初始化表格 & 配置权限（一步完成）

运行初始化脚本（包含权限配置，无需分两步）：

bash

node scripts/init_table.js --open-id "USER_OPEN_ID"

自动化能力（本脚本执行以下操作，无需用户手动操作）：

• 检查多维表格是否存在，不存在则自动创建
• 新建表格时，自动清空默认字段和行数据（新建表格自带一个默认文本列和示例行，必须清除后再创建我们的字段和记录）
• 检查必填字段是否存在，不存在则自动创建（包括单选字段的选项配置）
• 自动将用户添加为表格编辑者（通过 --open-id 参数）
• 全程中英文双语支持（根据用户语言偏好自动切换）

参数说明：

• --open-id: 用户的飞书 Open ID（即对话上下文中的 sender_id），必填，否则用户无法访问自己的表格
• --lang: 可选，强制指定语言（zh/en），默认从 preferences.json 读取

权限配置闭环（强制）：

⚠️ 【关键】如果不传 --open-id，用户将无法访问自己刚创建的多维表格，所有数据操作都会失败。

AI 自动从对话上下文中读取 sender_id，拼接为 --open-id 参数调用脚本。

AI 主动处理原则：

• 用户无需主动去申请权限
• AI 自动将用户账号加入编辑者列表
• 如遇权限 API 报错，AI 立即提供手动申请指引并持续跟进

Step 4C: 触发词引导（完成后即执行）

台账创建成功后，立即向用户展示本 skill 的触发词和使用说明（不要等待用户主动询问）：

🎉 台账创建成功！

您的个人工作台账已就绪 ✅

📝 任务录入（直接说）：

• "记一下这个工作：XXXX" → 立即录入任务
• "创建个人工作台账" → 创建新台账

🔔 定时提醒：

• 首次录入任务后，我会引导您设置每天三个时间点的提醒（早晨 08:28 / 下午 14:00 / 下班前 17:30）

📋 状态更新：

• 说"完成了"、"取消了"、"还在做"、"推迟到XX" → 自动更新表格
• 说"复盘" → 下班前 PMBOK 式进度复盘

🔧 异常诊断：

• 说"台账不工作了"、"诊断" → 5项健康检查

要开始录入任务吗？直接告诉我任务内容即可 😊

注意： 触发词引导与权限配置为两个独立步骤，必须全部完成后才告知用户台账创建完成。

Step 4D: 确认配置定时提醒（完成后即执行，不得跳过）

台账配置完成后，立即引导用户设置每日定时提醒，不得以任何理由跳过或推迟：

🔔 定时提醒设置

您的个人工作台账已就绪 ✅ 现在建议设置每日定时提醒，每天自动推送工作清单：

• 🌅 早晨 08:28 — 当日工作重点
• 🌤️ 下午 14:00 — 下午工作安排
• 🌆 下班前 17:30 — PMBOK 进度复盘

是否现在设置？回复「是」或「设置提醒」，我将立即为您配置三条定时任务。

【强制约束】

• 定时提醒设置是台账初始化流程的标准步骤，不得跳过，不得以"稍后再说"、"我先试试录入"等理由推迟
• 只有 Jerry 明确回复「不需要」或「暂不需要」时才跳过；任何其他沉默或模糊回复均视为需要设置
• 确认设置后，执行 node scripts/setup_reminders.js --open-id=USER_OPEN_ID --lang zh|en（USER_OPEN_ID 从会话上下文获取，格式：ou_xxxxxxxx）。脚本内部已硬编码当前会话 session-key，确保推送绑定到当前飞书聊天窗口
• 推送对象必须为当前聊天窗口的 delivery target：会话元数据中 chat_id 即为当前聊天窗口，直接作为 to 参数传入脚本；不得使用硬编码或旧配置中的用户 ID
• 创建完成后必须手动验证：执行 cron run <jobId> 触发一次即时推送，验证飞书是否收到；若推送失败，排查以下原因：
  1. to 字段格式是否正确（应为 user:ou_xxxxxxxx）
  2. channel 是否为 feishu
  3. 若是 isolated session 推送，需确认 to 字段包含完整 open_id，而非仅 chat_id
  4. 修复后再次测试，直到推送成功
• 验证通过前不得向 Jerry 报告"定时任务设置成功"；验证失败必须说明原因并给出修复方案

---

第二阶段:任务录入

触发规则(双轨制)

强触发 - 直接录入: 用户说"记一下这个工作" + 任务内容 → 立即进入录入流程,询问补全必填字段。

弱触发 - 询问确认: 用户发送了工作相关内容但没有明确触发词 → 主动询问"是否要录入工作台账?"

注意:用户明确表示不录入、或说"暂不需要"时,不追问。

录入前确认原则(强制)

三项必填字段必须在录入前与用户逐一确认,禁止自行推断或编造:

字段	确认方式	如用户未提供
任务名称	请用户确认	必须追问
优先级	请用户选择(①~④)	必须追问
截止日期	请用户确认	必须追问

确认话术示例:

"好的,我来帮您录入这条工作。确认一下:

• 任务名称: [提取的内容]
• 优先级: [①紧急且重要 / ②重要不紧急 / ③紧急不重要 / ④不紧急不重要]?
• 截止日期: 哪一天?"

以上三项必须全部明确回复才能写入,如有任意一项用户未给出明确答案,必须追问到明确为止。

来源分类自动归类规则:

• 用户未提及来源分类时，不追问，自动归类为「临时任务[U]」
• 用户提及明确的协作对象 → 归类为「协作任务[C]」
• 用户提及周期性的工作内容（如每周、每月、每季度）→ 归类为「例行任务[R]」
• 用户明确说明是计划内的工作 → 归类为「计划任务[P]」

其他可选字段处理规则:

• 工作要求 / 工作链接 / 干系人 / 备注 / 预计时长：用户提及则记录，未提及则留空
• 录入时必须主动询问：必填三项确认后，逐一询问"工作要求/干系人/工作链接/备注/预计时长需要录入吗？"
• 禁止主动推断或补充（如用户没说干系人，AI 不得自作主张填写）
• 可从用户描述中提取的内容,直接写入(无需确认)
• 用户未提到的可选字段,留空不写,禁止推断
• 典型错误示例:用户没说干系人,AI 自作主张写"同事" → 严禁

三项必填字段全部确认后,方可写入多维表格。

相对日期处理规则(强制)

触发场景: 用户描述中包含"今天"、"明天"、"后天"、"本周五"、"下周三"等相对日期词。

处理步骤:

1. 将相对日期转换为具体年月日(如"明天"→ 2026-04-24)
2. 禁止写入"今天/明天/后天"等模糊词
3. 回复时必须显式写出具体日期 + 星期(如"2026-04-25 本周五")

三步验证法(强制):

1. 确认今天是几月几号、星期几
2. 计算加几天(目标星期 - 今天星期)
3. 反向验证:算出的日期星期几是否与目标星期匹配

选项值约束（强制）

【强制】选项值约束（必须遵守）：

字段	可选值（仅以下选项，禁止自行填入其他值）
来源分类	计划任务[P] / 临时任务[U] / 例行任务[R] / 协作任务[C]
优先级	①紧急且重要 / ②重要不紧急 / ③紧急不重要 / ④不紧急不重要
状态	待办 / 进行中 / 已完成 / 取消

禁止行为：

• 禁止自行推断或编造选项值（不存在的选项会污染表格数据）
• 若用户提供的值不在上述选项中，必须追问确认
• AI 只能使用表格中已有的选项值写入，禁止创建新选项

字段精确性要求（强制）：

• 优先级只允许以下4个精确值（无空格）：
  • ①紧急且重要
  • ②重要不紧急
  • ③紧急不重要
  • ④不紧急不重要
• 状态只允许以下4个精确值（无空格）：
  • 待办
  • 进行中
  • 已完成
  • 取消
• 来源分类只允许以下4个精确值（无空格）：
  • 计划任务[P]
  • 临时任务[U]
  • 例行任务[R]
  • 协作任务[C]

如用户描述的值无法与现有选项精确匹配，先确认后再录入，不得自行猜测格式。

字段放置规则

字段	放置位置	说明
工作要求	「工作要求」列	刚性要求、时间节点、执行标准；开始时间/截止时间含具体时间点时，自动追加时间备注到工作要求开头
备注	「备注」列	补充说明、上下文信息
干系人	「干系人」列	联系人姓名(用顿号分隔)

时间精度保全规则（强制）

问题背景：飞书多维表格的「开始时间」和「截止日期」字段类型为日期，不保存具体时间点（如 14:30）。

解决方案：当 --start "2026-05-20 14:30" 或 --deadline "2026-05-20 17:30" 中包含时间部分时，自动提取并以 ⏰ HH:MM开始，HH:MM截止。 格式追加到工作要求字段开头。

示例：

• 输入：--start "2026-05-20 14:30" --deadline "2026-05-20 17:30" --requirement "讨论拔钉插旗目标调整"
• 工作要求输出：⏰ 14:30开始，17:30截止。讨论拔钉插旗目标调整
• 开始时间/截止日期字段：仅保存日期部分（2026-05-20）

时机：仅在用户传入的时间字符串中含具体时间点时触发，自动执行无需询问。

---

第三阶段:定时提醒

不依赖 OpenClaw cron 系统,在每次用户对话时主动检查并发送提醒。

提醒语言规则(强制):

定时提醒的语言必须与用户设置的语言环境一致。

• 中文模式 → 全程中文输出("早呀~今日重点如下...")
• 英文模式 → 全程英文输出("Good morning! Here's your today's focus...")

禁止在英文模式下输出中文提醒,也禁止在中文模式下输出英文提醒。

技术实现:

• scripts/request.js - 统一请求层(Token 缓存 + 提前刷新、10秒超时、401 自动刷新、3次指数退避重试)
• 所有 API 调用(add_task / update_task / list_tasks / init_table / health_check)均通过 request.js 发请求
• scripts/i18n.js 提供完整的双语文本模板(中/英文各一套)
• 定时提醒内容从 i18n.js 的模板中取对应语言版本,确保输出语言与用户偏好一致

早晨提醒(建议时间 08:28)

触发条件: 每天 08:28 触发，必须先调用 API 判断是否发送。

工作日判断（强制）:

1. 调用 http://api.jiejiariapi.com/v1/holidays/2026 查询全年节假日数据
2. 从返回结果中查找当天日期（如 2026-05-11）的 isOffDay 字段：
   • isOffDay == false（工作日/调休上班日）→ 执行步骤1发送任务
   • isOffDay == true（休息日/法定节日）→ 静默跳过，不发消息
   • API 出错 → 发出 api 失败的消息后静默结束，不发消息
3. 绝对禁止凭"周几"或训练数据常识跳过 API 调用！

步骤1：发送任务 从飞书多维表格读取开始时间<=今天且状态<>已完成且状态<>取消的任务，按以下格式输出：

输出格式(三部分):

1. 今日重点(紧急且重要 × N): 优先级为 1 的任务列前,注明任务名、优先级、截止时间
2. 进行中/待办任务(X 项): 其余进行中/待办任务,表格形式列出任务名、状态、截止、优先级
3. 建议时间安排:
   • 先抽 30 分钟处理:
     • OA 待办审批
     • 工作邮件处理
     • 补充/更新当日工作清单

下午提醒(建议时间 14:00)

工作日判断（强制，与早晨提醒相同逻辑）:

1. 调用 http://api.jiejiariapi.com/v1/holidays/2026 查询全年节假日数据
2. 从返回结果中查找当天日期（如 2026-05-11）的 isOffDay 字段：
   • isOffDay == false（工作日/调休上班日）→ 执行步骤1发送任务
   • isOffDay == true（休息日/法定节日）→ 静默跳过，不发消息
   • API 出错 → 发出 api 失败的消息后静默结束，不发消息
3. 绝对禁止凭"周几"或训练数据常识跳过 API 调用！

步骤1：发送任务 从飞书多维表格读取开始时间<=今天且状态<>已完成且状态<>取消的任务，发送下午工作计划（含上午未完成任务回顾）。

输出格式同早晨提醒。

下班前复盘(17:30)

工作日判断（强制，与早晨提醒相同逻辑）:

1. 调用 http://api.jiejiariapi.com/v1/holidays/2026 查询全年节假日数据
2. 从返回结果中查找当天日期（如 2026-05-11）的 isOffDay 字段：
   • isOffDay == false（工作日/调休上班日）→ 执行复盘步骤
   • isOffDay == true（休息日/法定节日）→ 静默跳过，不发消息
   • API 出错 → 发出 api 失败的消息后静默结束，不发消息
3. 绝对禁止凭"周几"或训练数据常识跳过 API 调用！

执行步骤(5步,缺一不可):

1 主动拉取任务数据 从飞书多维表格获取截止日期 = 今天 且 状态 ≠ 已完成 且 状态 ≠ 取消的所有任务。

2 量化复盘(截止日期 = 今天)

格式:"今日工作清单共 X 项(截止日期为今天),完成 X 项,完成率 X%"

3 未完成任务逐一决策 对每项截止日期为今天且状态 ≠ 已完成的任务,逐一确认后续计划:

• 推迟截止日期 → 记录新的截止日期
• 确认取消闭环 → 记录取消原因,状态改为「取消」
• 已有后续计划 → 记录后续计划和时间节点

4 阻碍分析与工作建议

• 询问用户各未完成任务中存在的问题或阻碍
• 将问题填写到多维表格的「存在问题」字段
• 根据情况给出专业建议:
  • 风险应对:规避(消除)/ 转移(转嫁)/ 缓解(降低)/ 接受(承担)
  • 进度纠偏:赶工 / 快速跟进 / 调整范围

5 明日预告 预告明天重要且紧急的工作(状态 ≠ 已完成),提醒做好工作时间安排。

---

第四阶段:状态更新

状态更新双路径(用户自主选择)

路径一:对话驱动更新(AI 协助) 通过与 AI 对话,告知状态变更指令,AI 自动调用 update_task.js 写入多维表格。

适用场景:口头汇报、复盘讨论、进度同步

路径二:直接手动更新(用户自管理)【优选】 用户登录飞书多维表格,直接在单元格中编辑任务状态、存在问题、截止日期等信息。

适用场景:用户习惯直接操作表格、时间紧迫时、快速批量修改

说明:

• 两种路径可并存,由用户根据自身工作习惯自主选择
• 路径二为【优选】,因为手动操作最直接、无歧义、无需等待 AI 响应
• AI 在路径一种的角色是协助者而非主导者,目的是降低用户的操作成本

主动闭环原则(强制)

用户给出任何状态变更指令时,立即执行 update_task.js 更新多维表格,不得只做口头回复。

触发场景:

• 用户说"完成了" → 立即更新为「已完成」
• 用户说"取消了" / "闭环了" → 立即更新为「取消」
• 用户说"还在做" → 立即更新为「进行中」
• 用户说"推迟到XX" → 立即更新截止日期(相对日期要三步验证 + 回显确认)
• 复盘时用户说明了阻碍原因 → 立即写入「存在问题」字段

禁止行为: 听到状态变更只说"好的收到"而不操作表格。

---

经验教训库(来自 jerry-task-manager 实操总结)

以下规则已验证有效,新用户应直接遵守,避免重复踩坑:

日期	场景	规则
2026-04-23	日期转换跳步	相对日期必须三步验证,防止思维跳格
2026-04-23	日期回显	更新后必须写具体日期+星期,让用户确认
2026-04-23	明日预告过滤	明日预告只包含状态≠已完成的任务,已完成的不出现
2026-04-23	字段放置	工作要求列放刚性要求,备注列放补充说明,禁止放反
2026-04-24	三项必填确认	任务名称/优先级/截止日期必须逐一与用户确认，禁止自行推断或编造；来源分类自动归类，不追问
2026-04-24	禁止过度推断	用户未提到的可选字段留空,禁止凭想象填写(如用户没说干系人就写"同事")
2026-04-22	状态闭环	用户说"完成了"立即更新表格,不等二次提醒
2026-04-22	相对日期	禁止写"明天"等模糊词,必须写具体日期
2026-04-24	脚本优先	优先使用 Skill 内置脚本(如 init_table.js),禁止自行构造 API 调用,确保用户体验一致
2026-04-21	优先级精确值	只允许四个精确值,匹配失败会污染表格选项
2026-05-07	cron 超时	下班前复盘(PMBOK五步)执行时间超过120s → 需将timeout设置为300s以上
2026-05-07	相对日期转换	今天/明天/后天等必须转换为具体日期再写入表格，禁止模糊词入库
2026-05-08	cron任务状态筛选bug	cron提醒消息中"状态<>已完成"未生效，已完成任务也被推送。必须在时间条件基础上叠加 status !== '已完成' && status !== '取消' 过滤，不能依赖模糊条件
2026-05-09	调休判断必须调用API	判断工作日必须调用 http://api.jiejiariapi.com/v1/holidays/2026 查询 isOffDay 字段：false=工作日/调休上班日发送，true=休息日/节日静默，API失败需发失败消息后静默。绝对禁止凭"周几"或 LLM 训练数据常识跳过 API 调用！
2026-05-09	URL字段放置	用户描述中含URL时必须写入「工作链接」字段，禁止混入「备注」；录入前扫描任务内容，自动识别并分流 URL
2026-05-11	API年份限制	jiejiariapi 免费额度仅支持 2026 年，2027 年数据需等开放后手动切换；切换后需同步更新三条 cron 任务的 message 模板
2026-05-12	定时任务 Prompt 精简原则	cron job 的 payload message 应精简为核心指令（工作日判断→飞书查询→输出格式），删除冗余步骤说明和格式模板，可减少约 30% 推理耗时。精简后的 prompt 已更新到 scripts/setup_reminders.js 的 REMINDERS 配置中，作为未来新建定时任务的配置基准线
2026-05-14	量化复盘查询不对称bug	量化复盘使用「截止日期」作为统计口径，但cron旧prompt用「开始时间」查询未完成任务，导致统计基数不一致。修复：统一使用「截止日期」作为全部统计口径（已完成/未完成/明日预告均基于截止日期过滤）；修复query_today_tasks.js硬编码日期bug
2026-05-14	日期比对方言不一致导致统计错误	cron旧prompt中「截止日期为今天且状态=已完成」与「开始时间<=今天且状态<>已完成且状态<>取消」使用不同字段，造成同一任务在完成统计和未完成统计中口径不一致。修复：统一用「截止日期」作为唯一口径，删除「开始时间」字段的引用

---

脚本说明

脚本	用途	关键参数
setup_reminders.js	定时提醒设置引导（创建后需手动验证推送）	`--lang zh
check_permissions.js	检查飞书 API 连通性	--app-id, --app-secret
init_table.js	初始化表格(自动创建表格和字段,类型一致则跳过)	无参数(自动检测语言偏好)
health_check.js	健康诊断(网络/凭证/表格/字段5项检查,使用 request.js)	无参数(自动检测语言偏好)
set_config.js	动态更新飞书 API 凭证(支持部分更新)	--app-id, --app-secret, --app-token, --table-id, --list
request.js	统一请求层(Token缓存/10s超时/401刷新/3次重试)	内部使用,供其他脚本调用
add_task.js	添加任务记录(使用 request.js)	--task, --source, --priority, --deadline, ... --lang
update_task.js	更新任务记录	--record-id, --status, --deadline, --start, --duration, --notes, --problem, --stakeholders, --lang
list_tasks.js	读取任务列表(根据语言偏好输出)	无参数
utils.js	飞书 API 工具函数(getAccessToken)	无
preferences.js	用户偏好读写(语言设置)	getLanguage(), setLanguage(lang)
i18n.js	国际化文本模板(定时提醒/输出文本)	getTemplates(lang), format(template, data)

---

完成标准(每条可打勾验证)

• 用户说"创建个人工作台账"后,能引导完成完整的台账创建流程
• 三个必填字段（任务名称/优先级/截止日期）齐全时能立即写入多维表格，无需等待全部字段咨询完毕
• 相对日期能正确转换并回显具体日期+星期
• 定时提醒能正确筛选并输出格式正确的三段式提醒
• 下班前复盘能完成5步闭环(拉取→量化→决策→分析→预告)
• 状态变更能立即执行表格更新,不只做口头回复
• 经验教训库中的规则被遵守,不重复已知的错误

---

异常处理

• API 连通性失败 → 提示用户检查 App ID / App Secret / 网络连接
• 表格字段不匹配 → 提示用户在飞书中检查字段配置
• 日期计算错误 → 使用三步验证法重新计算并向用户确认
• 权限不足 → 提示用户在飞书多维表格中给自己添加管理员权限