31 lines
1.6 KiB
Markdown
31 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 段必填：目标 / 只读前置 / 范围 / 决策点 / 步骤 / 验收 / 回滚 / 回报格式。
|
|||
|
|
- **决策点**：已定的写"已定（谁定的/依据）"；未定的写"开跑前问用户"；
|
|||
|
|
**技术项不写进决策点**（自己定，写进回执）。
|
|||
|
|
- 基线数字**必须带取数时间 + 复核命令**，不写死绝对值。
|