mcpField
P
production-readiness

production-readiness

github.com/magnus919云与 DevOps15368 次安装今天更新
代码仓库

关于 production-readiness

面向准备作出上线决定的团队的生产就绪度技能。它按风险等级汇总多类证据,记录缺失项的负责人和期限,并给出四种决定之一,而不使用通用风险分数。

主要功能

  1. 01按风险等级组织证据包
  2. 02覆盖 11 类证据
  3. 03记录缺项负责人和期限
  4. 04给出 Go、No-go、Defer 或 Exception 决定
  5. 05记录负责的上线审批人

适用场景

  1. 01上线前评审就绪情况
  2. 02为评审委员会准备证据
  3. 03评估依赖迁移的发布
  4. 04按低风险变更调整评审深度

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/magnus919/agent-skills --skill production-readiness

安装后在 Claude Code 中输入/production-readiness确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
evals/
evals.json
references/
discovery-brief.md
readiness-record.md

详细介绍

生产就绪性

汇总跨领域证据,形成上线决策。本技能按风险类别定义最低限度的生产证据包,将每类证据映射到具名来源,或明确标记为缺失证据,并在四种上线决策中作出选择,同时指定责任人。本技能不会重复发布检查清单,不会生成通用风险评分,并会将详细检查转交给现有的专业技能。

何时加载

符合以下任一条件时加载:

  • 服务、功能或变更即将进入上线决策阶段,需要进行生产就绪性评审。
  • 必须将多个领域(所有权、SLO、安全、数据、支持、成本、可观测性)的证据汇总成一份可供评审的记录。
  • 上线评审委员会、就绪门禁或责任人需要结构化的上线/不上线/延期/例外建议。
  • 依赖迁移的发布需要提供证据,证明每项依赖都已就绪。
  • 仅涉及文档的低风险变更需要进行适度(而非全面)的就绪性评审。

何时不使用

  • 发布流水线机制——推广、金丝雀阶段、CI/CD 门禁配置、版本管理和制品管理。请转至 release-engineering。Release-engineering 负责流水线门禁;production-readiness 负责跨领域证据汇总和上线决策。
  • 事件响应、SLO 运维、值班和可靠性工程。 请转至 site-reliability-engineering。 SRE 负责在线服务的健康边界;production-readiness 负责上线前的就绪边界。
  • 安全实现、威胁建模或渗透测试。 请转至 secure-software-engineering 或 security-audit-methodology。
  • 数据流水线运维、架构迁移工程或 ETL/ELT 设计。 请转至 data-engineering。
  • 测试策略、回归规划和质量门禁。 请转至 qa-methodology。
  • 平台基础设施配置或 IDP 设计。 请转至 platform-engineering。
  • 实现规划、工作拆分或交付协调。 请转至 implementation-planning。
  • 规范编写和 SDD 门禁机制。 请转至 spec-driven-development。
  • 根据明确标准作出验证结论。 请转至 verification-methodology。
  • API 契约设计和版本管理策略。 请转至 api-design-and-evolution。
  • 统计分析、实验设计或因果推断。 请转至 data-scientist。
  • 跨所有就绪维度端到端编排生产生命周期。 请转至 production-excellence 捆绑包(仅为文字提及,尚未发布)。 Production-excellence 将 production-readiness、migration-engineering、 resilience-and-recovery、capacity-and-cost-engineering 和 incident-learning 组合起来, 覆盖完整的生产运维生命周期。

风险类别与证据要求

就绪证据包会根据风险类别调整。低风险的文档发布不应要求与面向用户的服务上线提供相同的证据。

风险类别触发条件必需的证据类别审查深度
低仅涉及文档的更改、更新 README、非功能性配置注释、影响不超过 1 个团队的内部工具、不涉及后端的纯内容网站更改责任归属、用户/业务成果(1 行说明)、回滚(还原一次提交)自行审查;轻量记录
标准面向用户的功能、拥有超过 1 个使用团队的内部服务、增加 API、数据架构的兼容性变更、不改变 SLO 的性能改进全部 11 个类别(见下方清单);缺失证据必须明确标注缺口、负责人和日期同行审查;完整就绪记录
高面向客户的服务上线、涉及 SLO 的更改、身份验证/授权更改、不可逆的数据迁移、支付/计费路径、更改涉及合规范围、跨越信任边界全部 11 个类别,且每个类别都必须提供来自具名来源的证据;每个缺口都需要由人工审批者批准豁免正式审查;例外情况需要人工审批标注,且须与自动检查区分

风险类别由所涉及的最高风险维度决定,不通过求平均或打分得出。如果任一维度(例如数据迁移的不可逆性、跨越信任边界)符合高风险条件,则整个审查都属于高风险。

生产证据清单

这 11 个证据类别构成最低限度的生产证据包。每个类别都必须有具名的来源材料,或明确标注缺失证据的处理结果。

