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/ 知识文件，按口径入库）
59 lines
4.2 KiB
Markdown
59 lines
4.2 KiB
Markdown
# 🔴 交付物/ 权威索引（**先读这一份** · 最后更新 2026-09-30 05:46）
|
||
|
||
> **为什么要这份**（用户 2026-09-30 点破）：
|
||
> 「现在的文档记录方式有问题，**没把重点放在前面**，都是记录历史，结果是**最新的结论在最后**」。
|
||
> 后果：**谁先读到旧文档，谁就把旧结论当现状**（当天连续三次犯此错）。
|
||
> ⇒ 本索引给出**唯一入口**：**哪份是"活文档"（会更新、可作判据）／哪份是"历史件"（⛔ 不作用现状）**。
|
||
|
||
---
|
||
|
||
## 一、规矩（三条，硬）
|
||
|
||
1. **⛔ 不从"历史件"取现状** —— 历史件只作**背景/沿革**，⛔ 不作判据（典型症状：拿它的旧结论当现在的状态）。
|
||
2. **判"现在是什么"** ⇒ 读「活文档」；活文档**头部必须有「当前结论 ＋ 最后更新」**，没有的一律先按历史件对待。
|
||
3. **一份文档退役 ⇒ 头部加退役块（指向权威件），⛔ 不删** —— 留痕，但⛔ 不冒充现状。
|
||
|
||
---
|
||
|
||
## 二、活文档（会更新 · 可作判据）
|
||
|
||
| 话题 | **权威件** | 说明 |
|
||
|---|---|---|
|
||
| **协作机制（架构）** | `~/.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 取最新那份）。
|
||
|
||
---
|
||
|
||
## 四、待办（需要用户拍板或后续做）
|
||
|
||
1. 🔴 `goals_open()` **不读验收判据 V1–V7** ⇒ 目标未达成时会**误判完成、心跳停**（当天咬过一次）。
|
||
建议：`goal.json` 增 `acceptance_state`（任一非 pass ⇒ 算未完成）。
|
||
2. ⚠️ `CODEBUDDY.md` ＋ `.workbuddy/memory/MEMORY.md` **尚未加「当前结论」头部**（前者是高影响面规则件，⛔ 未擅自改）。
|
||
3. ⚠️ 其余"结论型"文档（技能 references、docs/）**尚未逐份加头部** —— 建议**只改"会被反复读的活文档"**，
|
||
⛔ 不追求 471 份全覆盖（那会把问题变成维护灾难）。
|