diagnose-problem

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Diagnose a Problem

诊断问题

The goal is an evidence-backed causal explanation, not a list of plausible fixes.
  1. Frame the problem. Record the observed and expected behavior, scope, impact, environment, and when it began. Keep observations separate from interpretations.
  2. Locate the divergence. Gather the smallest relevant evidence and trace the behavior toward the earliest point where reality differs from expectation. Preserve useful inputs, versions, timestamps, and environment details.
  3. Reproduce when safe. Find the smallest faithful check. For intermittent problems, repeat under controlled conditions and vary one factor at a time. If reproduction is not possible, state what the available evidence can and cannot establish.
  4. Test competing explanations. Keep only plausible hypotheses. For each, identify an observation it predicts; choose the next check for its ability to distinguish explanations, and look for evidence that could disprove the leading one.
  5. Establish the causal mechanism. Trace the evidence from symptom to trigger to responsible boundary and mechanism. Challenge the strongest alternative. Do not treat correlation or proximity as proof of cause.
  6. Report the result. State whether the cause is confirmed, likely, or unresolved; give the supporting evidence, material alternatives considered, checks performed, and remaining uncertainty. Include the smallest supported fix and how to verify it. If a fix is requested, use these findings as input to a separate implementation step following the project's conventions; this skill does not require another skill to be installed.
目标是给出有证据支持的因果解释,而不是罗列可能的修复方案。
  1. 界定问题。 记录观察到的行为和预期行为、影响范围、影响程度、环境,以及问题何时开始。将观察事实与解释区分开来。
  2. 定位偏差。 收集最少但相关的证据,并追踪行为,直到找到实际情况与预期出现差异的最早节点。保留有用的输入、版本、时间戳和环境信息。
  3. 在安全的情况下复现。 找到最小且忠实的检查方式。对于间歇性问题,应在受控条件下重复测试,每次只改变一个因素。如果无法复现,请说明现有证据能够和不能证明什么。
  4. 检验相互竞争的解释。 仅保留合理的假设。对于每个假设,确定它所预测的观察结果;选择下一步检查,以区分不同解释,并寻找能够推翻当前主要假设的证据。
  5. 确立因果机制。 将证据从症状追踪到触发因素,再到责任边界和作用机制。质疑最强的替代解释。不要将相关性或时间上的接近性视为因果关系的证明。
  6. 报告结果。 说明原因是已确认、可能性较高还是尚未解决;给出支持证据、已考虑的重要替代解释、已执行的检查以及仍存在的不确定性。包含有证据支持的最小修复方案及其验证方式。如果需要实施修复,请将这些诊断结果作为独立实现步骤的输入,并遵循项目规范;此 skill 不要求安装其他 skill。