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 或调用契约,也要说明输入校验和错误语义。
- 涉及实体关系或数据库读写时,要同步考虑迁移、权限和测试影响。
交付前检查
- 方案包含文件映射、职责拆分和执行顺序。
- 已说明关键风险和约束。
- 已指出复用点和避免重复实现的依据。
- 方案足以交给实现技能继续执行。