关于 gap-analysis
gap-analysis 是一种技能,用于将可观察的现状与有依据的目标进行比较,并把差异转化为经审阅的行动计划。它适用于评估能力、流程、就绪度、控制措施或研究证据,并明确呈现证据、不确定性、责任归属与权衡。
主要功能
- 01界定范围与决策标准
- 02区分证据、假设和不确定性
- 03比较当前状态与目标状态
- 04透明地确定差距优先级
- 05制定含负责人和闭环测试的行动
适用场景
- 01评估流程或运营模式差异
- 02审查合规或就绪度证据
- 03将能力差距转化为有负责人的行动
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ magnus919/ agent-skills --skill gap-analysis安装后在 Claude Code 中输入/gap-analysis确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdevals/evals.jsonreferences/examples-and-anti-patterns.mdmethodology.mdprioritization-and-roadmaps.mdsource-index.mdvariants.mdscripts/validate-register.pytemplates/capability-assessment.mdcompliance-readiness-assessment.mdgap-register.mdprocess-gap-analysis.mdresearch-evidence-gap.md详细介绍
差距分析
概述
差距分析是一种决策方法,而不是评分表:明确一个范围有限的问题,确定可观察的当前状态,为期望状态提供依据,对二者进行比较,说明差异存在的原因,并决定采取什么行动。可信的结果会清晰呈现证据、假设、不确定性、责任归属和权衡取舍。
适用场景
当工作需要比较当前与期望的绩效、能力、控制措施、流程表现、准备情况、成熟度、运营模式或研究证据,并产出可执行的成果时,使用此技能。根据 references/variants.md 选择相应变体。
不适用场景
不要将此方法用作根因分析、风险评估、SWOT 分析、基准比较、需求规格说明、监管/法律意见或审计/认证结论的替代品。技术容量问题应交由 capacity-and-cost-engineering 处理,治理问题应交由 ai-governance 处理,因果诊断应交由 systematic-debugging 或相关领域负责人处理。差距分析可能会揭示对这些专业工作的需求,但不能取代它们。
核心方法
- 明确决策框架。 说明决策或目标、发起人、适用对象/系统、时间范围、边界、排除项,以及结果的使用者。
- 定义评判标准。 让目标可观察,并以需求、结果、基准、风险偏好、战略或明确标注的利益相关者偏好为依据。不要自行编造成熟度量表,也不要暗示框架等级是普遍适用的目标。
- 明确证据要求。 对每个维度,在收集数据前定义测量指标、单位、周期、来源、抽样方法、置信度和验收规则。区分观察到的事实、报告的看法、推断的原因和假设。
- 描述当前状态。 使用多种相关证据类型:记录/指标、直接观察、访谈、文档、测试或研究综述。记录缺失或相互矛盾的证据,不要用自信的判断填补空白。
- 同类相比。 对每个维度,展示当前值、目标值、差异、证据、置信度和后果。差距是范围明确的差异,而不只是糟糕的感觉或缺少某种偏好的做法。
- 界定差距类型。 区分结果差距、能力/控制差距、流程差距、资源差距、知识/证据差距,以及决策/责任归属差距。将根因和拟议补救措施与观察到的差距分开。
- 透明地确定优先级。 根据决策选择合适的标准,例如影响、紧迫性/风险暴露、影响范围、可行性、依赖关系、成本、置信度和可逆性。说明理由,不要把价值判断隐藏在评分中。
- 制定弥合计划。 将选定的差距转化为行动,并明确可衡量的弥合条件、负责人、依赖关系、资源、日期或复审触发条件,以及剩余风险。指定一位负有最终责任的决策者,而不是笼统地写“团队”。
- 验证并复审。 与受影响的利益相关者审查调查结果,检验后果重大的主张,解决实质性矛盾,并安排后续测量。只有证据表明目标条件已满足,才算弥合差距;仅仅开始采取行动并不算完成。
必需的输出结构
使用 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 |
完成
当决策问题已通过经过审查、可追溯的产物得到回答时,即可停止;否则,请报告有明确范围的未解决证据问题及下一步收集行动。不要把缺失数据转换成绿色评分,也不要在与决策相关的不确定性已经明确后继续研究。