# Studio Setup Stack

> 【Studio】技术选型与骨架 — 选定技术栈、生成脚手架与依赖文件 → 项目骨架。当用户说「搭架子/初始化项目」时使用。

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

---


# 技能：技术栈初始化 (/studio-setup-stack)

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

---

## 概述 (Summary)

此技能用于在 PRD 明确后，由架构师引导用户进行技术选型，并自动生成项目的初始目录结构、依赖文件和核心配置。

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

1.  **提问 (Question)**:
    - 目标平台是什么？(Web, Mobile, CLI, API-only)
    - 有无特定的编程语言偏好？(Python, Go, Node.js, Rust 等)
    - 预计的数据存储需求？(Relational, NoSQL, In-memory)
2.  **方案 (Options)**:
    - 架构师必须提供 **2-3 个技术栈方案**（例如：FastAPI/PostgreSQL vs. NestJS/MongoDB）。
    - 针对每个方案对比：开发速度、性能指标、可维护性。
    - 你必须使用 `ask_user` 工具让用户从中点击选择一个方案。
3.  **决策 (Decision)**: 用户选择其中一个方案。
4.  **草案 (Draft)**:
    - 展示生成的目录结构预览。
    - 展示 `package.json` / `requirements.txt` / `Dockerfile` 的草案。
5.  **批准 (Approval)**:
    - 获得用户“批准”后，架构师执行 `write_file` 创建项目骨架。

---

## 成功门控 (Success Gate)

- 更新了 `docs/arch/TECHNICAL-PREFERENCES.md`。
- 创建了基础的项目结构 (如 `src/`, `tests/`, `config/`)。
- 生成了可用的依赖清单文件。

---

## 输出约束 (Output Budget)

**[强制]** 创建骨架文件后，返回主上下文只输出：

```
技术栈初始化完成。

- 选定方案：[方案名]（[主要技术，3-4 个关键词]）
- 生成文件：[X] 个（`src/`、`tests/`、依赖清单）
- `docs/arch/TECHNICAL-PREFERENCES.md` 已更新

下一步：`/studio-sprint-kickoff`
```

不得在摘要中展开目录结构或依赖列表正文。

## 协作路径

- 完成后，交棒 `delivery-manager` 执行 `/studio-sprint-kickoff`。