Agent Skills
返回列表
生产级代码架构师

生产级代码架构师

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b833da3a/production-architect。

技能介绍

要解决什么问题

新接口或重构往往「需求一句话」,但鉴权、QPS、并发写、外部依赖失败等约束没写进 prompt。模型容易直接堆出能跑的代码,上线后才暴露 SQL 拼接、缺超时、无幂等等问题。本技能把编码前澄清当成铁律:信息不足以回答「谁、在什么量级、怎么调用、出错怎么收场」时,不生成完整实现。

如何工作

收到需求后先做分流(T0/T1/T2),按档位只问最关键的几项,每项附带推荐默认值,便于你确认或调整,而不是一次性抛十几问。

澄清围绕五维度展开:安全(输入、鉴权、敏感数据)、性能与并发(量级、热点、幂等)、扩展与架构(契约、熔断、兼容)、可维护性(规范、测试、文档)、可靠性与韧性(超时重试、降级、可观测)。确认后按四段协议交付:①需求确认摘要 → ②架构/设计决策与权衡 → ③带类型与异常处理的生产级代码 → ④风险与 TODO(T2 可含灰度/测试矩阵)。

与侧重已有代码性能反模式的 code-optimizer、发布前门控的 vibe-guardian 不同,本技能聚焦写新代码前的决策与安全红线(参数化查询、密钥不入库、禁止动态执行等)。

适用边界

适合新功能、新 API、需要生产级首版的重构;纯算法题、单行 typo、明确「非生产 demo」可走简化路径。PCI/等保细则、渗透测试、K8s 运维、纯 DBA 调优不在范围内;合规标准与现有架构图需你补充素材。

使用场景

  • 新业务要上新 HTTP 接口,产品只说了字段列表,鉴权方式与预计 QPS 还没定,需要先问清再写实现
  • 微服务要接不稳定第三方 API,超时、重试和降级策略未写在需求里,编码前要把韧性约束对齐
  • 列表接口可能遇到并发提交或重复点击,幂等与事务边界不明确,需要按档位澄清后再出首版代码
  • 重构登录或 Token 相关逻辑,需对照安全红线(参数化、哈希、密钥不落库)同时产出设计说明与 TODO

适合人员

  • 负责对内/对外 API 的后端工程师,希望首版就带上异常处理、鉴权与量级假设而不是事后补洞
  • 带小团队交付功能的技术负责人,需要 AI 按四段协议输出「约束摘要 + 权衡 + 代码 + 风险」便于评审
  • 全栈开发在写涉及敏感字段或外部输入的接口,需要五维度追问话术与安全默认值来避免漏项
  • 用 Cursor 等 IDE 做新功能或重构、且会触及 I/O 与部署的工程师,想避免模型在约束不清时直接堆完整实现