2. 平台能力目录与用户旅程映射
从旅程到能力：建立可追溯的映射关系
平台能力目录不是功能清单，而是把开发者旅程中的每个关键动作，映射到平台提供的具体能力、接口与责任边界。映射的核心产出是一张旅程—能力矩阵：行是旅程阶段，列是平台能力域，单元格记录该阶段依赖的能力、当前成熟度与缺口。
下面以一条典型的“代码提交到生产发布”旅程为例，先定义旅程阶段与能力域的对应关系，再据此识别缺失环节并排序。
缺口优先级排序
识别出缺失能力后，不能平均用力。按“阻塞程度 × 影响范围 × 实现成本”三个维度打分，优先补齐阻塞发布主路径且影响所有团队的能力。
| 缺失能力 | 阻塞程度 | 影响范围 | 实现成本 | 优先级 |
|---|---|---|---|---|
| 密钥管理 | 高（无法安全注入生产密钥） | 全部团队 | 中 | P0 |
| 环境预览 | 高（PR 无法端到端验证） | 前端/后端 | 中高 | P0 |
| 依赖漏洞扫描 | 中（安全门禁缺失） | 全部团队 | 低 | P1 |
| 构建产物签名 | 中（供应链完整性） | 全部团队 | 中 | P1 |
| 制品溯源 | 低（审计与排障需要） | 全部团队 | 低 | P2 |
排序原则：先补“阻塞主路径 + 影响全部团队”的能力（P0），再补“安全合规类”能力（P1），最后补“审计与可追溯类”能力（P2）。每项能力补齐后，回到矩阵中更新状态，形成迭代闭环。
能力目录的维护方式
能力目录不是一次性文档，而是随平台演进的活文档。建议以 YAML 或表格形式维护，每个能力条目至少包含：能力名称、所属域、对应旅程阶段、接口/入口、负责人、成熟度状态、依赖关系。当旅程新增阶段或平台新增能力时，同步更新矩阵，确保映射关系始终反映真实交付路径。
# 能力目录条目示例（YAML）
- name: 密钥管理
domain: 环境与部署
journey_stage: ④ 环境供给
interface: platform secrets CLI / API
owner: platform-security
maturity: missing
priority: P0
depends_on: [配置即代码]
本案例核心产出：一张旅程—能力映射矩阵 + 一份按优先级排序的缺口清单。矩阵用于对齐团队对“平台该提供什么”的共识，缺口清单用于驱动平台迭代排期。