impediment-prioritization

障碍优先级排序技能

一项与领域无关的技能，用于对障碍及其对策进行排序。适用于任何 {障碍, 对策} 列表 —— GHQR 发现、审计结果、回顾行动项、风险登记册、架构评审差距等。

何时激活

当用户出现以下情况时激活：

• 要求对障碍、差距、风险、发现或整改项进行优先级排序、排名、排序或分诊
• 提供了一份带有拟议对策的障碍列表（或要求你为一系列问题提出对策）
• 就任何改进 / 整改待办事项询问“我们应该先修复什么”
• 提到价值流优先级排序、A3 对策、ROI 与投入对比，或精益障碍排序

输入

接受的输入：一系列 {障碍, 对策} 对。来源包括（非穷尽）：

来源	映射到障碍	映射到对策
GHQR / 健康检查发现	发现或差距（状态 ≠ 预期）	建议 / 预期值
审计结果	不符合项	整改行动
回顾	“哪里出了问题”项	商定的改进
风险登记册	风险	缓解措施
架构评审	与目标状态的差距	拟议变更
用户自由形式的列表	问题陈述	拟议修复

规则：

• 每个障碍对应一个对策。如果输入暗示了多条整改路径，请选择主要路径，并在理由中注明替代方案 —— 不要为同一障碍发出多行。
• 在评分前合并重复项。
• 如果有来源链接 / 引用可用，请将其附加到对策上。
• 如果来源上有置信度级别可用，请将其作为可选的 置信度 列呈现。

评分标准（1–10 分制）

根据全部四项标准对每个障碍的对策进行评分。请参阅 references/scoring-rubric.md，了解跨多个领域（平台工程、安全、SRE、应用开发、治理）在 1 / 5 / 10 级别上的锚定示例。

标准	分值范围	定义
投资回报率（ROI）	1 = 低，10 = 高	对策为该步骤以及整体价值流带来的效率提升。不纯粹是财务性的 —— 还要权衡吞吐量、周期时间缩短、缺陷消除、用户 / 开发者体验以及合规性提升。
实施成本	1 = 便宜，10 = 非常昂贵	人力资本（所需人员的薪资 + 时间）加上实施该对策所需的任何采购、许可或基础设施。
部署难易度	1 = 极其困难，10 = 非常容易	端到端实际部署该对策所需的整改工作量。反映技术复杂度、变更管理负担以及回滚风险。
风险因子	1 = 低风险，10 = 极高风险	如果对策失败、停滞或被推迟，对整体价值流影响加权的风险。

每个分数都必须附有一行理由。当分数是估算而非来自明确数据时，请在理由中标记 (estimated)。

公式

Priority = ((ROI * (10 / Cost)) + (Ease * (10 / Risk))) / 2

• 理论范围：1 → 100。典型待办事项上的实际范围：约 1 → 100。
• 分值范围的下限 1 保证成本与风险永远不为零（不会出现除以零）。
• 优先级越高 = 越先执行。
• 边界检查：
  • ROI=10, Cost=1, Ease=10, Risk=1 → ((10*10)+(10*10))/2 = 100
  • ROI=1, Cost=10, Ease=1, Risk=10 → ((1*1)+(1*1))/2 = 1

严格按公式使用。不要重新加权、归一化或替换。

方法（Agent 流程）

1. 录入障碍清单。确认障碍与对策一一对应；合并重复项。
2. 确认对策：为每个障碍确认对策。优先采用该领域有文档记录的最佳实践。若有公开 / 权威链接，请引用。
3. 评分：使用评分标准对所有四项标准评分。为每项标准写一行理由。
4. 计算：使用公式计算 Priority。四舍五入到一位小数。
5. 排序：按 Priority 降序排列各行。从 1 开始分配 Rank。
6. 渲染输出表格（见下文）。
7. 特别说明排名前 3 的障碍，并附一段简短的“为何优先处理”说明。
8. 可选标签：如果工作流需要所有权标记（例如 GHQR/PAK 的 [CSA Action Required] 与 [Customer Self-Service]，或内部待办事项的 [Owner: Team X] / [Self-Service]），请将其包含在排名最高的条目上。若未要求则跳过。

输出模板

## Prioritized Impediments

**Scoring:** ROI (1 low → 10 high), Cost (1 cheap → 10 expensive), Ease (1 hard → 10 easy), Risk (1 low → 10 high).
**Formula:** `Priority = ((ROI * (10/Cost)) + (Ease * (10/Risk))) / 2`

| Rank | Impediment | Countermeasure | ROI | Cost | Ease | Risk | Priority | Rationale |
|------|------------|----------------|-----|------|------|------|----------|-----------|
| 1 | [gap] | [action + link] | [n] | [n] | [n] | [n] | [n.n] | ROI: …<br>Cost: …<br>Ease: …<br>Risk: … |

### Top 3 — Act First
1. **[Impediment]** — [why it wins on the formula + optional ownership tag]
2. …
3. …

示例（GitHub Enterprise 采用）：

Rank	Impediment	Countermeasure	ROI	Cost	Ease	Risk	Priority	Rationale
1	组织级别未强制 2FA	在整个组织范围强制 2FA（文档）	9	2	8	2	42.5	ROI：消除广泛的凭据泄露风险类别 Cost：管理员开关 + 成员沟通 Ease：单个组织设置，成员重新注册 Risk：低——可通过宽限期分阶段实施
2	密钥扫描已禁用	在整个组织范围启用密钥扫描 + 推送保护（文档）	8	3	7	3	25.0	ROI：在合并前捕获泄露的凭据 Cost：若未捆绑则需 GHAS 席位（估算） Ease：组织级默认设置 Risk：推送保护可能阻止合法提交；按仓库分阶段实施
3	关键仓库没有 CODEOWNERS	为前 20 个仓库添加 CODEOWNERS（文档）	6	4	6	4	15.0	ROI：有针对性的评审覆盖 Cost：团队定义负责人的时间（估算） Ease：文件级变更，但需要负责人认可 Risk：若负责人人数不足，会造成评审瓶颈

示例（通用回顾行动项）：

Rank	Impediment	Countermeasure	ROI	Cost	Ease	Risk	Priority
1	不稳定的测试套件每天阻碍部署	隔离前 10 个不稳定测试 + 添加重试策略	9	2	8	2	42.5
2	支付服务没有值班 runbook	基于最近 3 次事件起草 runbook	7	3	8	2	31.7
3	手动发布说明每次发布耗时 2 小时	通过 CI 从 Conventional Commits 生成	6	4	5	3	15.8

假设与护栏

• 分数是基于评分标准以及任何可用来源 / 引用得出的估算值。请用 (estimated) 明确标记估算理由。
• 绝不要编造上下文（团队规模、预算、工具清单、组织约束）。如需这些信息，请询问用户或将分数标记为估算。
• 最终排名只是建议——在将其纳入执行计划之前，应与责任团队 / 负责人一起评审。
• 默认只读——此技能不执行修复；它生成一份供下游使用的排名列表。

下游集成（可选）

此技能生成的有序表格就是交付物。请将其接入你的工作流所需的任何下游产物（Jira epic、ADR、OKR backlog、事件回顾、健康检查报告等）。此技能不依赖任何同级技能或外部模板。