soia-team soia-dev-govern-architecture
客户可读说明
能做什么： 解决会影响多个组件的架构判断。交付可实施的选择、针对给定方案的问题，或实际漂移清单；不是画图工具，也不替代普通代码实现。
如何使用： 提供目标问题、架构/代码范围和已批准约束。先判断本次是设计、评审还是漂移核对，只做所需模式；局部修复不重开架构。
核心方法
先确认谁拥有状态、谁可以写、谁消费结果，以及哪个来源能证明现状。代码证明“现在怎样”；用户裁决、契约和 ADR 决定“应当怎样”，两者冲突是偏差，不能用现状推翻规范。
- 设计方案： 从最难改回的假设出发，比较真实可行的选择；说明职责、依赖方向、接口与数据流、失败/恢复语义。优先复用现有边界，只有能降低整体复杂度时才增加组件。给出取舍与可证伪的验证，不为凑方案编造替代项。
- 评审给定方案： 固定目标和版本，沿关键调用、状态写入及失败路径检查。规格符合性与工程代价分开；只报有证据的冲突，不擅自把任务变成重新设计或修改代码。
- 核对长期漂移： 对照有效裁决与当前实现，定位重复真源、越权写入、逆向依赖、过期适配和名义退役但仍在使用的入口。给出来源、实际消费者和影响；未读到或无法运行的部分标为未验证。
跨边界变更要说清迁移次序、共存窗口、切换条件、回退与退役证据。涉及状态恢复时检查重试/重复、部分成功、失效 owner、取消与审计，按真实风险选择，不每次全套检查。
完成边界
判断应落到具体边界、证据和下一步验证。仅在依赖或时序不易理解时画最小图。复用项目已有 ADR/契约；不默认新建治理目录、状态库、hook、tracker 或固定报告。
默认只读并在对话交付。用户要求形成设计文档时写批准位置；设计建议不是实施、发布或迁移授权。
使用边界
依赖与安装
无强制第三方技能依赖；读取或编辑所选材料的能力由宿主提供。
默认项目单技能：npx skills add soia-team/soia-open-dev-skills -a <agent> -s soia-dev-govern-architecture，执行前核实当前参数。
整域需明确选择：Claude Code 使用 claude plugin marketplace add / claude plugin install soia-dev@soia，Codex 使用 codex plugin marketplace add / codex plugin add soia-dev@soia；市场为 soia-team/soia-open-skills，完整步骤见官方安装说明。
WorkBuddy 使用专家安装说明，不由 npx 代装。上述命令不构成安装或发布授权。
私密信息与中间数据： 只使用授权材料并对引用脱敏；不需要凭据、不默认建立配置/state/cache。要求保存的交付物写批准位置，临时数据用 OS 临时目录；不将客户原文写进技能仓库。
日志与完成回执： 结果本身是主要交付；说明实际变更或未改动、关键依据与未验证部分，不强制额外报告。