mcpField
P
platform-engineering

platform-engineering

github.com/magnus919云与 DevOps16183 次安装1 天前更新
代码仓库

关于 platform-engineering

platform-engineering 是面向平台工程师的参考技能，提供按需加载的方法、模板和领域指南，用于设计和运营交付平台。内容涵盖基础设施、网络、可观测性及平台产品实践，但本身不执行操作。

主要功能

  1. 01CI/CD 与 GitOps 设计指南
  2. 02基础设施即代码模式
  3. 03容器与网络参考资料
  4. 04可观测性与密钥管理指南
  5. 05平台产品与策略模板

适用场景

  1. 01设计交付流水线
  2. 02审查 Terraform 或 OpenTofu 方案
  3. 03规划平台自助服务路径
  4. 04定义可观测性责任

安装

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

$npx skills add https://github.com/magnus919/agent-skills --skill platform-engineering

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

包含的文件

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

README.md
evals/
evals.json
references/
automation-languages.md
ci-cd-pipelines.md
cloud-platforms.md
container-orchestration.md
infrastructure-as-code.md
observability.md
platform-product-evidence.md
policy-and-observability-ownership.md
release-engineering.md
secret-management.md
service-networking.md
templates/
golden-path-self-service-portal.md
iac-review-record.md
observability-contract.md
platform-exception-record.md
platform-value-record.md

详细介绍

平台工程

平台工程工作的核心方法论与参考资料库。此技能本身不会执行操作——它提供框架、模式和参考资料，由平台工程师配置按需加载。

何时加载

当任务涉及以下内容时，加载此技能：

触发条件所需内容
设计 CI/CD 流水线流水线结构、GitOps 同步策略、发布自动化
基础设施即代码规划Terraform/OpenTofu 模块模式、状态管理、Pulumi/Ansible 模式
容器编排设计K8s Pod 生命周期、Helm chart 约定、Kustomize 覆盖层、Docker Compose；集群运维（清单、RBAC、工作负载、升级）应转到 kubernetes
服务网络 / 网格Traefik/nginx/Caddy 配置、Tailscale/Headscale ACL、WireGuard、服务网格
可观测性策略Prometheus 规则、Grafana 仪表板即代码、Loki 日志记录、追踪；Prometheus/OTel/Loki 技术栈运维（抓取、规则、保留）应转到 telemetry，Grafana 产品相关工作应转到 grafana
基础设施执行Terraform/OpenTofu plan/apply 工作流、状态后端、漂移检测、升级——转到 terraform
PostgreSQL 运维服务端配置审查、索引和查询计划、清理 / 膨胀、备份 / PITR、复制——转到 postgres
密钥管理设计Vault、SOPS、External Secrets Operator 模式
云架构评估多云模式、云服务商基础、成本治理
部署流水线审查交付平台架构；定义发布模型、晋级关卡、部署或回滚策略时，加载 release-engineering
平台产品需求受理或价值论证适用性、内部用户发现、成果契约、采用 / 价值证据，以及停止 / 升级规则
自助服务契约或策略例外API / 成果契约、护栏证据、例外责任归属，以及逃生通道审查
平台可观测性责任归属平台客户采用情况、SLI/SLO 发布、响应路由，以及责任交接

何时不使用

使用 release-engineering 定义发布流程、晋级、部署或回滚策略。此技能用于构建和运维落实这些决策的交付平台。

加载顺序

skill_view('platform-engineering')          # This — methodology index
skill_view('artifact-pyramids')              # Output contract
skill_view('docker-compose')                 # Container lifecycle and Compose (if needed)
skill_view('traefik')                        # Reverse proxy (if needed)
skill_view('tailscale')                      # Mesh networking (if needed)
skill_view('implementation-planning')        # Work breakdown (if needed)

然后从此技能加载特定领域的参考资料：

skill_view('platform-engineering', file_path='references/ci-cd-pipelines.md')
skill_view('platform-engineering', file_path='references/platform-product-evidence.md')
skill_view('platform-engineering', file_path='references/policy-and-observability-ownership.md')
skill_view('platform-engineering', file_path='references/infrastructure-as-code.md')
# ... etc per domain

参考文件

