health-controller-stub-detector 技能——在桩代码阻碍合规之前将其捕获
Datarim 如何在实现阶段揭示健康与状态控制器中硬编码的桩字面量——在它们误导验收测试并阻碍合规门禁之前。
一个返回 HTTP 200 且状态字段为 pending-integration 的健康端点可以通过自动化冒烟测试。测试看到 200,字段存在,没有任何断言失败。但该字段是占位符,而非实时探针——下游服务尚未接入,端点正在谎报系统状态。health-controller-stub-detector 技能在实现阶段捕获此类缺陷,使其在到达质量保证之前就被拦截。
当任务涉及任何匹配 *health*controller*、*health*service*、*liveness*、*readiness* 或 *status*indicator* 等模式的文件,以及任何技术栈中按角色命名的等效文件时,该技能由 /dr-do 第 7 步调用。
检测器
该检查对 diff 的新增行——而非整个文件——运行 grep,查找六种字面量模式:pending-integration、not-implemented、not_implemented、unimplemented、"stub",以及操作员扩展该集合所加入的任何团队特定占位符约定。未改动行中已存在的桩字面量仅生成非阻塞性提示;阻塞门禁仅适用于当前 diff 中的新增内容。
每个匹配项的三种处置方式
当检测器在新增行中发现桩字面量时,操作员必须在任务推进之前选择三种明确处置方式之一。第一种是立即实现实时探针:用真实的下游健康检查替换该字面量并移除占位符。第二种是显式延期:将占位符移至控制器中明确标注的延期部分,添加内联注释指明跟踪工单,并以标准化命名模式创建待办事项。第三种是将该项记录为本任务范围之外,并引用后续任务 ID。
留下桩字面量而不记录上述三种处置方式中的任何一种,是不可接受的结果。那正是该技能旨在弥合的静默契约缺口之路。
催生该技能的事件
一个多模态请求流在下游服务中端到端落地。上游健康控制器中针对该服务的指示器仍为硬编码的 pending-integration 字面量——一个不属于当前任务的延期健康报告器集成。一个探测 /health 端点的验收标准将该字面量视为接入的证明。检查通过了。契约缺口直到流水线后期的合规门禁才暴露,并阻塞了裁决周期,直到操作员协调了措辞。
在 /dr-do 而非 /dr-compliance 处捕获该模式,可消除协调所需的额外流水线周期。
与期望的关联
该技能交叉引用 expectations-checklist 契约:愿望项不应引用 /health 字面量作为服务接入的证明。返回桩状态的健康端点是延期的证据,而非集成的证据。当愿望被写成将该端点视为权威时,桩检测器和期望验证器将产生相互矛盾的裁决——桩说“未接入”,愿望说“检查端点”。修复方法是使愿望标准与实际实现状态保持一致。
在什么是 Datarim中了解更多关于 Datarim 流水线的信息,或查看expectations-checklist 技能如何在质量保证阶段界定什么算作已验证证据。