Files
vscode-workbench/PLANNING/08-运行手册.md
T

127 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 08 · 运行手册(稳态运营)
> 本手册回答:体系建好后,**每天/每周怎么跑**。配合 `tasks.py` 使用,全流程命令化。
> 与 `07-作战计划-窗口期.md` 的关系:07 是"新模型没到"的临时清单;本文是**长期稳态节奏**。
---
## 一、日常节奏(每天 20 分钟)
### 早间(10 分钟):派单
```bash
cd vscode/PLANNING
python tasks.py status # ① 看全局:谁在跑、谁完成、谁阻塞
python tasks.py collect # ② 扫 PROGRESS:模型昨天交了没有
python tasks.py dispatch <ID> --model <模型> # ③ 产出派单提示词,复制发给模型
python tasks.py start <ID> # ④ 标记执行中
```
**派单纪律**(与风险表 R18 联动):
- 同时最多 **3 张** 在跑(不同项目优先,避免同文件冲突)
- 关键路径(M1/M2)派 A 级以上;免费池只做辅助
- 派之前用 `02-任务总表.md` 看依赖:`depends_on` 有前置的,前置没 done 不派
### 晚间(10 分钟):收单与验收
```bash
python tasks.py collect # ① 扫今天的交付
# ② 打开 PROGRESS,对照任务卡「验收标准」逐条核对
python tasks.py accept <ID> # ③ 通过 → 标记完成
python tasks.py block <ID> "原因" # ④ 有问题 → 打回并标阻塞
```
**验收四查**(来自 03-协议 §六):
1. 验收命令原始输出齐全、结论全绿?
2. 改动文件越界没有?
3. 基线对比(开工前 vs 完工后)?
4. PROGRESS 格式完整?
**打回方式**:用 `05-派单提示词库.md` 模板 4,把"哪条标准、缺什么证据"写清楚,让同一模型只修问题、不重做。
---
## 二、每周节奏(每周一次,30 分钟)
```bash
python tasks.py status # 看里程碑进度
```
1. **复盘**:用下面的模板写周报(存 `PLANNING/review/weekly-YYYY-MM-DD.md`)。
2. **风险复查**:扫 `06-风险登记表.md` 的"待做应对"列——有没有该提前的?(如 I-02 备份越早越好)
3. **卡片维护**:
- `block` 超过 3 天的卡 → 规划者重审(拆分/降级/换方案)
- 新发现的问题 → 先建卡再派,不许口头派活
4. **模型档案**:本周如有新交付模型,把表现回填 `model-registry.json`。
### 周报模板
```markdown
# 周报 YYYY-WW
## 本周完成(done)
- [ID] 标题 — 模型 — 一句话结果
## 本周执行中(doing)
- [ID] 标题 — 模型 — 进度% — 预计完成
## 本周阻塞(blocked)
- [ID] 标题 — 原因 — 处理方案
## 里程碑对照
- M1: x/5 — 剩 [IDs]
- M2: x/6 — 剩 [IDs]
## 经验与教训(进协议或风险表)
- ...
## 下周计划(先派哪 3 张)
1. ...
```
---
## 三、异常处理(照做)
| 情况 | 动作 |
|---|---|
| 模型交付打回一次 | 模板 4 原模型重试(只修问题) |
| 同一卡打回两次 | 换模型(升一级),并让原模型交 partial + 断点(模板 3) |
| 同一卡三连败 | **停派**——规划者重审任务卡本身(拆分/降级/换方案) |
| 模型伪造证据 | 打回 + `model-registry.json` 降级 + 该卡换模型 + 用模板 7 全量复核 |
| 项目测试基线被破坏 | 立即停该项目所有派单 → 修基线 → 复原后再派 |
| 发现新问题 | 建卡(走规划者审定)→ 进总表 → 再派 |
---
## 四、状态与文件地图(谁在哪里)
| 文件 | 谁维护 | 说明 |
|---|---|---|
| `task-manifest.json` | 规划者 | 任务定义(执行模型只读) |
| `state.json` | `tasks.py` 自动 | 状态覆盖层(accept/start/block 写入) |
| `tasks/<ID>-*.md` | 规划者 | 任务卡(执行模型只读) |
| `<项目根>/PROGRESS_<ID>.md` | **执行模型** | 交付凭证(验收依据) |
| `model-registry.json` | 规划者/验收者 | 模型能力档案 |
| `review/weekly-*.md` | 操作员/规划者 | 周报归档 |
---
## 五、指标跟踪(每月底对一次)
| 指标 | 口径 | 目标 |
|---|---|---|
| 交付通过率 | done / (done + 打回次数) | ≥80% |
| 平均验收轮次 | 每张卡平均几轮过 | ≤1.5 |
| 里程碑准点率 | 按目标日期完成比例 | ≥80% |
| WIP 控制 | 同时在跑卡数 | ≤3 |
| 伪造事故 | 次数 | 0 |
数据来源:`state.json` + PROGRESS 文件历史。每月底写进月度复盘(`review/monthly-*.md`)。
---
## 六、一句话总纲
**早上派单、晚上收单、每周复盘、异常照表、状态全走 tasks.py。**