mcpField
G
gap-analysis

gap-analysis

github.com/magnus919生产力15754 次安装今天更新
代码仓库

关于 gap-analysis

gap-analysis 是一种技能,用于将可观察的现状与有依据的目标进行比较,并把差异转化为经审阅的行动计划。它适用于评估能力、流程、就绪度、控制措施或研究证据,并明确呈现证据、不确定性、责任归属与权衡。

主要功能

  1. 01界定范围与决策标准
  2. 02区分证据、假设和不确定性
  3. 03比较当前状态与目标状态
  4. 04透明地确定差距优先级
  5. 05制定含负责人和闭环测试的行动

适用场景

  1. 01评估流程或运营模式差异
  2. 02审查合规或就绪度证据
  3. 03将能力差距转化为有负责人的行动

安装

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

$npx skills add https://github.com/magnus919/agent-skills --skill gap-analysis

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

包含的文件

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

README.md
evals/
evals.json
references/
examples-and-anti-patterns.md
methodology.md
prioritization-and-roadmaps.md
source-index.md
variants.md
scripts/
validate-register.py
templates/
capability-assessment.md
compliance-readiness-assessment.md
gap-register.md
process-gap-analysis.md
research-evidence-gap.md

详细介绍

差距分析

概述

差距分析是一种决策方法,而不是评分表:明确一个范围有限的问题,确定可观察的当前状态,为期望状态提供依据,对二者进行比较,说明差异存在的原因,并决定采取什么行动。可信的结果会清晰呈现证据、假设、不确定性、责任归属和权衡取舍。

适用场景

当工作需要比较当前与期望的绩效、能力、控制措施、流程表现、准备情况、成熟度、运营模式或研究证据,并产出可执行的成果时,使用此技能。根据 references/variants.md 选择相应变体。

不适用场景

不要将此方法用作根因分析、风险评估、SWOT 分析、基准比较、需求规格说明、监管/法律意见或审计/认证结论的替代品。技术容量问题应交由 capacity-and-cost-engineering 处理,治理问题应交由 ai-governance 处理,因果诊断应交由 systematic-debugging 或相关领域负责人处理。差距分析可能会揭示对这些专业工作的需求,但不能取代它们。

核心方法

  1. 明确决策框架。 说明决策或目标、发起人、适用对象/系统、时间范围、边界、排除项,以及结果的使用者。
  2. 定义评判标准。 让目标可观察,并以需求、结果、基准、风险偏好、战略或明确标注的利益相关者偏好为依据。不要自行编造成熟度量表,也不要暗示框架等级是普遍适用的目标。
  3. 明确证据要求。 对每个维度,在收集数据前定义测量指标、单位、周期、来源、抽样方法、置信度和验收规则。区分观察到的事实、报告的看法、推断的原因和假设。
  4. 描述当前状态。 使用多种相关证据类型:记录/指标、直接观察、访谈、文档、测试或研究综述。记录缺失或相互矛盾的证据,不要用自信的判断填补空白。
  5. 同类相比。 对每个维度,展示当前值、目标值、差异、证据、置信度和后果。差距是范围明确的差异,而不只是糟糕的感觉或缺少某种偏好的做法。
  6. 界定差距类型。 区分结果差距、能力/控制差距、流程差距、资源差距、知识/证据差距,以及决策/责任归属差距。将根因和拟议补救措施与观察到的差距分开。
  7. 透明地确定优先级。 根据决策选择合适的标准,例如影响、紧迫性/风险暴露、影响范围、可行性、依赖关系、成本、置信度和可逆性。说明理由,不要把价值判断隐藏在评分中。
  8. 制定弥合计划。 将选定的差距转化为行动,并明确可衡量的弥合条件、负责人、依赖关系、资源、日期或复审触发条件,以及剩余风险。指定一位负有最终责任的决策者,而不是笼统地写“团队”。
  9. 验证并复审。 与受影响的利益相关者审查调查结果,检验后果重大的主张,解决实质性矛盾,并安排后续测量。只有证据表明目标条件已满足,才算弥合差距;仅仅开始采取行动并不算完成。

必需的输出结构

使用 templates/gap-register.md 作为标准行结构,然后只添加所需的上下文材料:

上下文添加内容
能力或成熟度templates/capability-assessment.md
流程或运营模式templates/process-gap-analysis.md
合规或准备情况templates/compliance-readiness-assessment.md
研究或证据templates/research-evidence-gap.md

一份实用报告通常包括:执行决策、范围与方法、目标/标准登记表、当前状态证据、差距登记表、优先级逻辑、行动路线图、假设/未知事项、利益相关者审查和后续测量。假设示例应明确标注为假设。

质量门槛

交付前,请确认每个重要差距都具备:(a)明确的目标和来源;(b)当前证据或明确说明的证据缺口;(c)明确的比较结果及其影响;(d)与事实区分开来的原因假设;(e)负责人和闭环测试;以及(f)优先级依据。检查报告是否在缺乏必要证据的情况下声称符合要求、已做好准备、存在因果关系或有所改进。

参考资料索引

在以下情况下加载此文件……参考资料
需要基于研究的方法、证据分类或来源限制references/methodology.md
需要在能力、流程、合规性、准备度、成熟度或研究变体之间进行选择references/variants.md
需要优先级排序、评分、顺序安排或闭环控制references/prioritization-and-roadmaps.md
需要示例、反模式或审查问题references/examples-and-anti-patterns.md
需要了解此技能背后的来源出处和主张references/source-index.md
需要对已完成的 JSON 登记表进行结构化检查scripts/validate-register.py

完成

当决策问题已通过经过审查、可追溯的产物得到回答时,即可停止;否则,请报告有明确范围的未解决证据问题及下一步收集行动。不要把缺失数据转换成绿色评分,也不要在与决策相关的不确定性已经明确后继续研究。

评论

支持 Markdown