admin
c1b5e4d966
- 变更规模：新增 514 / 修改 62 / 重命名 155 / 删除 4（归档重组与文档轮次） - .gitignore 修：`归档/**/db-cwd归一-备份-*/` —— 原规则写绝对层级（归档/db-cwd归一-…）， 目录搬进 归档/配置与备份/ 后**静默失效**，43 MB 的 DB 备份又变成未跟踪 - .gitignore 补：嵌套 git 内部数据（归档/内嵌git-20261008/、归档/skills-git-旧线-20261007/dotgit-原样移出/） - .gitignore 补：运行态与部署副本（.workbuddy/collab/、.workbuddy/tools/、.workbuddy/.load-pending、.workbuddy/tmp-*） - .gitignore 补：备份件（*.bak-*） - 未跟踪文件从 2190 降到 890（其余为 归档/ 归档件与 .workbuddy/memory/ 知识文件，按口径入库）
4.2 KiB
4.2 KiB
🔴 交付物/ 权威索引（先读这一份 · 最后更新 2026-09-30 05:46）
为什么要这份（用户 2026-09-30 点破）： 「现在的文档记录方式有问题，没把重点放在前面，都是记录历史，结果是最新的结论在最后」。 后果：谁先读到旧文档，谁就把旧结论当现状（当天连续三次犯此错）。 ⇒ 本索引给出唯一入口：哪份是"活文档"（会更新、可作判据）／哪份是"历史件"（⛔ 不作用现状）。
一、规矩（三条，硬）
- ⛔ 不从"历史件"取现状 —— 历史件只作背景/沿革，⛔ 不作判据（典型症状：拿它的旧结论当现在的状态）。
- 判"现在是什么" ⇒ 读「活文档」；活文档头部必须有「当前结论 ＋ 最后更新」，没有的一律先按历史件对待。
- 一份文档退役 ⇒ 头部加退役块（指向权威件），⛔ 不删 —— 留痕，但⛔ 不冒充现状。
二、活文档（会更新 · 可作判据）
| 话题 | 权威件 | 说明 |
|---|---|---|
| 协作机制（架构） | ~/.workbuddy/skills/multi-session-collab/references/architecture.md |
唯一架构文档（09-29 用户定案）；头部带「当前结论」节 |
| 协作机制（操作） | ~/.workbuddy/skills/multi-session-collab/SKILL.md ＋ references/{deploy,pitfalls}.md |
操作入口／部署与起法／踩坑 |
| 作业总规矩 | ~/.workbuddy/skills/agent-operating-rules/SKILL.md |
含 §1.7a「写文档：结论前置、历史下沉」§1.7b「核实现状先取最新记录」§1.8「⛔ 不得擅自改用户定案」 |
| 本工作区规则 | CODEBUDDY.md ＋ .workbuddy/memory/MEMORY.md（状态层速查） |
⚠️ 这两份尚未加「当前结论」头部（待办，见 §四） |
| 手机接入（业务） | 交付物/架构总览-20260929.md（业务架构）· 交付物/手机接入-目标与协同计划-20260929.md（目标与 V1–V7）· 交付物/手机App经覆盖网络操作WorkBuddy-架构定稿v3-20260929.md（§0.5 硬约束/排除清单） |
与协作机制分开的两件事 |
| 手机接入（实时状态） | 交付物/手机接入-实时状态.md |
机器产物（collabd 每 10s 覆写，头部自带生成时间）— ⛔ 不是人工文档 |
⚠️ 看板 ≠ 状态源：上面那份机器看板是投影；判"需求完成没有"以「验收判据 V1–V7」为准（见下条）。 🔴 注意（当天踩过）：
交付物/任务图.json的done＝「这根棒跑完了」，⛔ 不等于「该判据通过」 —— 铁证：N14 节点是done，而 N14 判的正是「V1 ❌ 未过」。⛔ 别拿任务图 done 当"目标达成"。
三、历史件（⛔ 不作用现状）
2026-09-30 已加统一退役标注（头部有「⛔ 已退役」块）：
| 文件 | 原身份 |
|---|---|
多会话协同机制-定稿-20260929.md |
机制定义（原自称"权威"） |
多会话协同机制-实施方案-20260929.md |
实施方案 |
多会话协同-顶层设计-20260929.md |
顶层设计（自评"一直在局部打补丁"） |
协同监管棒-SOP.md |
作业规程（自称"术语已退役"） |
落地清单-唤醒回路-20260929.md |
落地清单·唤醒回路 |
其余 交付物/ 下的件（共 90 份）：一律按历史件对待——它们记录了"当时怎么做的／当时判成什么"，
⛔ 不作用判据。要判现状 ⇒ 回 §二 的活文档，或看该话题最新的实测单（按 mtime 取最新那份）。
四、待办（需要用户拍板或后续做）
- 🔴
goals_open()不读验收判据 V1–V7 ⇒ 目标未达成时会误判完成、心跳停（当天咬过一次）。 建议：goal.json增acceptance_state（任一非 pass ⇒ 算未完成）。 - ⚠️
CODEBUDDY.md＋.workbuddy/memory/MEMORY.md尚未加「当前结论」头部（前者是高影响面规则件，⛔ 未擅自改）。 - ⚠️ 其余"结论型"文档（技能 references、docs/）尚未逐份加头部 —— 建议只改"会被反复读的活文档"， ⛔ 不追求 471 份全覆盖（那会把问题变成维护灾难）。