- 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
3.3 KiB
3.3 KiB
⟨域⟩ · 价值点报告(S3 产物)
用途:为 S2 勾选出的每个点写可讲述的轻理由(默认交付深度)。 上游:
⟨域⟩-候选价值点.md(S1)· 勾选来源:⟨候选清单「闸门状态」节 / 用户消息直接点名⟩ 证据快照:基于 ⟨仓库名⟩⟨commit 短号 / 分支⟩,⟨读取日期⟩。换版本要重核。 判据:简历行测试——填不出机制的退回「附录·待定」 路径简写:⟨简写⟩/=⟨真实路径⟩(锚点一律用简写前缀)
每个点 = 7 类内容
7 类不是"行数上限"。关键片段与偏差附录另有归属,不占这 7 类。 点编号沿用 S1 的 ★ 编号(便于与候选清单对照)。
★⟨N⟩ · ⟨机制名⟩
| # | 行 | 内容 |
|---|---|---|
| 1 | 简历行 | 用【⟨机制⟩】解决了【⟨具体问题/场景⟩】,代价是【⟨取舍⟩】 |
| 2 | Problem | ⟨不做会怎样 / 原来的做法会出什么问题⟩ |
| 3 | Pattern | ⟨机制是什么、怎么起作用⟩ |
| 4 | Alternatives | ⟨当时还能怎么做 / 为什么没选⟩ |
| 5 | Tradeoffs | ⟨代价:新增复杂度 · 依赖 · 运维负担⟩ |
| 6 | Evidence | ⟨简写⟩/⟨路径⟩.java:⟨行号⟩ · ⟨可核对的图/表/配置⟩ |
| 7 | 追问预判 | 问:⟨高概率追问 1⟩ 答:⟨一句话⟩ 问:⟨高概率追问 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 |