SuperAPI AI 工具集

well-architected

智能体与模型

查看项目

更新于 10-15 17:22

技能介绍

用途:这是一套架构评审框架,改编自 AWS Well-Architected(透镜为小团队 SaaS / LLM 应用),精简到 10 人以下工程规模相关的问题。非 nano 工作的每份 ARCH 文档都要回答六个支柱的问题;跳过某一支柱必须明确说明理由(例如“可持续性:不适用——纯后端,运行在共享基础设施”)。

六大支柱及通过标准:运营卓越——每项业务成果一个指标、每请求一行可关联 request-id 的日志、部署路径有文档且回滚演练过、runbook 覆盖预演中的前三大故障模式。安全——外部输入在边界显式校验、授权在数据层而非仅 UI 执行、密钥放环境变量或密钥管理器、敏感数据分类并定义保留策略;注意 JWT 是身份认证,授权需单独实现。可靠性——外部调用设熔断/超时、状态变更端点接受幂等键、备份有文档且 90 天内测试过恢复、有负载测试并记录在 docs/perf/。性能效率——ARCH 文档写明确 SLO 数值(p50/p95/p99、错误率、可用性)、关键路径有性能剖析、缓存与失效策略明确、扩展决策有数据支撑。成本优化——用 cost-model 技能记录明确金额、选择满足质量 SLO 的最小 LLM 模型(先试 haiku 再 sonnet 再 opus)、日志/指标/旧数据有保留策略。可持续性——热循环复杂度有文档、非生产资源有停机计划、数据生命周期覆盖采集、保留、删除。

输出格式:在 ARCH 中追加“Well-Architected review”小节,按六个支柱分别列出指标、部署路径、信任边界、数据分类、故障模式、幂等性、SLO、每请求成本、热路径复杂度及结论(PASS / RISKS LISTED / N/A),最后汇总所有 RISKS LISTED 项及缓解措施。

限制:允许 PASS-with-risks,条件是每个风险明确、有缓解计划或用户明确接受、预演覆盖风险评分前三项;gate:plan 可批准 PASS-with-risks,gate:ship 需要缓解措施已交付。