参考文件用途
references/ci-cd-pipelines.mdGitHub Actions、GitLab CI、Forgejo CI、Jenkins、CircleCI；使用 ArgoCD/Flux 实现 GitOps；发布自动化
references/container-orchestration.mdK8s/k3s、Helm chart 约定、Kustomize overlays、RBAC 模式、Docker Compose 生产环境模式
references/infrastructure-as-code.mdTerraform/OpenTofu 模块设计、状态后端、Pulumi 项目结构、Ansible 角色、CloudFormation/CDK
references/service-networking.md反向代理配置（Traefik、nginx、Caddy）、Tailscale/Headscale ACL、WireGuard 拓扑、服务网格（Istio、Cilium）
references/observability.mdPrometheus 记录规则/告警、Grafana 仪表板即代码、Loki 日志聚合、OpenTelemetry 跟踪
references/secret-management.mdHashiCorp Vault 身份验证/策略、在 Git 中使用 SOPS/age 加密、External Secrets Operator、Sealed Secrets
references/cloud-platforms.mdAWS/GCP/Azure 基础服务、多云设计、成本治理、提供商抽象
references/automation-languages.mdGo CLI 模式、Python SDK 集成、用于平台工具的 Bash 引导程序/约定
references/release-engineering.md容器镜像生命周期、制品版本控制策略、发布门禁检查清单、Helm chart 晋级
references/platform-product-evidence.md适用性/准入、平台领域边界、成果/自助服务契约、采用情况与价值证据
references/policy-and-observability-ownership.md开发者负责的交付、可复用的策略检查、例外、可观测性责任归属和响应路由

模板

模板使用时机
templates/golden-path-self-service-portal.md为开发者工作流设计黄金路径或自助服务门户（范围界定、流程、护栏、退出机制、指标）
templates/iac-review-record.md记录 Terraform/OpenTofu/Pulumi/Ansible 模块发布前的结构化审查
templates/observability-contract.md声明服务在接入生产流量前必须满足的指标/日志/跟踪契约
templates/platform-value-record.md记录平台问题、基线、采用假设、价值模型以及停止/升级决策
templates/platform-exception-record.md审查带有范围、证据、到期时间和责任人的退出机制或策略例外

输出契约

使用此技能的配置文件会生成工件金字塔。对任何调用方的响应都是 00-index.md 的绝对路径。规范请参阅 artifact-pyramids 技能。

设计原则

  1. 平台本身就是产品。 内部开发者是你的客户。他们的工作效率、满意度和认知负担是首要衡量指标。
  2. 提供黄金路径，而非黄金牢笼。 为常见工作流提供便捷路径，同时允许用户另辟蹊径。让正确的做法更容易，而不是让错误的做法变得不可能。
  3. 降低认知负担。 抽象基础设施的复杂性。开发者不应该为了部署服务而必须了解 Kubernetes 内部机制或 Terraform 状态管理。
  4. 一切皆代码。 基础设施、配置、流水线和策略都应纳入版本控制、经过审查且可复现。Git 是唯一可信来源。
  5. 优先自助服务，而非工单。 团队之间的每一次人工交接都是瓶颈。如果开发者需要其他团队协助才能部署，说明平台尚不完善。
  6. 自动化是默认方式。 凡是可以自动化的流程，都必须自动化。人工操作是苦差事——也是组织的负担。
  7. 可观测性是基础设施的一部分。 日志、指标、追踪和仪表板是平台契约，而非可有可无的附加项。每项服务默认都应具备这些能力。
  8. 安全应内建，而非事后补上。 供应链安全、密钥管理、漏洞扫描和策略执行都是平台的职责。
  9. API 优先设计。 平台执行的所有操作都应可通过 API 访问，以支持自动化、自助服务门户和 CLI 工具。

相关技能

  • artifact-pyramids — 输出契约规范
  • docker-compose — 容器生命周期和多容器 Compose 编排
  • kubernetes — 集群运维：清单、RBAC、工作负载、Helm、升级和故障排查
  • terraform — Terraform/OpenTofu 执行：plan/apply 工作流、状态后端与锁定、漂移检测、升级和重构
  • telemetry — Prometheus/OpenTelemetry Collector/Loki 技术栈运维：抓取配置、规则文件、保留策略、高可用
  • postgres — PostgreSQL 运维：配置审查、索引和查询计划诊断、清理与膨胀、备份/PITR、复制和故障转移
  • grafana — Grafana 产品工作：仪表板、面板、数据源、告警规则、联系人、通知策略
  • traefik — 反向代理和入口配置
  • tailscale — 网状网络和 ACL 策略
  • implementation-planning — 工作拆解和依赖排序
  • mermaid-diagrams — 架构图生成
  • site-reliability-engineering — 部署后可靠性的相关领域
  • release-engineering — 发布流程、制品晋级、就绪状态、推出和回滚策略；此技能负责实现这些决策的交付平台

评论

支持 Markdown