admin
ce8e6ceed9
回收 411 MB（470 M → 58.8 M），全部经回收站，可恢复： - 待清理/（146.2 M，含 relay 分片 128 M 与 42 项过程目录） - tmp/（32.4 M，按接续棒命名的过程临时区） - .workbuddy/tmp/（39.5 M） - 4 份 workbuddy.db 冗余副本（101 M，09-23 事故的坏副本 / 抢救产物） - tmp/im16/gw/centrifugo 二进制（63.9 M，可重下）+ 缓存残留 入库范围：常驻规则（CODEBUDDY.md / README.md / state.py）、在途接续入口与 接续包、docs/、交付物/、交接单/、归档/、scripts/、.codebuddy/、 .workbuddy/memory/；共 398 件，其中 >60 KB 的 26 件全为文档。 排除（.gitignore）：tmp/、待清理/、运行态日志与缓存、*.db 与 DB 备份整目录、 打包二进制（*.tar.gz / *.tgz）、记忆修复前备份。
32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
---
|
||
alwaysApply: false
|
||
paths: ["dsh-server-docs/04-调整方案/**", "dsh-server-docs/05-交接单/**", "dsh-server-docs/INDEX.md"]
|
||
---
|
||
|
||
# 写改造档案 / 交接单：规范
|
||
|
||
## 档案（`04-调整方案/<NN>-<主题>.md`）
|
||
|
||
- **编号先原子占号**：`mkdir 04-调整方案/.lock-<NN>` 成功再写（"先 ls 再写"会撞号，已实证两次）。
|
||
**不要相信任何文档里写死的"下一号"** —— 一律现跑：`ls 04-调整方案/ | sort -n | tail -1`。
|
||
编号 63 是空号，**勿补占**。
|
||
- **模板 8 段**（交接单）/ **结构**（档案）：目标 → 改动 → 验证 → 红线遵守 → 回滚。
|
||
- **档案只增不改** —— 历史事实冻结；发现与现值不符时**改入口（BRIEF/INDEX），回改档案**。
|
||
- 需要改动既有档案时，在文末加「**修正（YYYY-MM-DD）**」小节，不删原文。
|
||
|
||
## 收尾三件套 + 一件
|
||
|
||
```bash
|
||
python3 scripts/docs-audit.py # 结构：编号冲突 / 悬空引用（退出码非 0 即需处理）
|
||
python3 scripts/docs-manifest.py # 刷新机读清单 docs-manifest.json
|
||
bash scripts/docs-sync-check.sh # 双端对账（退出码 0 = 全绿）
|
||
python3 scripts/docs-consistency.py # 事实：写死取值 + 跨页取值冲突（新增）
|
||
```
|
||
|
||
## 单子（交接单）
|
||
|
||
- 8 段必填：目标 / 只读前置 / 范围 / 决策点 / 步骤 / 验收 / 回滚 / 回报格式。
|
||
- **决策点**：已定的写"已定（谁定的/依据）"；未定的写"开跑前问用户"；
|
||
**技术项不写进决策点**（自己定，写进回执）。
|
||
- 基线数字**必须带取数时间 + 复核命令**，不写死绝对值。
|