← Back to home
Skill

生产级代码架构师 — Production Architect

tencent_skillhub · 1.0.0 · Downloads 434 · Heat 45.6

Introduction

# 生产级代码架构师 · Production Architect > **写代码前,先把"上线不出事"想清楚。** | 项目 | 内容 | |---|---| | **名称(中文)** | 生产级代码架构师 | | **名称(英文)** | Production Architect | | **Slug** | `production-architect` | | **版本** | 1.0.0 | | **一句话定位** | 一位 10 年经验的资深架构师 + 代码安全专家,在写任何代码之前先澄清约束、做架构决策,再产出生产级代码 | --- ## 一、解决什么问题 AI 写代码常常"能跑就行":SQL 直接拼接、密钥硬编码、异常被空 `catch` 吞掉、没问清量级就上线……结果就是**半夜救火**。 绝大多数线上事故,根因都不是"代码写错了",而是"**编码前该问的没问**"——鉴权怎么做?量级多大?并发会不会超卖?依赖挂了怎么办?敏感数据怎么存? **Production Architect 把"上线不出事"前置到编码之前**:先像资深架构师一样把约束问清、把架构想对,再动手写生产级代码——首版就要把安全红线、异常处理、韧性设计做对,而不是"先给个 demo 再迭代"。 --- ## 二、核心能力 | 能力 | 说明 | |---|---| | 🔒 **澄清先行** | 编码前先分流定深度,再按五维度把鉴权、量级、并发、幂等、事务、熔断、敏感数据等问清——**宁问不返工** | | 🌳 **智能分流** | T0 直接产出(纯算法)/ T1 标准澄清(单文件)/ T2 深度模式(钱·权限·并发·核心链路),避免对简单任务过度流程 | | 🛡️ **五维度覆盖** | 安全 / 性能并发 / 扩展性架构 / 可维护性 / **可靠性与韧性**(幂等·重试超时·熔断降级·事务一致性·失败隔离·可观测) | | 🚨 **安全红线** | 🔴 绝对底线不可违反(SQL 参数化 / 禁 eval / 密码哈希 / 密钥不硬编码);权威规则指向项目 `CLAUDE.md`,并提供 Bad/Good 代码对照 | | ⚖️ **设计决策权衡** | 不只给一种方案,列出备选与放弃原因,标注信心等级(✅确认 / ⚠️可能 / ❓不确定)+ 验证方法 | | 📦 **生产级交付闭环** | 四段结构输出:需求确认摘要 → 架构/设计决策 → 代码实现 → 潜在风险与 TODO | --- ## 三、差异化定位 | 维度 | 本 Skill(production-architect) | 其他 Skill | |---|---|---| | **时机** | **编码前**澄清 + 决策 + 首版生产级 | `code-optimizer`:事后性能反模式排查;`vibe-guardian`:事后门控扫描 | | **焦点** | 安全红线 + 架构权衡 + 韧性 + 生产级交付 | 通用 `code-review`:功能正确性 + 代码风格 | | **价值** | **事前预防**,把事故挡在编码之前 | **事后修复**,发现已写代码的问题 | > **推荐组合**:先用本 Skill 完成澄清与首版生产级实现 → 性能问题交给 `code-optimizer` 深入。 --- ## 四、工作原理 ``` 收到编码需求 │ ├─ 分流决策树 ────► 🟢 T0 直接产出 / 🟡 T1 标准澄清 / 🔴 T2 深度模式 │ ├─ 五维度澄清 ────► 按档位挑 3~8 个高不确定项,每个配推荐默认值 │ ├─ 分层输出协议 ──► ①需求摘要 ②架构决策 ③代码实现 ④风险与TODO │ (T2 追加:架构图 + 灰度/回滚预案 + 测试矩阵) │ └─ 安全红线 ──────► 🔴底线内联 + 权威指向 CLAUDE.md + Bad/Good 代码 ``` 关键设计:**渐进式披露**——SKILL.md 只放精简清单与决策树,完整追问话术、Bad/Good 代码、端到端模板放在 `references/`,按需加载、不占上下文。 --- ## 五、使用方式 **触发词**:新功能上线、写接口(尤其涉及钱/权限/并发/外部依赖)、重构核心链路、多文件/跨服务改动、"生产级 / 高可用 / 架构设计 / 需求澄清"。 **调用**:在 Claude Code 中直接 `/production-architect`,或用自然语言提需求。 **澄清提问长这样**(你只需确认 / 调整,不用从头想): > "为了写出生产级代码,确认 4 个关键点(括号内是我的建议默认值): > 1. **鉴权**:需要登录态吗?(建议:需要,复用现有 JWT 中间件) > 2. **量级**:预计 QPS / 数据行数?(建议:中等量级,列表分页) > 3. **并发**:会有并发写吗?(建议:写操作做幂等) > 4. **韧性**:依赖的外部服务挂了怎么办?(建议:超时 + 重试 + 熔断降级)" **预期输出**:`①需求确认摘要 → ②架构/设计决策 → ③代码实现 → ④潜在风险与 TODO`,代码含类型提示、异常处理、行内注释、关键常量提取。 --- ## 六、适用场景 - ✅ 写新功能 / 新接口(尤其涉及**钱、权限、并发、外部依赖、PII 敏感数据**) - ✅ 重构核心链路、跨服务改动 - ✅ 金融 / 医疗 / 政务 / 用户中心等**重 PII / 高合规**业务 - ✅ 需要把"上线不出事"前置到编码之前的任何生产级交付 - ⚪ 纯算法 / 数据结构题:T0 直接产出,不强行澄清 --- ## 七、能力边界 | ✅ 擅长 | ⚠️ 需要你提供素材 | ❌ 超出范围 | |---|---|---| | 需求澄清与约束确认、分流定深度 | 安全合规具体标准(PCI / 等保级别) | 渗透测试 / 红蓝对抗 | | 架构方案设计与权衡分析 | 现有系统架构图 / 调用量级与峰值 | 基础设施运维(K8s / 网络) | | 生产级代码实现(异常处理、类型、注释) | 表结构 / 数据模型 / 慢查询日志 | 纯 SQL/DBA 层调优(用 code-optimizer) | | 安全红线检查与修复、韧性设计建议 | 第三方服务 SLA / 历史故障 | 发布后门控扫描(用 vibe-guardian) | --- ## 八、技术信息 - **语言**:中文(zh-CN),关键术语保留英文 - **配套文件**: - `SKILL.md`(主文件:分流树 + 五维度 + 输出协议 + 红线指针) - `references/clarification-checklist.md`(五维度完整追问话术与默认值) - `references/security-redlines.md`(安全红线 Bad/Good 代码 + 自检清单) - `references/pii-handling.md`(敏感数据分级 + 采集→销毁端到端矩阵 + 合规提示) - `references/output-protocol.md`(四段模板 + 端到端示例 + T2 附加模板) - `ide-rules/`(Cursor / Windsurf 可加载的精简规则) - **与 `CLAUDE.md` 的关系**:安全红线、性能规则、技术栈等权威规则指向项目 `CLAUDE.md`,本 Skill 不重复、只补充"编码前澄清与决策"层

