# 生产级代码架构师 · 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 不重复、只补充"编码前澄清与决策"层

收到编码需求
  │
  ├─ 纯算法 / 无 I/O ─────────────────────► 🟢 T0 直接产出
  │   （算法题、数据结构、纯函数）           · 不追问，附复杂度 + 边界
  │                                         · 输出仅 ②④ 段（决策简述 + 代码 + 风险）
  │
  ├─ 单文件 / 单一职责 / 约束较明确 ──────► 🟡 T1 标准澄清
  │   （新接口、新函数、小重构）             · 一次性问 3-4 个高不确定项
  │                                         · 五维度各挑 0-1 项
  │                                         · 输出完整四段协议
  │
  └─ 钱 · 权限 · 并发 · 外部依赖 ·          ► 🔴 T2 深度模式
      上线核心链路 · 跨服务？
                                            · 问 5-8 项，必含【维度五 韧性】
                                            · 必查：幂等 / 事务 / 重试超时 /
                                            ·       熔断 / 可观测 / 向后兼容
                                            · 输出四段 + 架构图 + 灰度/回滚预案 + 测试矩阵