eng-architect

概述

设计架构和可验证的工单，或审查现有 UI。保留请求的范围和现有项目决策。

命令路由

根据请求的结果推断模式：

• 架构、模块边界、技术计划或工单：在逐项分析功能之前，完整阅读工程工作流，包括其中的示例。
• UI 评审、设计审查或 AI slop 扫描：在开始审查之前，完整阅读设计审查工作流，包括其中的示例。
• 如果同时请求两者，则针对各自的输出使用两种工作流。只有在预期结果仍存在重大歧义时，才询问用户要采用哪种模式。

在工作流中需要时，阅读其他参考资料。

共享决策规则

使用项目证据和用户先前的决策。在汇总架构之前，分析每项功能的流程、失败路径、边界和测试方法。

收集需要用户权衡的未决事项，并将相关选项与建议及后果一并呈现。未经授权，不得更改已商定的范围、架构、工作流或其他重要决策；如需更改，应先询问。等待答复期间，继续进行彼此独立的分析。沿用已确定的决策，不要重复询问。

审查或讨论请求应提供相应分析。经授权的实现或工单编写请求允许在已商定的范围内开展常规工作。

项目记录

使用现有文档和任务系统来满足以下用途。如果没有现成安排，且需要完整的开发交接，则创建 ENG.md、delivery-status.md、工单文件、AGENTS.md 和 CLAUDE.md 指针。对于有明确边界的架构决策或 UI 审查，选择满足请求结果所需的记录。

文件或位置	用途	创建或更新时机	阅读时机
ENG.md	各工单共用的架构、测试策略、假设和迁移顺序	需要保留共用技术决策时	更改相关架构、测试策略或迁移之前
delivery-status.md	当前进度、阻塞项、下一个可验证产出和下一张工单	需要持续跟踪或交接时；相关状态变化时更新	接手工作时
docs/tickets/ 或现有工单系统	每张工单的交付内容、验收标准和阻塞依赖项	收到拆分工作或准备开发交接的请求时	开始实现之前，阅读分配的工单及其依赖项
AGENTS.md	项目工作规则，以及支持性记录的位置和阅读时机	建立协作机制或更改工作规则时	开始项目工作之前
CLAUDE.md	引导 Agent 阅读 AGENTS.md 的入口	建立默认协作配置时；实际规则应保留在 AGENTS.md 中	作为项目规则的入口
DESIGN.md	UI 审查的视觉基准	此技能会读取，但不会创建或覆盖	根据设计基准审查 UI 之前
DESIGN-REVIEW.md	UI 评分、未决发现和组件审查结果	需要保留审查记录，且现有安排无法满足时；后续审查时更新	重新审查 UI 之前

更新现有内容前先阅读，并保留无关章节，同时登记实际产物路径及其必须阅读的时机。在架构记录中保留共用技术决策，并将每张工单的验收标准写在对应工单中。

完成检查

• 结果满足所请求的架构分析、工单处理或 UI 审查需求。
• 工程分析涵盖功能流程、故障、交互边界、测试和适用的迁移风险；工单处理为每项已分析的验收事项指定负责人，并记录实际阻塞项。
• UI 审查结论基于实际渲染的屏幕和相关交互；已授权的修复会在渲染结果中重新检查。报告缺失的视觉证据。
• 明确说明尚未解决的假设和决策。遵循项目要求的验证和交付规则。
• 更新记录保留无关内容，链接到实际来源，并在交接时指出下一项可验证的行动。