Resource Information

Author:user_b833da3a
Category:Dev Tools
Version:1.0.0
Auth: No auth
Pricing: Not specified

License information is collected from official sources and may be outdated or missing. Refer to the LICENSE file in the original repository before commercial use.

Tags
代码生成代码审查

Information boundary

Information on this page is collected from official documents for technical presentation only and does not imply our endorsement. Pricing, quotas and availability are subject to the latest official statements. We make no commitment regarding any action you take after leaving this site.

Similar skills

编程专家Pro.Skill

Not specified

编程专家 Pro:融合编程专家 2.0.3 工程专题与编程大神的鸿蒙 ArkTS/ArkUI、微信小程序和小游戏开发资料。用于项目实现、根因调试、审查、重构、测试、架构性能分析及多端开发验证。支持自然语言和 @专题标识,按任务读取包内知识;只问概念时直接回答。

编程大神.Skill

Not specified

【全栈能力】编程大神.Skill:面向复杂真实项目的高阶全栈编程助手。不止生成代码,而是从一句目标接手陌生代码库,拆解需求、补齐实现、追到根因、完成重构、联调前后端,并把结果推进到能运行、能验证、能交付。覆盖 Web、后端、脚本、iOS、安卓、鸿蒙 ArkUI、微信小程序及其他技术栈,支持中英文工程、疑难 Bug、跨模块任务和长任务续做;用构建、日志、真实入口、设备或接口证据说明结果。仅问概念时直接回答,要求落地时持续推进到验收或明确阻塞。

