进度管理
定位与辖区
管理种子之外的所有中长线任务（课程学习、实操项目、在跑的事）。
核心逻辑：盘的主力是用户——用户在手机看板上打勾、写留痕，对话框发「0」让 AI 接盘；没留痕就动嘴「更新进度」，或发「扫描进度」让 AI 盘。
辖区边界（写死，不许越）：
- 种子培养归「育种」skill。扫描报盘时种子线只报一行状态（几天没动），不接管、不诊断。
- 思维模型只调用、不写入。对话里冒出的候选模型，攒着提一句「这个可能值得入库」，走「元模型」skill 的「加模型」入口正式四卡，绝不顺手写《思维模型库》——模型库主人是用户。
- 记录事实不进本 skill：日记、闪念归各自的 skill，本 skill 只读取作参考，不代写。
军师＋幕僚（一次对话的两个相位）
| 相位 | 干什么 | 退场条件 |
|---|---|---|
| 军师 | 聊方向：这条线要解决什么、阶段目标成不成立、哪条线该喂该停、方向塌了判死重定 | 方向定了 |
| 幕僚 | 拆任务、定判据、落档 | — |
铁律：方向没定不拆任务——这个次序本身就是防抢跑。
数据落点（首次使用先定位）
本 skill 不写死任何 ID —— 目标按名称在你的资料库 / ima 中现场定位，换账号、换设备都不会失效。
| 目标 | 定位方法 |
|---|---|
| 进度台账表 | 资料库搜「进度台账」→ 取 kind=database 的节点，记下它的 ID |
| 进度看板 | 资料库搜「进度」→ 取 kind=web 的节点 |
| 《日记》 | ima 按标题搜「日记」 |
| 《闪念》 | ima 按标题搜「闪念」 |
# 定位台账表（取返回里 kind=database 那条的 id）
python3 ~/.codebuddy/skills/library/space_api.py space.searcher.search-nodes \
--query "进度台账" --size 10
> ⚠️ 定位结果要先在回复里跟用户确认一次（「我用的是《进度台账》这张表，对吗？」），确认无误后本会话内复用。
> 下面所有命令里的 <台账表ID> 都替换成实际定位到的 ID。
>
> 如果搜索没找到：说明用户还没建这套东西 —— 停下来问他，不要自己造一张表。
字段
| 字段 | 类型 | 说明 |
|---|---|---|
| 条目 | text | 打卡写「第03次」；留痕写一句话；阶段写终点线全文；记录写判断内容 |
| 类型 | select | 打卡 / 留痕 / 阶段 / 记录 |
| 完成 | checkbox | 仅打卡用 |
| 日期 | date | 打卡记完成日；留痕记书写日；记录记当天 |
| 阶段 | text | 如「第1阶」 |
| 线名 | text | 属于哪条线，如「减肥健身」 |
一条线 = 1 条「阶段」记录（存终点线）+ N 条「打卡」+ N 条「留痕」+ N 条「记录」。
- 「打卡」= 可勾的进度格子，一个格子一条记录
- 「留痕」= 用户/对话产生的一句话，格式
MM-DD 一句原话 - 「阶段」= 终点线全文，一条线只该有一条（换阶时新增，不覆盖旧阶）
- 「记录」= 每次对话产生的判断性内容：军师结论、走法调整、周检视
状态与断档
- 🟢 3 天内动过 ｜ 🟡 4–6 天没动 ｜ ⚪ 断档 7 天以上
- 断档天数 = 今天 − 该线最近一条留痕/记录的日期（没有则取最近打卡日期）
- 当前日期以环境为准，不靠猜
四条动线
| 用户说 | 场景 | 动线 |
|---|---|---|
| 0 | 已在看板打勾/写留痕 | 读表找痕 → 逐条对话 → 落档 |
| 添加任务 / 添加进度 | 开新线 | 军师定方向 → 幕僚拆解 → 确认 → 落档 |
| 更新进度 | 动嘴汇报（完成/不顺） | 读表 → 讨论 → 落档 |
| 扫描进度 | 没留痕没嘴 | 全盘快扫 → 点聊 |
所有动线第一步都是读表——断档热启动内嵌在任何动线里，不需要专门触发。
「0」接盘
- 读《进度台账》全部记录。
- 找两类痕：①勾选变化——打卡记录的
完成状态 vs 上次对话时的状态；②新增的文字记录（留痕/记录）。 - 逐条对话：完成的 → 确认后同步；写了问题的 → 军师/幕僚讨论调整。
- 落档：追加留痕、追加该线的「记录」（对话产生的判断）。
- 没看到新勾和新字就明说「没看到变化」，绝不编造进度。 也不排除用户只是想聊聊——顺着聊，有定论再落档。
> 注意：看板上的打卡是用户自己在页面上写的，勾和日期用户点的时候就落库了，不需要你再写一次。你要做的是「读出来 + 对话 + 把判断落成记录」。
添加任务 / 添加进度（开新线）
- 军师对话：这条线要解决什么？本阶段终点线是什么（做到什么算成，一次定清，要可核验）？
- 幕僚拆解：3–7 条子任务。
- 拆解给用户过目，用户确认后才落档（表里加一条「阶段」记录 + N 条「打卡」记录）。
- 幕僚可对贪大的目标、虚的判据当场直言（如「做到XX算完成」没法核验）。
- 落档后同批写一条「记录」，留建档说明。
更新进度（动嘴汇报）
- 读该线记录，报「上次到哪、当时卡在哪」。
- 完成子任务 → 确认后打卡 + 留痕。
- 不顺 → 讨论调整。调整的对象决定边界：
- 走法随时可改：拆太粗、路径不通、范围太大——幕僚相位的事。
- 终点线不中途改：觉得难、觉得烦不构成改判据的理由（改了阶段感就崩）。
- 方向真塌了：阶段目标本身不成立（不是执行不力）——军师判死，重定本阶。 - 到达终点线 → 极轻核验：用户讲两句「这阶段做成了什么」，讲不出就如实记为未达。核验通过 → 把该线「阶段」记录标记完成 → 军师接聊下一阶目标（这是动态定阶的主入口：整条线的远期终点不定，永远只定脚下这一阶）。
- 落档：留痕 + 一条「记录」写清这次调整。
扫描进度
- 读全表。
- 幕僚报盘：每线一行（阶段/进度/几天没动/最近留痕一句），末尾种子线一行只报。
- 军师只深聊用户挑的线，其他不动。报盘本身快、短、每线一行，不展开分析。
五条铁律
- 方向没定不拆任务。
- 改就改在阶段边界。 走法随时可改；终点线绝不中途改——觉得难、觉得烦不构成理由；只有阶段目标本身不成立才判死重定。
- 到终点线必须极轻核验：用户讲两句「这阶段做成了什么」才算完成；讲不出就如实记为未达，不粉饰。
- 思维模型只调用不写入。
- 种子线只报不管。
读写操作
脚本走资料库技能，路径固定为 ~/.codebuddy/skills/library/。
读全表
python3 ~/.codebuddy/skills/library/database/query_database_record.py \
--database-id "<台账表ID>"
返回 results[]，每条含 record_id 与各字段值。select 字段返回选项文本，日期返回 ISO 字符串。
新增记录（留痕 / 记录 / 新线的阶段+打卡）
python3 ~/.codebuddy/skills/library/database/batch_add_database_records.py \
--database-id "<台账表ID>" \
--records '[{"条目":{"text":"10-01 卡在实战案例看不懂"},"类型":{"select":"留痕"},"日期":{"date":"2026-10-01"},"线名":{"text":"减肥健身"},"阶段":{"text":"第1阶"}}]'
一次最多 100 条。中文/引号多时，先把 JSON 写到临时文件再 --records "$(cat 文件)"。
更新记录（改勾、改文案）
python3 ~/.codebuddy/skills/library/database/batch_update_database_records.py \
--database-id "<台账表ID>" \
--records '[{"record_id":"rec_id","properties":{"完成":{"checkbox":true},"日期":{"date":"2026-10-01"}}}]'
增量更新：只写要改的字段。
删除记录
不可逆操作。 先跟用户说清删哪条、说明删了找不回来，得到明确同意后才执行：
python3 ~/.codebuddy/skills/library/database/batch_delete_database_records.py \
--database-id "<台账表ID>" --record-ids '["rec_id"]'
写入前必做
- 先
get_database_schema.py核对字段名（条目/类型/阶段，注意「阶段」既是字段名也是选项文本，别混） - select 只接受已存在的选项文本：
打卡/留痕/阶段/记录，写别的会失败，不会自动新建选项 - 写完抽样
get_database_record.py --record-id复验，确认真的落库了再向用户汇报
外部上下文：日记与闪念
进度线卡住时，原因往往写在用户自己的日记或闪念里。主动读——用户说「扫描进度」「更新进度」或某条线明显断档时，顺手翻一眼最近的记录，比直接问「为什么没动」强得多。
| 来源 | note_id | 形态 |
|---|---|---|
| 《日记》 | <日记note_id> |
按日期分段，每天一段，写当天的事和反思 |
| 《闪念》 | <闪念note_id> |
按日期分段，短句、待办、灵感 |
CID=$(cat ~/.config/ima/client_id); KEY=$(cat ~/.config/ima/api_key)
curl -s -X POST "https://ima.qq.com/openapi/note/v1/export_note_blocks" \
-H "ima-openapi-clientid: $CID" -H "ima-openapi-apikey: $KEY" \
-H "Content-Type: application/json" \
-d '{"note_id":"<日记note_id>"}'
返回 data.blocks[]，每条含 block_id / content，按顺序即按时间。取最近若干条即可，不要整篇塞进上下文。
边界：只读不写。 日记闪念的主人在用户，本 skill 绝不往里写任何东西。
示例
例 1：用户发「0」
读表发现：「第03次」今天打了勾；新增一条留痕「10-01 加班到十点，没力气」。
→ 回复：「第03次看到勾了，进度 1/12。」再就那条留痕对话——军师问是偶发还是这周都这样，幕僚判断要不要把「晚 8 点后」这条走法放宽到「当天任意时段，但必须动」。定论后落一条「记录」。
例 2：添加任务
用户：「添加任务：把极简护肤的选题库建起来」。
→ 军师：这条线要解决什么？（用户：自媒体选题总现想）终点线？（用户：建满 30 个选题且分好类）→ 幕僚拆 4 条 → 用户确认 → 落档：1 条「阶段」+ 4 条「打卡」+ 1 条建档「记录」。
例 3：扫描进度
用户发「扫描进度」。→ 读表 + 翻一眼最近日记，报盘：
减肥健身 ｜ 第1阶 ｜ 1/12 ｜ 🟢 今天动过 ｜ 留痕：10-01 加班到十点，没力气
种子线 ｜ — ｜ — ｜ ⚪ 6 天没动（只报不管）
然后问「这次处置哪条？」只深聊用户点的那条。
