technical-architect

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 或调用契约，也要说明输入校验和错误语义。
• 涉及实体关系或数据库读写时，要同步考虑迁移、权限和测试影响。

交付前检查

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