返回技能列表

troubleshoot-separation

pjt222
更新于 2 days ago
6 次查看
17
2
17
在 GitHub 上查看
文档word

关于

This Claude Skill provides a systematic troubleshooting guide for diagnosing and resolving chromatographic separation issues in GC and HPLC systems. It helps users document symptoms, identify root causes of peak shape and retention anomalies, and evaluate matrix effects. The skill implements targeted fixes using a controlled, one-variable-at-a-time approach for verified corrective actions.

快速安装

Claude Code

推荐
主要方式
npx skills add pjt222/agent-almanac -a claude-code
插件命令备选方式
/plugin add https://github.com/pjt222/agent-almanac
Git 克隆备选方式
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/troubleshoot-separation

在 Claude Code 中复制并粘贴此命令以安装该技能

技能文档

Troubleshoot Chromatographic Separation

Systematic diagnosis, resolution of GC, HPLC separation problems. Cover symptom documentation, peak shape diagnosis, retention anomaly investigation, matrix effect evaluation, verified corrective action via controlled single-variable changes.

When Use

  • Peaks tail, front, split, or broader than expected
  • Retention times shifted or irreproducible
  • Resolution between critical pairs degraded
  • Baseline drift, ghost peaks, negative peaks appeared
  • Sensitivity dropped or signal-to-noise worsened
  • Method that worked now fails system suitability

Inputs

Required

  • Problem chromatogram: Current data showing issue
  • Reference chromatogram: Recent good chromatogram from same method for comparison
  • Method conditions: Column, mobile phase/carrier gas, temp/gradient, detector, flow rate
  • System log: Recent maintenance, column changes, mobile phase preparations, instrument events

Optional

  • Blank chromatogram: Most recent blank or solvent injection
  • System suitability trend data: Historical values for tailing, resolution, plates, retention time
  • Column history: Number of injections, types of samples, age of column
  • Instrument maintenance log: Pump seal replacements, lamp hours, detector service dates

Steps

Step 1: Document Problem

  1. Describe symptom precise — which peaks affected, how differ from reference
  2. Determine when problem started — gradual degradation or sudden onset
  3. Record whether problem affects all peaks or only specific ones
  4. Note whether problem present in standards, samples, or both
  5. Collect current system suitability data, compare to historical trends
  6. Photograph or export problem chromatogram alongside reference for side-by-side comparison

Got: Documented problem statement with timeline, scope (all peaks vs. specific peaks, standards vs. samples), comparison to reference data.

If fail: No reference chromatogram? Inject fresh standard preparation under documented method conditions. Establish current baseline before troubleshooting.

Step 2: Diagnose Peak Shape Issues

Use symptom table to identify likely root causes.

SymptomPossible CausesSolutions
Tailing (T > 1.5)Secondary interactions (silanol activity), dead volume in fittings, contaminated column frit, overloaded active sitesAdd amine modifier (HPLC), deactivate liner (GC), replace frit, trim column inlet, reduce injection mass
Fronting (T < 0.8)Column overload (mass or volume), mismatch between sample solvent and mobile phase strengthReduce injection volume or concentration, dilute in weaker solvent, use larger-bore column
Split / double peaksPartially blocked frit, void at column head, two polymorphic forms, isomeric interconversionReplace frit, repack column head, verify sample stability, adjust pH to lock one form
Broad peaks (all)Extra-column band broadening, wrong tubing ID, large detector cell, old column, low plate countMinimize post-column tubing length and ID, check connections, replace column
Broad peaks (early eluters)Poor focusing at column head, injection solvent too strong (HPLC), cold on-column (GC)Use weaker injection solvent, reduce injection volume, increase initial oven temp
Broad peaks (late eluters)On-column diffusion, temperature too low (GC), insufficient gradient steepness (HPLC)Increase final oven temperature, steepen gradient, add organic wash
Negative peaksSample solvent refractive index/absorbance differs from mobile phase, vacancy peaks (IEX)Match sample solvent to mobile phase, use different detection wavelength
Ghost peaksCarryover from previous injection, contaminated mobile phase, column bleed, septum bleed (GC)Run blank to confirm, clean or replace injection system, filter/degas mobile phase, replace septum
Baseline drift (upward)Column bleed (GC at high temp), gradient elution baseline shift (HPLC), lamp instability (UV)Reduce max temp, use low-bleed column (GC), run blank gradient to characterize (HPLC), replace lamp
Baseline noise (high-frequency)Electrical interference, pump pulsation, air bubbles in detector, contaminated detectorGround instrument, replace pump seals, degas mobile phase, clean detector cell
  1. Match observed symptom(s) to table above
  2. Narrow list of causes — check whether problem affects all peaks or specific ones, whether appeared sudden or gradual
  3. Prioritize most likely cause based on system history (recent changes, column age, maintenance status)

