tooluniverse-primer-design について
PCRおよびqPCR用プライマーとオリゴを設計・評価するToolUniverseスキルです。融解温度とアニーリング温度を計算し、配列特性を検査しますが、ゲノム特異性は確認しません。
主な機能
- 01フォワード・リバースプライマーの設計
- 02プライマーのTmとTaの計算
- 03ヘアピンとダイマーのスクリーニング
- 04GC含量とペア設計基準の確認
- 05プライマーペアのローカルQC
活用シーン
- 01標的DNA領域のプライマー設計
- 02選択したプライマーのサイクル条件決定
- 03発注前の既存プライマーペアの確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mims-harvard/ tooluniverse --skill tooluniverse-primer-designインストール後、Claude Code で/tooluniverse-primer-designを入力して読み込まれたか確認します。
同梱ファイルscripts/primer_qc.pytest_primer_qc.py
詳細
PCR / qPCR プライマー&オリゴ設計
標的 DNA 領域のプライマーを設計し、Tm/Ta を取得して、PCR の失敗につながる二次構造の問題がないか QC します。
どのような場合に使うか
- 配列の領域を増幅するためのフォワード/リバースプライマーペアを設計します。
- プライマーの Tm/アニーリング温度を計算します。
- 既存のプライマーペアを QC します(GC クランプ、3′末端、ヘアピン、自己/交差ダイマー、Tm の一致)。
ステップ 1 — プライマーペアを設計する
tu run DNA_primer_design '{"operation":"primer_design",
"sequence":"ATGGCG...AACGTG", # full template; must be >= target_end + flanking primer room
"target_start":40, "target_end":125,
"tm_target":60, "product_size_min":80, "product_size_max":140}'
forward_primer/reverse_primer(配列、tm、gc_content、length、position)と product_size を返します。(target_end は配列長に合わせて調整されるため、テンプレートが短すぎると、指定した標的領域は通知なく縮小されます。下記の制約に関する注意点を参照してください。)
制約に関する注意点 — エラーを避けるため、必ずお読みください。
target_start..target_endはアンプリコンがカバーしなければならない領域であり、その範囲がプロダクトサイズの範囲内に収まり、かつ適切な Tm のプライマーを両側に配置できる場合にのみ設計が成功します。つまり、概ね次の条件が必要です:product_size_min ≤ (target span) ≤ product ≤ product_size_max。また、両側に十分なフランキング配列が必要です。よくあるエラーと対処法:
- 「Target region (N bp) is smaller than product_size_min」 → 標的領域が
product_size_minより狭すぎます。product_size_minを下げるか、標的領域を広げてください。- 「product does not cover the target / does not span」 → 標的領域が
product_size_maxに対して広すぎるか、配列の末端に近すぎます。product_size_maxを広げるか、フランキング配列を増やしてください。
ステップ 2 — 特定のプライマーの Tm/アニーリング温度を取得する
tu run NEB_Tm_calculate '{"primer_sequence":"CTACCTGAAGAACCTGAG",
"primer_sequence_2":"CTTGATGTCCTCCAGCAT",
"polymerase":"Q5", "primer_concentration":500, "monovalent_salt_mm":50}'
NEB は各プライマーの Tm と、選択したポリメラーゼに推奨される**アニーリング温度(Ta)**を返します。IDT_analyze_oligo(配列、塩/Mg/dNTP/オリゴ濃度)では、GC%、分子量に加えて、ヘアピン/自己ダイマーのスクリーニングも行います。DNA_calculate_gc_content は手軽に GC を確認できます。
Tm は計算方法と条件によって異なります。 SantaLucia NN(設計ツール)、NEB、IDT では異なるパラメーターセットを使用しており、Tm は一価塩、Mg²⁺、プライマー/dNTP の濃度によって変化します。実験全体を通じて、計算ツールと条件セットを一つ選んで使用してください。SantaLucia の Tm と IDT の Tm を比較してはいけません。条件は必ず明記してください。
ステップ 3 — プライマー設計のルール(「良好な設計」の目安)
| 特性 | 目標 | 理由 |
|---|---|---|
| 長さ | 18–24 nt | 特異性を得られる長さを確保しつつ、効率的にアニーリングできる短さにします |
| Tm | 58–62 °C | 標準的なサイクリング条件で使用でき、ペア間の差を約 2–3 °C 以内に保ちます |
| ΔTm(フォワードとリバースの差) | < 3 °C(絶対最大値 ≤5) | Tm の不一致により、一方のプライマーのアニーリングが不十分になります |
| GC 含量 | 40–60 % | 安定性のバランスを保ちます |
| GC クランプ | 3′末端の最後の 3 nt に G/C を 1–2 個 | 3′末端のプライミングを安定させます。G/C が 3 個を超えると誤プライミングのリスクがあります |
| 3′末端 | ペア内およびプライマー内での 3′相補性を避けます | プライマーダイマーを防ぎます |
| 連続塩基/反復配列 | 同一塩基が 4 個以上連続する配列と、二塩基反復を避けます | スリッページ/誤プライミングを減らします |
| アニーリング温度(Ta) | 約 Tm − 3~−5 °C(ポリメラーゼの計算ツールを使用) | 特異性と収量のバランスを取ります |
| アンプリコン(qPCR) | 70–150 bp | 効率的な増幅を実現します |
scripts/primer_qc.py は、これらのルール(GC クランプ、3′末端の自己/交差相補性、連続塩基、GC%、長さ、Wallace/NN Tm、Tm の一致)に照らしてプライマーペアを確認し、問題を示します。出所を問わず、プライマーの QC に使用してください。
ステップ 4 — 特異性(ツールでは確認できません)
Tm と構造は必要ですが、それだけでは十分ではありません。熱力学的に完璧なプライマーでも、誤った遺伝子座を増幅することがあります。これらのツールではゲノム特異性を確認できません。必ず各プライマーを標的ゲノムに対して BLAST(または Primer-BLAST を使用)し、注文前に意図した単一の産物だけが得られることを確認してください。推奨事項には、この点を必ず明記してください。
ステップ 5 — よくある落とし穴
- 特異性を忘れる(ステップ 4)—「よく設計された」プライマーがうまく機能しない最大の原因です。
- ペア間の Tm が一致しない — 設計では一致を目指しますが、手動で選んだペアは一致していないことがよくあります。ΔTm を確認してください。
- 3′ プライマーダイマー — フォワードプライマーとリバースプライマーの間の 3′ 相補性は、典型的なダイマーの原因です。
IDT_analyze_oligo/ QC スクリプトで検出できます。 - Tm の計算方法や条件の混在(ステップ 2)。
- テンプレート内の二次構造(GC 含量の高い領域やヘアピン領域)は、プライマーの設計が適切でもプライミングを妨げることがあります。添加剤を検討するか、ターゲットの位置を変更してください。
正直なところ、限界もあります
- 熱力学的な Tm / 構造予測と、実験での性能は同じではありません。グラジエント PCR で検証してください。
- ゲノム特異性の確認(ステップ 4)と SNP マスキングには対応していません。これらは別途行ってください。
関連スキル
tooluniverse-sequence-analysis— 上流のシーケンス処理(FASTQ、アラインメント、カバレッジ)。tooluniverse-enzyme-kinetics/tooluniverse-dose-response— その他の定量アッセイ解析。