接缝与集成边界
模式指导 — 标记将接缝/契约关注点与集成/调用点关注点混在一起的 L3+ 待办一句话描述;由 /dr-prd 和 /dr-plan 加载。
概述
一条待办一句话描述不得将两个独立的模块关注点捆绑在同一个任务 ID 下。一旦如此,该任务实际上是一个基础任务加一个集成后续任务共用一个 ID,而集成部分往往会在后期——在 /dr-qa 阶段——才作为超出范围的缺口浮现,并被作为结转备注推迟。
模式
有两类关注点会反复共同出现在本应拆分的单行描述中:
- 接缝 / 契约关注点——在一个模块内部定义抽象:接口、契约、协议、状态机或调度器。其验收标准是该模块内部的形状或编译断言。
- 集成 / 调用点关注点——将该接缝接入调用方:命令行标志、调用点、端到端路径、向下游模块的传播。其验收标准是跨模块边界的行为断言。
当单条 L3+ 单行描述同时包含这两类关注点时,在组件分解之前向操作者标记,以便选择拆分为一个基础任务(接缝)加一个集成后续任务(调用点),或者限定验收标准范围,使集成被明确设为可选或推迟——接缝任务的验收仅覆盖模块内契约,并由一个具名的后续任务负责接线。
为何拆分
这两类关注点具有不同的证据链和不同的完成定义。接缝在构建成功且其模块内测试通过时即完成;集成在另一个模块中的调用方可观察地使用它时才完成。将它们折叠进一条单行描述会隐藏边界:计划为接缝估算规模,TDD 使接缝变绿,/dr-qa 在接缝上通过——直到此时,未接线的集成才作为超出范围的缺口浮现。在计划阶段界定边界,可将拆分吸收进计划,而不是在 /dr-qa 内部才发现它。
如何应用
- 对于每个 L3+ 任务,阅读待办单行描述并对其关注点进行分类。接缝关注点命名一个要定义的模块内抽象;集成关注点命名一个要接入的调用方。
- 如果两类关注点同时存在,不要直接进入组件分解。向操作者标记上述二选一,并将决定记录在计划的概述 / 决策部分。
- 作为机械辅助手段,对单行描述运行建议性扫描器
check-seam-integration-boundary.sh。它会标记接缝类与集成类信号的共现,且仅为建议性——绝不是硬性阻断。其两个信号列表是下限而非上限:它可能漏掉用列表之外措辞表述的混合,也可能对恰好各含一个列表中的一个词的真正单一关注点单行描述产生误报。规划者做最终判断;扫描器只暴露候选。 - 当任务被拆分时,后续集成任务获得自己的待办条目和自己的验收标准。当改为限定验收标准范围时,接缝任务的验收必须命名被推迟的集成并指向后续任务,使边界可证伪而非隐含。
与 V-AC 轴拆分的关系
v-ac-axis-split 拆分一个混合了确定性轴与统计轴的单一 V-AC 组——按证据类型拆分一个验收标准。本技能拆分一个混合了接缝关注点与集成关注点的单一任务单行描述——按模块边界拆分一个任务。两者都是计划阶段的「在定稿前拆分」规则;它们独立适用,且可在同一任务上同时触发。