system-design-reviewer 是做什么的?
来自 alphasafal/production-agent-skills 的智能体技能“system-design-reviewer”。
该技能使AI智能体能够阅读、分析并审查系统设计文档(例如Markdown格式),针对可扩展性、可用性、安全性、成本效率等关键工程维度生成有条理的审查意见。
功能
- 解析系统设计文档并提供结构化审查。
- 根据行业最佳实践(如可扩展性、延迟、一致性、容错性)评估设计权衡。
- 在审查中突出潜在瓶颈或单点故障。
- 提供可操作的改进建议。
- 生成包含评分或优先级排序的Markdown格式审查报告。
使用方法
- 向配置了此技能的智能体提供系统设计文档(.md文件或文本块)。
- 调用技能(例如通过Claude Code、Cursor或Codex中的工具调用)来触发审查。
- 获取结构化的反馈报告。
输入格式
该技能期望包含以下内容的系统设计文档:
- 架构概览(C4模型或图表)
- API规范或服务边界
- 数据模型与存储选择
- 基础设施与部署策略
审查维度
- 可扩展性:系统能否优雅地增长?
- 可靠性:是否存在单点故障?容错机制如何?
- 安全性:是否存在身份验证、授权或注入方面的担忧?
- 性能:延迟、吞吐量、缓存策略。
- 成本:基础设施与运营支出是否合理?
- 可维护性:代码库和架构的耦合度与变更灵活性。
输出示例
## 系统设计审查:电子商务平台
### 可扩展性
- ✅ 采用微服务架构,支持独立扩展。
- ⚠️ 数据库读写分离可能导致复制延迟。
### 安全性
- ❌ 未启用速率限制的面向公众的API端点。
### 建议
1. 为高流量端点点引入带Redis的速率限制。
2. 考虑对订单服务使用读写分离,以减少主数据库负载。