Files
git-learn/skill-workbench/generated-skills/skills/value-dig/assets/价值点报告模板.md
T
zhuyongxin fddefab0c9 Add value-scan and value-dig skills for reverse-engineering value points
- 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
2026-09-18 18:23:23 +08:00

3.3 KiB
Raw Blame History

⟨域⟩ · 价值点报告(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