Helm Chart 文档生成器

它解决什么问题

Helm chart 的 README 往往是手工维护的：你在 values.yaml 里改了参数名、删了字段、调了默认值，参数表格却还停留在上一次写文档时的样子。等到发版，文档写着 A、实际部署值是 B，排查成本最终由使用者承担。这类文档漂移很难在 review 里被发现，因为 diff 看起来只是「改了几行说明」。

技能如何工作

它在提交或发布前调用 helm-docs，把 Chart.yaml、values.yaml 和行内注释重新渲染成 README：

• 从 values 和注释重建参数表格，不再手工抄录每个键，避免遗漏或漏改；
• 输出可 review 的 diff：表格变更、缺失的描述、文档与 chart 实际状态不一致的地方，都能在一次评审中看清；
• 生成结果与实际 chart 对齐，把文档更新变成发布前的一道检查关卡，而不是发完再补的收尾动作。

适用边界与注意点

• 前提是本机已有 helm-docs CLI，技能本身不负责安装；
• 用 docker 方式运行时要留意挂载路径与用户 uid 是否匹配，否则产物的属主会出问题；
• 上游对注释有要求：字段本身和它下面的叶节点都需要补描述注释，只写一层会导致部分描述缺失；
• 它解决的是「文档与 values 不一致」，不会去校验 chart 的模板逻辑或 values 的语义正确性。