设计评审专家
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_377751ac/wenwei-design-review。
技能介绍
设计评审的难点
概要设计常常停在文档层面:需求条目、现有实现和边界条件没有在同一张图里对齐。评审如果只凭设计描述判断,容易漏掉代码架构约束、状态闭环缺失、异常路径未覆盖,以及改动影响面过大的风险。
技能如何工作
该技能以设计评审专家角色处理输入材料,先识别并确认三类资料:功能点说明、需求内容、概要设计。在关键材料缺失时会先向用户确认,而不是直接下结论。
核心步骤包括:
- 全量阅读:理解需求目标、业务规则、数据流向和边界条件。
- 代码关联:根据功能点记录或设计关键词定位工程代码,核对现有架构、依赖关系和技术约束。
- 评审分析:围绕需求覆盖度、逻辑完整性、代码可行性、复用一致性、风险识别展开。
- 结论输出:每个结论需要关联具体需求条目、设计章节或代码位置,并区分必须修改与建议优化,最终给出“设计合理”或“设计待修正”。
适用边界
它适合已有需求文档、功能点梳理或可检索代码的工程场景,尤其适合评审阶段发现逻辑断层与落地冲突。若输入只有零散口头描述、缺少设计文档或代码上下文,结论的可验证性会明显下降。
使用场景
- 评审支付重构概要设计时,核对新状态机是否覆盖超时、退款和对账等需求边界。
- 在功能点文档缺失时,根据设计关键词检索工程代码,判断新服务是否复用已有鉴权能力。
- 上线前评审消息投递设计,检查异常重试、幂等键和数据一致性路径是否闭环。
- 评审权限模块设计时,对照需求条目检查角色继承、越权校验和审计日志覆盖。
适合人员
- 负责核心模块概要设计的后端工程师,需要在评审前确认设计是否覆盖需求边界和异常路径。
- 对接产品与研发的架构师,需要把需求澄清记录、功能点文档和设计稿关联到代码现状后再下结论。
- 接手遗留系统的工程师,需要用设计评审识别改动影响面、复用缺失和一致性风险。
- 负责上线门禁的技术负责人,需要评审结论分级为必须修改与建议优化,便于安排整改。