personal-worklist-via-feishu

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

双层读取机制：

层级内容读取时机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 相关变量立即停止,等待用户指令安装/卸载/更新 skillopenclaw 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 CategoryPlanned[P]/Urgent[U]/Routine[R]/Collab[C]优先级Priority① Urgent and Important / ② Not Urgent but Important / ③ Urgent but Not Important / ④ Not Urgent and Not Important状态StatusTo Do / In Progress / Done / Cancelled截止日期Deadlineyyyy/MM/dd预计时长Estimated Time如 1h、2h开始时间Start Time如 9:00工作链接Work LinkURL工作要求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-07cron 超时下班前复盘(PMBOK五步)执行时间超过120s → 需将timeout设置为300s以上2026-05-07相对日期转换今天/明天/后天等必须转换为具体日期再写入表格，禁止模糊词入库2026-05-08cron任务状态筛选bugcron提醒消息中"状态<>已完成"未生效，已完成任务也被推送。必须在时间条件基础上叠加 status !== '已完成' && status !== '取消' 过滤，不能依赖模糊条件2026-05-09调休判断必须调用API判断工作日必须调用 http://api.jiejiariapi.com/v1/holidays/2026 查询 isOffDay 字段：false=工作日/调休上班日发送，true=休息日/节日静默，API失败需发失败消息后静默。绝对禁止凭"周几"或 LLM 训练数据常识跳过 API 调用！2026-05-09URL字段放置用户描述中含URL时必须写入「工作链接」字段，禁止混入「备注」；录入前扫描任务内容，自动识别并分流 URL2026-05-11API年份限制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硬编码日期bug2026-05-14日期比对方言不一致导致统计错误cron旧prompt中「截止日期为今天且状态=已完成」与「开始时间<=今天且状态<>已完成且状态<>取消」使用不同字段，造成同一任务在完成统计和未完成统计中口径不一致。修复：统一用「截止日期」作为唯一口径，删除「开始时间」字段的引用

---

脚本说明#

脚本用途关键参数setup_reminders.js定时提醒设置引导（创建后需手动验证推送）`--lang zhcheck_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 / 网络连接
• 表格字段不匹配 → 提示用户在飞书中检查字段配置
• 日期计算错误 → 使用三步验证法重新计算并向用户确认
• 权限不足 → 提示用户在飞书多维表格中给自己添加管理员权限