用途
本技能面向多租户 SaaS 的控制平面（control plane）工程。控制平面指 SaaS 提供方用于运营所有租户的横切服务，与客户使用的应用平面（application plane）相对。适用场景包括：设计多租户 SaaS 的横切服务；审计租户生命周期、入驻、暂停与管理操作散落各处且无人负责的现有 SaaS；将 SaaS 拆分为应用平面服务（功能）与控制平面服务（运营），使发布、扩缩容与归属清晰；在 SaaS 跨越 100 万美元 ARR 门槛时，用一套有意识的平台服务替代手工运维（SSH、临时 SQL、创始人分诊）。
不适用场景：数据/查询层的按租户隔离强制（应使用 multi-tenant-saas-architecture）；按租户组合可插拔业务模块（应使用 modular-saas-architecture）；Stripe Billing 生命周期本身（应使用 subscription-billing 与 stripe-payments）；单个租户内面向客户的管理面板（应使用 multi-tenant-saas-architecture 的三面板部分）。
主要能力
技能定义七项控制平面服务：1）租户管理，拥有 tenants 表、生命周期状态、套餐与元数据，v1 提供 CRUD API 与管理 UI；2）身份绑定，管理用户与租户的成员关系、角色与认证域引导；3）入驻编排器，负责从注册到租户可用的 saga；4）计费客户镜像，镜像 Stripe Customer/Subscription/Price，含 webhook 摄取与对账；5）指标聚合器，按租户标记用量并汇总 MRR/ARR/NRR/流失；6）审计日志，记录每次控制平面变更与跨租户访问，为追加式账本并含保留策略；7）系统管理后台，供提供方员工运营 SaaS 的 UI、API、RBAC 与审计。早期 SaaS 的 v1 通常包含 1、2、3、4、6、7 的最小形态，指标聚合器常从 Stripe 加临时 SQL 起步，v2 再升级到数据仓库。
技能还给出租户生命周期状态机（pending、failed、ready、active、suspended、expired、cancelled、archived、deleted）及其持久化模式（tenants.status 与 tenant_status_history），以及规范化的 users、user_tenant_memberships、tenant_billing 表结构。审计日志 schema 包含 actor、目标租户、动作、理由、前后状态与 request_id，保留策略为超级管理员操作 7 年、系统操作 2 年，热存 12 个月后导出冷存储。
使用方式
工作流为：先通读 SKILL.md；将 SaaS 映射到七项控制平面服务并标记 v1/v2/v3/不需要；设计租户生命周期状态机并持久化为数据；定义规范租户模型与身份绑定；构建入驻编排器；接入指标聚合器与审计日志；搭建系统管理后台；最后应用反模式清单。质量要求包括：控制平面与应用平面分开部署（不同发布节奏、不同 on-call、不同 SLA）；每次控制平面变更写入审计日志（含操作者、目标租户、动作、理由、前后状态）；控制平面完全 API 驱动，管理后台只是其上的 UI；租户状态变更作为事件发布到总线；每次变更具备幂等性。
适用场景与限制
适用场景见上文“用途”。限制与反模式包括：在应用平面构建触碰其他租户数据的租户管理功能；将入驻实现为 300 行控制器方法而非编排状态机；用布尔标志（is_active、is_archived、is_suspended）而非单一状态枚举加状态历史存储租户生命周期；超级管理员操作无审计日志；控制平面与应用平面同进程/同发布部署。技能还列出 AI 控制平面服务扩展：LLM 网关、提示词注册表、知识库服务、评测框架、AI 审计日志，并建议与核心服务一样独立部署、独立 on-call、更严格 SLA。
输出物
控制平面服务清单（映射 v1/v2/v3）；规范租户、用户、成员与计费客户 schema；租户生命周期状态机与 status_history；入驻编排器设计；审计日志 schema 与保留策略；系统管理后台 API 与 UI 计划。证据产物包括 docs/saas/control-plane-services.md、docs/saas/tenant-lifecycle.md、docs/saas/audit-log-spec.md。
参考与配套
参考文件：references/control-plane-services.md、references/tenant-lifecycle-state-machine.md、references/audit-log-design.md。配套技能：saas-tenant-onboarding-automation、saas-admin-backoffice-tooling、multi-tenant-saas-architecture、subscription-billing、saas-sso-scim-enterprise-auth。AI 扩展交叉引用：ai-on-saas-architecture、ai-model-gateway、ai-rag-multi-tenant、ai-eval-harness、ai-cost-per-tenant-attribution、ai-prompt-injection-and-tenant-safety、ai-observability-and-debugging。