Got: One or two most-likely root causes identified from symptom-cause mapping. Prioritized by system history.

If fail: Symptom matches no row, or multiple symptoms simultaneous? Problem may be compound (e.g., column degradation plus leak). Address most obvious issue first. Re-evaluate.

Step 3: Diagnose Retention Time Issues

SymptomPossible CausesSolutions
All peaks shifted earlierIncreased flow rate, higher column temperature, stronger mobile phase, column voidCheck flow rate setting and actual delivery, verify temperature, remake mobile phase, inspect column
All peaks shifted laterDecreased flow rate, lower column temperature, weaker mobile phase, partially blocked tubingCheck for leaks (pressure drop), verify temperature, remake mobile phase, check inline filter
Retention time drift (gradual)Column degradation, mobile phase evaporation (open reservoir), temperature fluctuationReplace column, seal reservoir, stabilize oven, use column thermostat
Retention time irreproducibleLeak at fitting, check valve malfunction, autosampler timing error, inadequate re-equilibrationPressure-test fittings, replace check valves, verify autosampler, increase equilibration volume
Lost retention (k' near 0)Phase collapse (RP at high aqueous), column dewetting, wrong mobile phase, reversed connectionsUse polar-embedded or AQ-type column, re-wet column with organic, verify mobile phase, check plumbing
Co-elution (previously resolved)Column selectivity lost (bonded phase stripped), mobile phase composition changed, temperature changedReplace column, verify mobile phase preparation, check temperature setpoint vs. actual
  1. Determine whether retention shifts uniform (all peaks) or selective (specific peaks)
  2. Uniform shifts → systematic causes (flow, temp, mobile phase composition)
  3. Selective shifts → column chemistry changes or specific analyte-related issues
  4. Check instrument pressure trace — sudden pressure changes indicate leaks or blockages
  5. Re-inject reference standard to confirm whether issue in system or sample

Got: Root cause of retention anomaly identified, categorized as systematic (instrument/mobile phase) or column-related.

If fail: Re-inject standard on new column resolves issue? Original column the problem. Issue persists on new column? Cause upstream (mobile phase, instrument, method parameters).

Step 4: Evaluate Matrix Effects

  1. Compare standard chromatogram to sample chromatogram:
    • Additional peaks in sample absent in standard?
    • Baseline elevated or noisy in specific retention windows?
    • Analyte peak shapes different in sample vs. standard (broader, tailing more)?
  2. For LC-MS — evaluate ion suppression/enhancement:
    • Post-column infusion test — infuse analyte continuous while inject blank matrix extract. Dips in analyte signal indicate ion suppression regions
    • Analyte retention time coincides with suppression region? Modify method to shift analyte elution
  3. Check column contamination:
    • Inject solvent blanks after sample sequence. Persistent peaks indicate column contamination
    • Flush column with strong solvent (100% organic for RP, or as recommended by column manufacturer)
  4. Assess sample preparation:
    • Dirty injector (autosampler needle, injection port liner in GC) — replace or clean
    • Insufficient sample cleanup — add filtration, SPE, or protein precipitation step
  5. For GC — check non-volatile residue buildup in inlet liner. Causes peak tailing, ghost peaks over time.

Got: Matrix effects characterized (presence/absence of interferents, ion suppression zones for LC-MS, column contamination status). Actionable recommendations.

If fail: Matrix effects can't be characterized adequately with available data? Prepare matrix-matched calibration curve. Compare slopes to solvent calibration curve. Slope difference > 15% indicates significant matrix effects requiring method modification.

Step 5: Implement and Verify Fix

  1. Change one variable at a time. Document what changed and why
  2. After each change, re-inject system suitability standard. Compare to reference chromatogram
  3. Sequence of changes (least to most disruptive):
    • Prepare fresh mobile phase / carrier gas tank
    • Replace consumables (septum, liner, frit, inline filter, lamp)
    • Tighten or replace fittings, tubing
    • Flush/regenerate column
    • Adjust method parameters (temp, flow, gradient, pH)
    • Replace column
    • Service instrument (pump seals, check valves, detector)
  4. Once fix identified, run full system suitability test (n >= 5 injections)
  5. Compare all parameters (retention time, area, resolution, tailing, plates) to historical specification
  6. Document root cause, corrective action, verification results in instrument/column logbook
  7. Same problem recurs? Establish preventive maintenance schedule. Address root cause proactive

Got: Problem resolved. System suitability parameters restored to specification. Root cause, corrective action, verification documented.

If fail: All single-variable changes fail to resolve issue? Problem may involve multiple simultaneous failures. Replace all consumables and column together. Verify with fresh standard. Rebuild troubleshooting from new baseline. Problem persists after total consumable replacement? Escalate to instrument service.

Checks

  • Problem documented with symptom description, timeline, scope
  • Root cause identified using symptom-cause mapping tables
  • One variable changed at a time during troubleshooting
  • Fix verified by system suitability test (n >= 5 replicate injections)
  • All system suitability parameters restored to within specification
  • Root cause, corrective action documented in logbook
  • Preventive measure identified to avoid recurrence

Pitfalls

  • Change multiple variables simultaneous: Makes impossible to identify actual root cause. Always change one thing, test, then decide whether to change another
  • Replace column as first step: Column replacement expensive. May mask real problem (leak, wrong mobile phase, contaminated inlet). Exhaust simpler possibilities first
  • Ignore instrument logbook: Many problems trace back to recent maintenance event, mobile phase batch change, column swap. Always check what changed recent
  • Blame sample without evidence: Run reference standard first. Standard also shows problem? Issue in system, not sample
  • Flush column with incompatible solvents: Never flush reversed-phase column with pure water (causes phase collapse) or silica HILIC column with pure aqueous buffer (irreversible damage). Follow manufacturer washing protocol
  • No document what tried: Failed troubleshooting attempts valuable info. Record every change attempted, outcome. Avoid repeat unsuccessful fixes. Build institutional knowledge

See Also

  • interpret-chromatogram -- understanding chromatographic data that reveals separation problems
  • develop-gc-method -- GC method development. Relevant when troubleshooting needs method redesign
  • develop-hplc-method -- HPLC method development. Relevant when troubleshooting needs method redesign
  • validate-analytical-method -- re-validation may be required after significant method changes during troubleshooting

GitHub 仓库

pjt222/agent-almanac
路径: i18n/caveman/skills/troubleshoot-separation
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

相关推荐技能

railway-docs

文档

Railway Docs Skill可实时获取最新的Railway官方文档,确保回答的准确性。当开发者询问Railway功能特性、工作原理或分享docs.railway.com链接时,应优先使用此技能。它通过专门的LLM优化文档源提供最新信息,避免依赖过时记忆来回答技术问题。

查看技能

n8n-code-python

文档

该Skill为在n8n平台的Python代码节点中编写代码提供专家指导,特别适用于需要使用_input/_json/_node语法、Python标准库或了解n8n中Python限制的场景。它强调JavaScript应作为首选方案,仅当需要特定Python功能或对Python语法更熟悉时才使用Python。Skill提供了快速入门模板和关键注意事项,帮助开发者在n8n中高效编写Python代码。

查看技能

archon

文档

Archon Skill为开发者提供了基于RAG的语义搜索和项目任务管理功能,可通过REST API访问知识库。它支持文档搜索、网站爬取、文件上传和版本控制,适用于技术文档查询和项目管理场景。首次使用时需要配置Archon主机地址,建议在处理外部文档时优先使用该Skill。

查看技能

n8n-code-javascript

文档

这个Skill为n8n工作流中的JavaScript代码节点提供专业指导,涵盖数据处理、HTTP请求和日期操作等核心场景。它详细解释了如何正确使用n8n特有的`$input`/`$json`语法、`$helpers`工具以及DateTime对象,并包含关键的错误排查和模式选择建议。开发者通过该Skill能快速掌握Code节点的正确返回格式、数据访问方法和常见陷阱解决方案。

查看技能