platform-engineering

Platform Engineering 是面向平台工程工作的核心方法论与参考库。该技能本身不执行任何操作，而是提供平台工程师角色按需加载的框架、模式和参考资料。

用途

当任务涉及以下领域时加载此技能：

设计 CI/CD 流水线：流水线结构、GitOps 同步策略、发布自动化。
基础设施即代码规划：Terraform/OpenTofu 模块模式、状态管理、Pulumi/Ansible 模式。
容器编排设计：K8s Pod 生命周期、Helm chart 约定、Kustomize overlay、Docker Compose。
服务网络 / 服务网格：Traefik/nginx/Caddy 配置、Tailscale/Headscale ACL、WireGuard、服务网格。
可观测性策略：Prometheus 规则、Grafana 仪表盘即代码、Loki 日志、链路追踪。
密钥管理设计：Vault、SOPS、External Secrets Operator 模式。
云架构评估：多云模式、云厂商基础、成本治理。
部署流水线评审：端到端交付流水线审计、发布工程模式。

使用方式

按加载顺序使用：

skill_view('platform-engineering')          # 本技能——方法论索引
skill_view('artifact-pyramids')              # 输出契约
skill_view('docker-management')              # 容器生命周期（如需要）
skill_view('traefik')                        # 反向代理（如需要）
skill_view('tailscale')                      # 网状网络（如需要）
skill_view('implementation-planning')        # 工作分解（如需要）

然后从本技能加载特定领域的参考文件：

skill_view('platform-engineering', file_path='references/ci-cd-pipelines.md')
skill_view('platform-engineering', file_path='references/infrastructure-as-code.md')
# ... 按领域依次

参考文件

references/ci-cd-pipelines.md：GitHub Actions、GitLab CI、Forgejo CI、Jenkins、CircleCI；ArgoCD/Flux 的 GitOps；发布自动化。
references/container-orchestration.md：K8s/k3s、Helm chart 约定、Kustomize overlay、RBAC 模式、Docker Compose 生产模式。
references/infrastructure-as-code.md：Terraform/OpenTofu 模块设计、状态后端、Pulumi 项目结构、Ansible 角色、CloudFormation/CDK。
references/service-networking.md：反向代理配置（Traefik、nginx、Caddy）、Tailscale/Headscale ACL、WireGuard 拓扑、服务网格（Istio、Cilium）。
references/observability.md：Prometheus 记录规则/告警、Grafana 仪表盘即代码、Loki 日志聚合、OpenTelemetry 链路追踪。
references/secret-management.md：HashiCorp Vault 认证/策略、Git 中的 SOPS/age 加密、External Secrets Operator、Sealed Secrets。
references/cloud-platforms.md：AWS/GCP/Azure 基础服务、多云设计、成本治理、云厂商抽象。
references/automation-languages.md：Go CLI 模式、Python SDK 集成、平台工具的 Bash 引导/约定。
references/release-engineering.md：容器镜像生命周期、制品版本策略、发布门禁检查清单、Helm chart 晋级。

输出契约

使用此技能的角色产出 artifact pyramids，对任何调用者的响应都是 00-index.md 的绝对路径。详见 artifact-pyramids 技能规范。

设计原则

平台即产品。内部开发者是客户。他们的生产力、满意度和认知负荷是首要指标。
铺就黄金路径，而非黄金牢笼。为常见工作流提供铺好的道路，但保留逃生出口。让正确的事变得容易，而不是让错误的事变得不可能。
降低认知负荷。抽象基础设施复杂性。开发者不应需要理解 Kubernetes 内部机制或 Terraform 状态管理才能部署服务。
一切皆代码。基础设施、配置、流水线和策略均受版本控制、经过评审、可复现。Git 是唯一事实来源。
自助服务优于工单。团队之间的每次手动交接都是瓶颈。如果开发者需要另一个团队才能部署，平台就不完整。
自动化为默认。如果流程可以自动化，就必须自动化。手动操作是杂役——对组织征收的税。
可观测性即基础设施。日志、指标、链路追踪和仪表盘是平台契约，不是可选项。每个服务默认获得它们。
安全内建，而非外挂。供应链安全、密钥管理、漏洞扫描和策略执行是平台的责任。
API 优先设计。平台所做的一切都应可通过 API 访问——支持自动化、自助服务门户和 CLI 工具。

适用场景与限制

适用场景：平台工程设计与评估类任务，包括上述各领域的设计与评审工作。

限制：该技能不执行任何实际操作，仅提供方法论索引与参考文件；具体操作需配合 docker-management、traefik、tailscale 等相关技能完成。平台、收费模式等具体信息暂未提供。

技能介绍