该技能用于分层系统中的仓库级归属与放置决策,强调长期规范归属,而非只看当前缺陷所在的层。
使用前需先做发现:阅读仓库中定义架构、边界或职责的文档;阅读定义运行时流程、请求流或包边界的 ADR 或设计文档;检查顶层项目结构,把通用层映射到仓库实际的模块或包名。文档不完整时,可从代码库推断当前分层模型,明确说明假设,并保持建议指向单一规范所有者。
回答归属或放置问题时,需分别给出:运行时所有者、首次修复所有者、长期规范所有者、错误竞争所有者、清理方向,不可合并为单一答案。
决策顺序:识别运行时关注点(可见 UI 状态、平台外壳或系统桥接、运行时组合或请求分发、规范领域或应用工作流、纯共享逻辑、具体适配器或集成行为);指出错误行为当前所在层;判断该层仅是首次修复所有者还是也是长期规范所有者;若行为是可复用的产品策略或业务策略,应将长期所有者移出运行时编排层;规范所有者明确后,移除重复策略、回退逻辑或双路径。
层映射:UI 层负责可见 UI 状态、导航、渲染、展示派生状态与视图组合;平台外壳负责原生外壳、系统桥接、本地设备集成、文件系统或权限桥接、进程或会话管道、平台本地持久化辅助;运行时编排层负责运行时组合、请求分发、后台协调、worker 管理、事件发布与进程级编排,常是首次修复所有者,但不自动成为长期规范所有者;领域或应用层负责规范产品工作流、业务规则、可复用应用服务与跨界面行为;共享核心层负责共享类型、枚举、校验、规范化、能力逻辑及跨运行时纯逻辑;适配器或集成层负责具体协议、供应商、传输或 API 集成行为,不负责跨供应商产品策略。
硬性规则:不因错误当前发生就把可复用领域策略留在运行时编排层;不把 UI 状态、布局状态、恢复状态或面向用户展示的归属放入运行时编排层;不把平台外壳或原生集成关注点放入领域或应用层;不把跨供应商产品策略放入适配器或集成层;可在共享核心或窄领域模块实现的纯校验、规范化或能力逻辑,不放入编排代码。
常见判断:谁应为所有未来界面决定此问题,通常答案是领域或应用层、窄领域包或共享核心,而非运行时编排层;先在哪里修 bug 让产品停止错误行为,答案可能仍是运行时编排层;谁拥有线格式或负载类型,通常是共享 API 或核心类型层;谁拥有供应商特定行为,是相关适配器或集成层,但仅限适配器行为,不含规范产品策略。
示例模式:规划策略缺陷当前位于运行时 runner 模块时,运行时所有者与首次修复所有者均为运行时编排层,长期规范所有者为领域或应用层,类型或能力所有者为共享核心层,错误的竞争所有者包括 UI 层、平台外壳、适配器或集成层。更多分类矩阵与示例拆分见 references/ownership-matrix.md。