#证据类别来源/证据缺口/缺失项
1责任归属source: 团队名称、值班轮值、升级路径或服务目录条目missing: "未确定负责人——交由 处理,截止日期 "
2用户/业务成果source: 成功指标、OKR 链接或含可衡量目标的产品简报missing: "未定义成果——交由产品负责人处理,截止日期 "
3依赖项source: 依赖关系图、健康检查结果或上游 SLO 状态missing: "依赖关系图不完整——交由 处理,截止日期 "
4SLOsource: SLO 声明、错误预算策略或 SLO 仪表板链接missing: "尚未声明 SLO——交由 SRE 处理,截止日期 "
5可观测性source: 仪表板链接、告警规则、日志/监控覆盖情况或黄金信号报告missing: "存在可观测性缺口——交由 处理,截止日期 "
6支持source: 运维手册、支持操作手册、升级矩阵或支持交接文档missing: "没有运维手册——交由 处理,截止日期 "
7安全source: 安全审查记录、威胁模型摘要或安全验收签字missing: "尚未完成安全审查——交由安全团队处理,截止日期 "
8数据source: 数据分类记录、保留/删除策略、备份/恢复测试证据或迁移测试结果missing: "没有可用的数据分类信息——交由数据负责人处理,截止日期 "
9回滚source: 附有演练日志的回滚运维手册,或包含恢复时间估算的还原计划missing: "没有回滚计划——交由 处理,截止日期 "
10容量source: 容量模型、负载测试报告、配额/限制审查或成本预测missing: "尚未建立容量模型——交由 处理,截止日期 "
11成本source: 成本估算、预算批准记录或成本归属记录missing: "没有可用的成本估算——交由财务负责人处理,截止日期 "

结构化字段(必填)

以下四类信息必须以结构化字段的形式呈现(清单标记、表格行或带标签的表单字段),不能只出现在叙述性文字中。

  • 所有权 — 指明具名负责人或负责团队及升级路径;记录在上方的证据清单中。
  • 回滚 — 提供回滚计划或恢复路径,并附演练证据;记录在上方的证据清单中。
  • 支持 — 提供运行手册、支持手册或交接文档;记录在上方的证据清单中。
  • 可观测性 — 提供仪表板、告警规则和监控覆盖情况;记录在上方的证据清单中。

发布决策结果

每次就绪情况评审必须且只能产生以下四种结果之一。决策须记录问责负责人。

结果含义所需证据问责负责人
通过已批准 — 继续发布已提供具名来源,满足该风险类别的所有证据要求;不存在未解决的缺口具名发布批准人(例如服务负责人、发布评审主席)
不通过受阻 — 不得发布至少存在一项阻塞性缺口,并明确记录缺失的证据;该缺口对风险类别有实质影响具名发布批准人
延期暂缓 — 满足条件后重新评审记录延期缺口、负责人和截止日期;明确说明延期原因具名发布批准人 + 缺口负责人
例外批准有豁免地批准 — 尽管存在未解决的缺口,仍继续发布明确指出具体缺口;由具名人工批准人明确授予例外;例外标注须与自动检查区分开,且不得由提交者自行授予具名人工批准人(不同于自动评审)

例外结果要求明确的人工批准标注——由具名个人批准豁免。此批准不同于任何自动检查结果,且必须单独记录(例如,记录在升级记录或例外日志中)。提交者不得自行授予例外。

工作流

  1. 确定风险类别。 根据上方的触发条件表对照变更,选择低、标准或高。
  2. 收集证据。 对 11 个类别逐一记录具名来源,或记录包含负责人和截止日期的缺口。使用就绪记录模板。
  3. 评估完整性。 确认每个类别都有条目。标注了缺口的类别也视为完整,因为评审所需的缺口已明确可见。
  4. 作出发布决策。 根据风险类别要求评估证据,并得出以下结果之一:通过、不通过、延期、例外批准。
  5. 记录决策。 提交就绪记录,并注明问责负责人;对于例外批准,还须注明明确的人工批准标注。

不设通用风险评分

此技能不会生成通用风险评分、综合风险评级或风险总分。每个证据维度都独立存在,并分别按照风险类别要求进行评估。如果单独评估各个维度(例如安全维度评估或数据维度评估),则须在该维度的证据条目中明确说明任何加权的理由——不存在能够概括就绪情况的单一数字。

文件索引

路径加载时机
references/discovery-brief.md了解与同级生产和工程技能的所有权边界时
references/readiness-record.md填写就绪记录模板或评审已提交的记录时

路由表

需求是……路由至
发布推广、金丝雀阶段、CI/CD 门禁、版本管理release-engineering
在线服务 SLO、事件响应、值班、错误预算site-reliability-engineering
安全要求、威胁建模、安全默认设置secure-software-engineering
数据管道、架构迁移、ETL/ELTdata-engineering
测试策略、回归规划、质量门禁qa-methodology
平台基础设施、IDP、服务网络platform-engineering
工作拆解、依赖关系映射、发布顺序implementation-planning
规范编写、验收标准、SDD 阶段门禁spec-driven-development
根据明确标准给出验证结论verification-methodology
API 契约设计与版本管理api-design-and-evolution
统计分析、实验设计data-scientist
完整的生产运维生命周期production-excellence 套件(说明性引用——指向未来的套件,该套件将整合 production-readiness、migration-engineering、resilience-and-recovery、capacity-and-cost-engineering 和 incident-learning)

评论

支持 Markdown