SuperAPI AI 工具集

production-planner

智能体与模型

查看项目

更新于 10-16 04:20

技能介绍

用途

Production Planner 面向生产系统架构规划。它的核心主张是把生产环境的关切从第一天就嵌入架构,而不是事后补上——资料中举例说明,“缓存以后再加”会变成重写,“认证以后再想”会变成安全事件,而“以后”永远不会到来。

主要能力

该技能以资深架构师角色运作,强调自己交付过承载真实流量、经历过真实事故的系统。其产出包括:结构化规划访谈、架构决策记录(ADR)以及一份生产架构检查清单。资料明确列出了访谈各阶段的问题维度,以及检查清单的完整条目。

使用方式

使用方式是一轮结构化发现访谈:一次只问一个问题,等到回答后再继续,不要一次性抛出全部问题;可根据回答调整追问。若用户表示“直接选合理的默认值”,可以把某个阶段压缩为一次摘要确认,但仍须在继续前确认。

访谈分为三个阶段。阶段一“需求”:要解决什么问题、用户是谁(要求具体,例如按订阅续费、约 5 万 B2B 客户、由调度器触发、失败重试);预期流量模式(平均与峰值 RPS、每月存储增长、增长率、是否尖峰);延迟要求(p50/p95/p99、是否有硬性 SLA、是否有实时需求如 WebSocket、SSE、低于 100ms);数据敏感级别(PII、金融、医疗 PHI/HIPAA、仅公开或内部),这决定加密、访问控制、审计日志与合规范围;团队规模与专长,资料强调两人团队无法运维 Kafka 集群;预算范围,决定推荐托管还是自建。

阶段二“约束与依赖”:与哪些现有系统集成(上游调用方、下游被调用方、共享数据库、消息队列、认证提供方),每个集成点都是失败模式;硬性约束(语言/框架、云厂商、SOC2/HIPAA/PCI-DSS/GDPR 等合规、部署限制);已有数据存储与是否需要数据迁移;部署目标与现有 CI/CD 流水线。

阶段三“失败模式分析”:数据库宕机 5 分钟会怎样(能否提供陈旧数据、排队写入、返回错误、是否有只读副本可切换);下游服务报错会怎样(能否优雅降级、重试或必须失败,超时预算如何级联);可接受的数据丢失窗口(RPO);可接受的停机时间(RTO);爆炸半径边界与最坏情况设计。

架构决策记录(ADR)

对每个重要技术选择,按 ADR 模板记录:状态、上下文、备选方案(优缺点与成本)、决策、后果(引入的新风险、新增运维负担、明确未解决的问题)、复审日期。资料要求至少覆盖:主数据存储、API 风格、认证授权方式、缓存策略、部署托管平台、服务间通信。

生产架构检查清单

资料给出的清单分为若干板块。API 设计:版本策略、分页(大或频繁更新数据集用游标分页,服务端设最大页大小)、幂等键(创建资源或触发副作用的变更必须,TTL 通常 24 小时)、限流(返回 429 与 Retry-After,按 API key 而非 IP)、认证授权模型、RFC 7807 错误格式、请求校验、OpenAPI 文档。数据架构:主数据存储选择理由、读写分离、缓存策略与缓存击穿保护、保留与归档、备份策略(未经恢复演练的备份不算备份)、模式演进(expand-contract 模式)。可靠性:断路器、重试策略(指数退避加抖动,上限 3-5 次,不重试非幂等请求和 4xx)、超时预算、优雅降级、健康检查(存活探针与就绪探针职责不同)、负载削减。安全架构:认证流程、授权模型(RBAC/ABAC/策略引擎)、密钥管理、网络分段、加密、审计日志。运维就绪:部署策略(蓝绿、金丝雀、滚动)、回滚机制(5 分钟内可回滚)、功能开关、监控告警(RED 指标,按症状而非原因告警)、运行手册、值班轮换。

技术选型标准

资料给出带权重的评估维度(团队专长、运维复杂度权重高;生态成熟度、可观测性、规模成本权重中;招聘市场与社区支持权重中低),并列出应阻断技术选型的红旗:团队无人有生产使用经验、活跃维护者少于两人、无明确迁出路径、只有“快速上手”文档、运维模型与现有体系根本不同。

输出格式

完成访谈后产出规划文档,结构为:概览、架构图(简单系统用 ASCII,复杂系统用 Mermaid,标注协议)、关键决策(最少 3 个,通常 5-8 个 ADR)、组件设计(职责、API、数据、依赖、失败模式)、数据模型、生产检查清单状态、风险与缓解(按可能性×影响排序的前五风险)。

限制

资料未提供该技能的安装命令、收费方式、支持平台或具体版本信息。