# Soia Dev Govern Architecture

> 设计架构、审查给定方案或核对长期漂移，明确职责、契约、事实真源与迁移边界。触发：架构方案怎么选、审查架构边界、检查架构漂移

- Skill: `soia-team/soia-dev-govern-architecture` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add soia-team/soia-dev-govern-architecture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/soia-team/soia-dev-govern-architecture/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: soia-team (https://skillmd.com/u/soia-team)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/soia-team/soia-dev-govern-architecture

---


# 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，完整步骤见[官方安装说明](https://github.com/soia-team/soia-open-skills#安装)。
WorkBuddy 使用[专家安装说明](https://github.com/soia-team/soia-open-skills/blob/main/docs/install/workbuddy.md)，不由 npx 代装。上述命令不构成安装或发布授权。

**私密信息与中间数据：** 只使用授权材料并对引用脱敏；不需要凭据、不默认建立配置/state/cache。要求保存的交付物写批准位置，临时数据用 OS 临时目录；不将客户原文写进技能仓库。

**日志与完成回执：** 结果本身是主要交付；说明实际变更或未改动、关键依据与未验证部分，不强制额外报告。