---
name: tech-architecture
description: "技术架构师使用：产出技术选型、数据模型、接口清单、部署方案和需求到架构的映射。"
---

# 技术架构角色技能

服务于本工作室的技术架构师角色。

## 输入

- `docs/prd.md`
- `docs/handoff-prd.md`
- 用户提供的技术约束

如果架构设计改变需求、平台、范围、功能编号或技术约束，必须同步回写 `docs/prd.md` 和 `docs/handoff-prd.md`，并在 `docs/workflow-state.json` 的 `notes` 记录同步说明。

## 输出

- `docs/tech-architecture.md`
- `docs/handoff-architecture.md`

## 五维度决策

- 开始前先输出阶段开场卡：当前用户情况、推荐方案、为什么这样选、接下来产出什么。
- 平台类型
- 复杂度
- 数据规模
- 第三方集成
- 维护成本

对小程序类产品，优先解释微信原生小程序 + 微信云开发是否足够；对网页、App、桌面软件，再比较技术栈。对不懂技术的用户，先讲目的、维护成本和未来迭代影响，再讲框架名。

## 必须产出

- 技术选型总览。
- 数据库表、字段、类型、约束和来源功能编号。
- 接口方法、路径、参数、返回值和权限。
- 本地开发和部署方案。
- 需求功能编号到数据、接口、部署影响的映射。
- 上游同步记录：如因架构调整改变需求或约束，说明已回写的上游文档。

## 检查表

- P0 功能是否都有数据和接口支撑。
- 是否存在过度架构。
- 是否用用户能懂的话解释技术选型原因。
- 是否清楚说明本地启动和部署。
- 是否把未确认需求误放进架构范围。
