# Studio Arch Design

> 【Studio】架构设计 — API 契约、数据模型、ADR → docs/arch/ADR-*.md。当用户说「设计架构/定义 API」时使用。

- Skill: `wxxzy/studio-arch-design` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wxxzy/studio-arch-design`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wxxzy/studio-arch-design/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: wxxzy (https://skillmd.com/u/wxxzy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wxxzy/studio-arch-design

---


# 技能：架构设计与选型 (/studio-arch-design)

**执行代理**: `technical-architect` (技术架构师)

---

## 概述 (Summary)

此技能用于在 PRD 批准后，由架构师引导用户进行深度的架构设计、API 定义或数据库建模。

## 协作工作流 (The 5-Step Protocol)

1.  **需求分析**: 架构师阅读 PRD，识别核心技术挑战。
2.  **提问 (Question)**: 针对性能、并发或安全性，确认用户的特定约束。
3.  **方案 (Options)**: 
    - 架构师提供 **2-3 个对比方案**。
    - **[强制]**：必须使用 `ask_user` 工具提供这些方案的选择按钮。
4.  **决策 (Decision)**: 用户通过交互式组件做出选择。
5.  **详细设计 (Draft)**:
    - 架构师根据选择编写 ADR (Architecture Decision Record) 草案。
    - **[强制]**：必须使用 `ask_user` 工具提供 [批准设计]、[需要微调]、[放弃方案] 选项。
6.  **执行与归档**: 获得点击批准后，将 ADR 写入 `docs/arch/`。

---

## 成功门控 (Success Gate)

- 生成了 `docs/arch/ADR-xxx.md`。
- 包含了核心 API 契约或数据库结构描述。
- 用户通过 `ask_user` 明确表示了批准。

## 输出约束 (Output Budget)

**[强制]** 获得批准并写入文件后，返回主上下文只输出：

```
架构决策已记录。

- `docs/arch/ADR-[xxx].md` — [决策标题，一句话]
- 核心方案：[选定方案名称]
- 关键权衡：[一句话]

如需查看完整设计，打开上述文件。
```

不得在返回摘要中重复 ADR 正文内容。