zhuyongxin
fddefab0c9
- value-scan: read-only breadth inventory of mechanisms in delivered code, stopping at the human selection gate - value-dig: depth write-up of chosen points (feature list, design review, refactor plan) with templates and mechanical checkers - Add skill-workbench design doc for the pair
77 lines
3.3 KiB
Markdown
77 lines
3.3 KiB
Markdown
# ⟨域⟩ · 价值点报告（S3 产物）
|
||
|
||
> **用途**：为 S2 勾选出的每个点写**可讲述的轻理由**（默认交付深度）。
|
||
> **上游**：`⟨域⟩-候选价值点.md`（S1）· **勾选来源**：⟨候选清单「闸门状态」节 / 用户消息直接点名⟩
|
||
> **证据快照**：基于 ⟨仓库名⟩ `⟨commit 短号 / 分支⟩`，⟨读取日期⟩。**换版本要重核**。
|
||
> **判据**：**简历行测试**——填不出机制的退回「附录·待定」
|
||
> **路径简写**：`⟨简写⟩/` = `⟨真实路径⟩`（锚点一律用简写前缀）
|
||
|
||
---
|
||
|
||
## 每个点 = 7 类内容
|
||
|
||
> **7 类不是"行数上限"**。关键片段与偏差附录**另有归属，不占这 7 类**。
|
||
> **点编号沿用 S1 的 ★ 编号**（便于与候选清单对照）。
|
||
|
||
### ★⟨N⟩ · ⟨机制名⟩
|
||
|
||
| # | 行 | 内容 |
|
||
|:-:|---|---|
|
||
| 1 | **简历行** | 用【⟨机制⟩】解决了【⟨具体问题/场景⟩】，代价是【⟨取舍⟩】 |
|
||
| 2 | **Problem** | ⟨不做会怎样 / 原来的做法会出什么问题⟩ |
|
||
| 3 | **Pattern** | ⟨机制是什么、怎么起作用⟩ |
|
||
| 4 | **Alternatives** | ⟨当时还能怎么做 / 为什么没选⟩ |
|
||
| 5 | **Tradeoffs** | ⟨代价：新增复杂度 · 依赖 · 运维负担⟩ |
|
||
| 6 | **Evidence** | `⟨简写⟩/⟨路径⟩.java:⟨行号⟩` · ⟨可核对的图/表/配置⟩ |
|
||
| 7 | **追问预判** | **问**：⟨高概率追问 1⟩ **答**：⟨一句话⟩<br/>**问**：⟨高概率追问 2（可选，最多 2 条）⟩ **答**：⟨一句话⟩ |
|
||
|
||
**关键片段 · ⟨片段名⟩**（≤10 行伪代码，把"只有名词"的地方画实）
|
||
|
||
```
|
||
⟨CAS 语句 / 锁与短路顺序 / 状态分支 / DDL⟩
|
||
```
|
||
|
||
**事实强度**（可选，用于区分"已核实"与"推断"）
|
||
|
||
| 结论 | 强度 |
|
||
|---|---|
|
||
| ⟨…⟩ | **已核实**（读过代码） |
|
||
| ⟨…⟩ | **推断**（未核实，需人工确认） |
|
||
|
||
⟨重复上面 3 块，每点一节⟩
|
||
|
||
---
|
||
|
||
# 附录 · 与候选清单的偏差
|
||
|
||
> **实读代码后必须回头核对 S1 的表述**。S1 是"候选"不是"事实"——**偏差本身就是高价值材料**（往往是简历上最硬的一条）。
|
||
|
||
| # | S1 怎么写的 | 代码事实 | 处理 |
|
||
|:-:|---|---|---|
|
||
| 1 | ⟨S1 的原文⟩ | ⟨实读结果 + `路径:行号`⟩ | ⟨纠正 / 标【待确认】/ 升级为独立价值点⟩ |
|
||
|
||
---
|
||
|
||
# 报告尾 · 推荐组合
|
||
|
||
> **先讲哪 3 个**——给"追问密度最高 / 最能体现设计能力"的组合。**内容列必须是上面已写的 ★ 编号。**
|
||
|
||
| 组合 | 内容（★ 编号） | 适合 |
|
||
|---|---|---|
|
||
| **主线（推荐）** | ⟨★N + ★M⟩ | ⟨最能体现什么能力，追问密度最高⟩ |
|
||
| **完整版** | ⟨★1 + ★2 + ★3 + ★4 + ★5⟩ | ⟨讲清完整链路⟩ |
|
||
| **差异化** | ⟨★K⟩ | ⟨少数人会讲的点⟩ |
|
||
|
||
**建议讲述顺序**：⟨★N → ★M → ★K，并说明为什么这个顺序⟩
|
||
|
||
---
|
||
|
||
# 附录 · 待定
|
||
|
||
> 简历行**填不出机制**的点落在这里（**不删除**——防灌水，也不误杀）。
|
||
> ⚠️ **闸门二只在本阶段生效**：进入 S4 的点若机制仍未定，改为在其小节头部标 **【待确认：机制未定】**，**不在 S4 新建「待定」节**。
|
||
|
||
| # | 点 | 为什么填不出 | 需要补什么才能定 |
|
||
|:-:|---|---|---|
|
||
| 1 | | | |
|