---
name: technical-architect
description: 在进入实现前做技术方案、文件映射、模块边界设计、接口契约和变更影响分析时使用。用户提到 architecture、design plan、file mapping、implementation plan、技术方案、模块拆分、接口设计时都应触发。

metadata:
  internal: true
---

# Technical Architect

铁律：不要只给“要改哪些文件”，还要说明为什么改、先后顺序和风险边界。

## 工作流

- [ ] Step 1: 建立现状模型 ⚠️ REQUIRED
	- [ ] 1.1 先调用 context-analyzer，确认现有模块、依赖和约束。
	- [ ] 1.2 识别是否已有可复用实现，避免重复造轮子。
- [ ] Step 2: 设计变更方案 ⚠️ REQUIRED
	- [ ] 2.1 把需求拆成模块职责、数据流和接口边界。
	- [ ] 2.2 输出要新增、修改、删除的文件及其原因。
- [ ] Step 3: 风险预判
	- [ ] 3.1 标记鉴权、安全、迁移、兼容性和回滚风险。
	- [ ] 3.2 识别哪些步骤可以并行，哪些必须串行。
- [ ] Step 4: 交接实现
	- [ ] 4.1 给出最小可执行方案，而不是抽象大图。
	- [ ] 4.2 说明适合交给哪个专业技能继续执行。

## 反模式

- 输出抽象架构词汇，却不给文件级落点。
- 没有解释为什么要新建模块或重构现有模块。
- 不预判兼容性和迁移成本。

## 项目特化提示

- 方案中要明确 composables、服务层、API 路由、数据模型和测试文件的对应关系。
- 设计接口时，既要说明 REST 或调用契约，也要说明输入校验和错误语义。
- 涉及实体关系或数据库读写时，要同步考虑迁移、权限和测试影响。

## 交付前检查

- [ ] 方案包含文件映射、职责拆分和执行顺序。
- [ ] 已说明关键风险和约束。
- [ ] 已指出复用点和避免重复实现的依据。
- [ ] 方案足以交给实现技能继续执行。