编程专家.Skill

API key required

编程专家.Skill P8级编程助手,25年实战经验技能Skill,全栈:Java/Php网站/软件项目、API设计、Bug诊断、代码生成、代码审查、重构、测试用例、性能基准、技术选型、文档生成、任务拆解、Spec驱动、Karpathy规范、CMS二次开发、前端设计、MySQL/Mariadb、项目知识图谱,以及工程纪律层(根因调试硬闭环、阶段导航、事故复盘/SLO、威胁建模/供应链安全、生产就绪/渐进式发布、AI编码治理、面向Agent代码可读性、LLM应用安全)。支持 @标识 显式调用跳过路由。

编程专家.Skill

API key required

编程专家.Skill P8级编程助手,25年实战经验技能Skill,全栈:Java/Php网站/软件项目、API设计、Bug诊断、代码生成、代码审查、重构、测试用例、性能基准、技术选型、文档生成、任务拆解、Spec驱动、Karpathy规范、CMS二次开发、前端设计、MySQL/Mariadb、项目知识图谱,以及工程纪律层(根因调试硬闭环、阶段导航、事故复盘/SLO、威胁建模/供应链安全、生产就绪/渐进式发布、AI编码治理、面向Agent代码可读性、LLM应用安全)。支持 @标识 显式调用跳过路由。

罗斯蒙德开源项目快速上手

Not specified

【罗斯蒙德开源项目快速上手】南京罗斯蒙德基于已交付项目沉淀的开源项目快速上手场景:默认场景是「讲解整个项目」:给一个本地代码文件夹或仓库地址就直接开讲——先30秒最小扫描、不打断不等回复,一路产出必出五件套:一句话结论(值不值得用)、代码架构(分层+模块依赖+主调用链+扩展机制)、三级能力清单(带高频度与代码位置)、可运行带注释Demo、四段式踩坑点与上手全流程指南,每条结论挂 路径:行号。采用「假设确认表」告知而非卡流程——写一行假设就往下干,用户没回应也照出全量报告,把多轮沟通压缩为零。用户带着需求来时才额外启用「需求满足度评估」分支:先以批处理澄清表把需求歧义问清(≤5问/轮、带默认选项、≤3轮)并冻结需求基线,再逐项做代码审查,给出能否实现、修改位置(文件:行号)、工作量(档位+人日+估算依据)与不涵盖功能的补充方案。三条路由:只讲项目走主线,项目+需求走主线打底+评估,已有单点诉求只出评估。支持分析本地代码路径,无本地路径时联网检索官方文档与源码。触发词:讲解这个项目、解读这个仓库、这个代码是干嘛的、看看这个项目、快速上手、看源码、这个项目怎么用、代码架构、项目结构、核心功能、能力清单、生成 demo、写个示例、踩坑点、注意事项、上手指南、源码分析、依赖注入、开源项目、能不能支持、能不能实现、需要改哪里、改哪些地方、工作量多少、需求满足度、功能项评估、缺口分析、二次开发评估、代码审查。

Github

API key required

使用 `gh` CLI 与 GitHub 交互,通过 `gh issue`、`gh pr`、`gh run` 和 `gh api` 管理议题、PR、CI 运行及高级查询。

What is a Skill

A Skill is a packaged single capability, such as text recognition, document summarization, or keyword extraction. Developers wrap the calling logic and prompts into a plugin-like unit, so users can load it without understanding the underlying model. StackPilot indexes a large number of skills that can be tried instantly or assembled into a plan.