为什么有这个 skill

提供不依赖精确指标或模糊生命周期阶段的生产工程决策框架，并通过按需参考控制上下文和设计复杂度。

解决什么问题

开发任务常把容量、资源边界、故障恢复、运行诊断和兼容性推迟到后续版本，导致功能接入真实流量后暴露严重问题。

查看 SKILL.md · 下载完整包

正在生成安装命令…

人类说明

production-engineering

解决什么问题

Agent 在开发任务中容易把“可以运行”当作完成条件：高并发、慢 I/O、队列积压、兼容性、运行诊断和故障恢复被推迟到后续版本，最终造成代码在本地可用、接入真实流量后却快速暴露性能或可靠性问题。

这个 skill 不以某项基础设施为中心，也不要求用户先给出精确容量指标。它从业务链路、工作负载、状态语义、有限资源和变更影响推导当前任务实际需要的工程约束。

核心原则

• MVP 可以缩减功能范围，不能取消本次范围内必要的运行安全。
• 不依赖“原型、生产落地、生产加固”等模糊阶段名称，而根据风险事实累积义务。
• 精确指标不是开工许可；量级或未知指标通过场景、明确假设、有界默认值和上线观测处理。
• 所有调用方均可控且能同步切换时默认直接替换；公开或未知调用方场景根据发布和回滚证据决定推荐策略。
• 兼容策略只有直接替换与保持兼容两个维度；如果存在数据变化，再单独决定是否迁移。
• 日志、指标和 Trace 用于解释运行行为，但日志管道不得阻塞主业务或无界占用内存。
• Redis、数据库、HTTP 和消息系统是技术实现，规则首先属于缓存、权威状态、消息投递、协调和外部依赖等业务角色。
• 只要求诊断或解释时不擅自修改；非适用任务不扩大生产约束；生产资源操作需要独立的目标、授权和安全计划。
• 数据库结构、语言架构和安全等专业 skill 负责对应领域制品，本 skill 只补充生产运行约束。

内容结构

• SKILL.md：任务级完成标准、风险识别、兼容决策门和按需路由；
• references/workload-and-capacity.md：容量不确定性、工作负载、流量倾斜和资源预算；
• references/state-and-concurrency.md：状态、副作用、投递和多实例并发语义；
• references/dependencies-and-resilience.md：外部依赖、超时、取消、重试和过载控制；
• references/runtime-diagnostics.md：指标、Trace、结构化日志和非阻塞日志管道；
• references/compatibility-rollout-and-rollback.md：替换与兼容二选一，以及后续数据迁移、混合版本和回滚；
• references/lifecycle-and-recovery.md：启动、重连、预热、积压恢复和优雅停机；
• references/verification-and-handoff.md：风险匹配的验证方式和交付说明；
• references/technologies/external-systems.md：Redis、数据库、HTTP 和消息系统的按需技术检查项。

行为评测位于仓库级 evals/production-engineering/，不会打包进可安装 Skill，也不会参与 Agent 的核心决策上下文。通用沟通、历史代码习惯和类型清晰度由独立的 engineering-collaboration skill 负责。

适用范围

适用于准备接入真实服务的后端接口、消费者、定时任务、批处理、数据链路和现有功能改造。明确一次性、无真实数据、无共享资源且不会部署的实验，以及纯代码风格或算法问题，不需要使用本 skill。

安装

从仓库根目录执行：

bash scripts/install.sh --skill production-engineering --yes

安装后需要新建会话或让 Agent 重新扫描 skills 目录。

支持资源

• references/compatibility-rollout-and-rollback.md
• references/dependencies-and-resilience.md
• references/lifecycle-and-recovery.md
• references/runtime-diagnostics.md
• references/state-and-concurrency.md
• references/technologies/external-systems.md
• references/verification-and-handoff.md
• references/workload-and-capacity.md