スキル一覧に戻る

troubleshoot-print-issues

pjt222
更新日 Yesterday
1 閲覧
17
2
17
GitHubで表示
デザインai

について

このスキルは、体系的な症状分析を通じて一般的な3Dプリントの不具合を診断・修正します。FDMおよびSLAプリンターにおける、接着不良、ストリンギング、レイヤーシフト、押し出しエラーなどの問題をカバーします。プリントが途中で失敗した場合、品質不良が発生した場合、または新しい材料やハードウェアによって結果にばらつきが生じた場合にご利用ください。

クイックインストール

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-print-issues

このコマンドをClaude Codeにコピー&ペーストしてスキルをインストールします

ドキュメント

排印之疾

以系統之症析診而修 3D 印之常敗。此術涵 FDM 與 SLA 之最常見之疾:床附不良、拉絲、層偏、翹曲、出料不足、出料過剩、印品之缺。其法在辨症、究本、迭修。

用時

  • 印於首層或中途敗
  • 印成而有缺(拉絲、塊、隙、面粗)
  • 度量有訛(過大過小、翹曲、象足)
  • 層附之疾(裂、分)
  • 支柱毀印或印中支敗
  • 印與切片預覽異
  • 材於各印中表異
  • 新材、新機、或新環致疾

  • failure_description:何敗(首層敗、拉絲、翹曲等)
  • failure_timing:敗於何時(首層、中途、特定高、頂層)
  • material:絲/脂之類、牌、齡、藏狀
  • printer:機型、嘴徑、床質、罩否
  • recent_changes:新材、切片設、機改、境
  • print_history:此模常通乎?此材昔可乎?

第一步:聚敗之症

詳記可察之症:

目察

  • 攝其敗(總、近、特定缺)
  • 記敗位(首層、特定高、頂面)
  • 述缺類:隙、塊、絲、偏、裂

境之數

  • 印時之溫
  • 濕度
  • 風或冷氣襲機
  • 時辰(溫變)

印之參

# Extract from G-code metadata
grep "^;MAXX\|^;MINX\|^;MAXZ" failed_print.gcode  # Print dimensions
grep "^;PRINT_TIME:" failed_print.gcode  # Estimated time
grep "^M104\|^M140" failed_print.gcode | head -5  # Temperatures
grep "^;generated by" failed_print.gcode  # Slicer version

得:症詳述、有圖、有參、有境。

敗則:症不明者,印一校驗(溫塔、拉絲試、benchy)以系察其敗。

第二步:依症類其疾

合所察之症於常敗之模:

診斷參表

可能之因速查優先修
床附不良床污、溫誤、Z 過高拭床、平床清床、Z-offset 下調 0.05mm
拉絲過熱、回抽不足察嘴溫降溫 5°C、增回抽 +0.5mm
層偏帶鬆、過速、相撞察帶之張緊帶、減速 20%
翹曲附差、冷急察角之翹加 brim、罩機、增床溫
出料不足堵、溫低、流誤察出料一致否清嘴、增溫 5°C、校 e-steps
出料過剩流高、e-steps 誤察塊形減流 2-5%、校 e-steps
象足首層擠、床過熱量基寬升 Z-offset +0.05mm、降床溫 5°C
壁有隙壁薄、出不足察壁厚啟薄壁察、增流
層分溫低、冷劣、污察層紋增溫 5-10°C、察濕絲
塊/瘡回抽、coast 設察縫對齊調回抽、啟 coasting
頂面粗頂層少、熨之數實頂層加 2 頂層、啟 ironing
懸垂下垂冷少、過熱察件冷扇增冷、降溫、加支

得:敗已歸 1-3 最可能之類。

敗則:症合多類者,依敗時為先(首層先、中途次、頂面後)。

第三步:行根因之析

究其本,勿止於症:

5 Why 之術

Symptom: Print warping and lifting from bed
Why? → Poor bed adhesion in corners
Why? → Corners cooling faster than center
Why? → Room draft from AC vent
Why? → No enclosure to maintain stable temperature
Why? → ABS requires heated chamber for uniform cooling

Root cause: Material choice (ABS) incompatible with open printer in drafty room

常見根因之類

機械

  • 帶、輪、止轉螺鬆
  • 直線軸承或桿磨/污
  • Z 軸卡或不正
  • 擠輪磨或滑

  • 溫感漂或敗
  • 熱床力/隔不足
  • 件冷不足
  • 境溫變

  • 濕絲(吸水之材)
  • 老/變之材
  • 污絲(塵、油)
  • 材與用不合

  • e-steps 校誤
  • 流率乘誤
  • 切片有訛或側檔誤
  • 韌之加速/jerk 過高

得:根因明,有證(量溫、帶張、目察)。

敗則:根因不明者,用排除之法:修最可能之因,再試,反覆至解。

第四步:施初級之修

行常見之疾之即解:

床附不良

即修

# 1. Clean bed thoroughly
# Glass/PEI: Isopropyl alcohol 90%+
# BuildTak: Warm water and dish soap

# 2. Level bed (paper test at 4 corners + center)
# Paper should drag slightly

# 3. Adjust Z-offset down (squish first layer more)
# Start: -0.05mm increments until lines fuse

# 4. Increase bed temperature +5°C

# 5. Add adhesion aid:
# - Glue stick (PLA/PETG)
# - Hairspray (ABS)
# - ABS juice (ABS) - ABS dissolved in acetone
# - Magigoo/3D printing adhesive

切片設

  • 首層高:0.2-0.3mm(厚則擠佳)
  • 首層速:20mm/s(緩則附佳)
  • 加 brim:8-10mm 為小底之件
  • 加 raft:為極難之材(TPU、Nylon)

得:首層全附,無翹。

敗則:以隙規或網平察床平度;床翹者需玻/PEI 板或網補。

拉絲

先溫之法

1. Print temperature tower (180-220°C in 5° steps for PLA)
2. Identify lowest temperature that extrudes cleanly
3. Use that temperature -5°C to minimize stringing

回抽之調

# Direct drive extruder:
retraction_distance: 1.0-2.0mm
retraction_speed: 40-50mm/s

# Bowden extruder:
retraction_distance: 4.0-6.0mm
retraction_speed: 40-60mm/s

# If stringing persists:
- Enable z-hop: 0.2-0.4mm (lifts nozzle during travel)
- Reduce travel speed (paradoxically helps)
- Enable combing mode (travels within infill)

得:拉絲微,細絲手可除。

敗則:察嘴半堵或濕絲(皆致溢)。

層偏

機械之察

# 1. Check belt tension (should twang like guitar string)
# Tighten if loose

# 2. Check pulley set screws (motor shafts)
# Must align with flat on motor shaft

# 3. Check for mechanical resistance
# Manually move X/Y axes - should glide smoothly
# Binding indicates dirty rods, worn bearings, or misalignment

# 4. Check stepper motor current (advanced)
# Too low → skipping; too high → overheating

減速

# Reduce these speeds:
perimeter_speed: 40mm/s (from 50)
travel_speed: 120mm/s (from 150)
acceleration: 500mm/s² (from 1000)
jerk: 8mm/s (from 15)

得:再印時,緊帶減速之後,無層偏。

敗則:察切片所生之撞(件冷扇撞模)或電之疾(步進驅過熱)。

翹曲

熱之治

# Increase bed temperature:
PLA: 60°C → 65°C
PETG: 80°C → 85°C
ABS: 100°C → 110°C

# Disable/reduce part cooling:
first_layer_fan: 0%
regular_fan: 25% max (ABS), 50% (PETG), 100% (PLA)

# Enclose printer (critical for ABS/ASA):
- Cardboard box (temporary)
- Acrylic panels (permanent)
- Target chamber temp: 40-50°C

附之強化

  • 加 brim:10-15mm 為角
  • 加「鼠耳」:15mm 徑之圓於利角
  • 模底之邊倒角(45° × 1mm 除應力集中)

得:件平而無角翹。

敗則:材與機本不合(ABS 於無罩之機)——換 PETG 或 ASA。

出料不足

速修

# 1. Check for nozzle clog
# Heat to print temp, manually push filament
# Should extrude smoothly

# 2. Cold pull cleaning (if partial clog)
# Heat to 220°C, push cleaning filament through
# Cool to 90°C, pull sharply - should remove debris

# 3. Increase temperature +5-10°C
# Higher temp = better flow

# 4. Increase flow rate 2-5%
# Slicer: Filament settings → Flow → 102-105%

E-steps 校

# 1. Mark filament 120mm above extruder
# 2. Extrude 100mm: G1 E100 F100
# 3. Measure remaining distance to mark
# 4. Calculate: new_steps = current_steps × (100 / actual_extruded)
# 5. Set: M92 E<new_steps>; M500 (save to EEPROM)

得:出料一致,周或填無隙。

敗則:察熱蠕(冷扇敗)、擠輪磨、或擠臂裂。

出料過剩

減流

# Reduce flow in 2% increments:
extrusion_multiplier: 0.98 → 0.96 → 0.94

# Signs of correct flow:
- Smooth top surface (not overstuffed)
- Perimeters don't bulge outward
- Infill doesn't overfill and push layers apart

度量校

# Print 20mm calibration cube
# Measure with calipers:
# X/Y dimensions should be 20.0mm ± 0.1mm
# If consistently oversized → reduce flow
# If undersized → increase flow

得:度量正、面滑、無凸。

敗則:再校 e-steps(或設過高)。

第五步:以試印驗修

行全印之前,確其解:

試印之擇

  • 附之疾:20mm 方 × 5 層(速首層試)
  • 拉絲:拉絲試模(雙塔有距)
  • 層偏:高瘦之試(壓機械系)
  • 翹曲:大平面(200mm × 200mm × 0.4mm)
  • 出料:20mm 校立方(度量正)

得:試印成,疾解。

敗則:試敗者,疾未全解或多疾並存——再診,專注餘症。

第六步:記其解

錄成之修以備後用:

疾之記模

date: 2026-02-16
issue: "Layer shifts at 50mm height"
symptoms: "X-axis shifts 10mm, happens consistently at same height"
printer: "Ender 3 V2"
material: "PETG, PolyMaker PolyLite"
root_cause: "Loose X-axis belt, pulley set screw not on flat"
solution:
  - "Tightened X-axis belt to 120Hz resonance"
  - "Realigned pulley set screw on motor shaft flat"
  - "Reduced print speed to 40mm/s perimeter"
verification: "Printed 100mm test cylinder - no shifts"
notes: "Check belt tension monthly, pulley tends to slip"

得:疾已記,根因與解皆入庫。

敗則:雖未成之嘗試亦宜記,免重蹈敗解。

  • 敗症已記,有圖有具察
  • 疾以參表分類
  • 根因明(機、熱、材、設)
  • 依根因類施合修
  • 全印之前以試印驗修
  • 解已入記,含日、因、解
  • 境因已錄(溫、濕、風)
  • 材狀已察(乾、無污、藏正)

  1. 多變並改:每次調一參;否則不知何修之(或何敗之)
  2. 忽濕絲:吸水之材(Nylon、TPU、PETG)受濕致泡、絲、附差——常先疑濕絲
  3. 略機械之察:帶鬆、件磨之疾,切片無論何調皆不能修
  4. 取網之溫:每機材之合皆異——必自行溫塔
  5. 帶過緊:過緊則軸承早磨;目標如琴弦,非鋼索
  6. 罪切片:切片之訛少;95% 之疾屬機、熱、材
  7. 不清嘴:半堵致斷續出料不足,似流或 e-step 之疾
  8. 假床平:床久而翹、簧壓、調滑——每週重平以保穩
  9. Z-offset 誤:首層之敗多為 Z-offset 過高(擠不足)或過低(嘴刮床)
  10. 境之忽:ABS/ASA 於 15°C 風車庫永不能良印——材需穩暖之境

  • prepare-print-model:確模備正以免印之疾
  • select-print-material:擇與機與境合之材
  • 校 3D 印機(後出之術):E-steps、流率、溫塔、PID 調、床網平
  • 守 3D 印機(後出之術):帶張、軸承潤、嘴換、預修

GitHub リポジトリ

pjt222/agent-almanac
パス: i18n/wenyan/skills/troubleshoot-print-issues
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

関連スキル

executing-plans

デザイン

executing-plansスキルは、完全な実装計画があり、それを管理されたバッチでレビューチェックポイントを設けながら実行する場合に使用します。このスキルは計画を読み込んで批判的にレビューした後、小さなバッチ(デフォルトは3タスク)でタスクを実行し、各バッチの間に進捗状況を報告してアーキテクトのレビューを受けます。これにより、品質管理チェックポイントが組み込まれた体系的な実装が保証されます。

スキルを見る

requesting-code-review

デザイン

このスキルは、コードレビュアーサブエージェントを起動し、処理を進める前に要件に対してコード変更を分析します。タスク完了後、主要な機能の実装後、またはmainブランチへのマージ前などに使用すべきです。このレビューは、現在の実装と元の計画を比較することで、問題を早期に発見するのに役立ちます。

スキルを見る

connect-mcp-server

デザイン

このスキルは、開発者がHTTP、stdio、またはSSEトランスポートを使用してMCPサーバーをClaude Codeに接続するための包括的なガイドを提供します。GitHub、Notion、カスタムAPIなどの外部サービスを統合するためのインストール、設定、認証、セキュリティについて解説しています。MCP統合のセットアップ、外部ツールの設定、またはClaudeのModel Context Protocolを扱う際にご利用ください。

スキルを見る

web-cli-teleport

デザイン

このスキルは、タスク分析に基づいて開発者がClaude Code WebとCLIインターフェースの選択を支援し、これらの環境間でのシームレスなセッションテレポーテーションを可能にします。Web、CLI、モバイル環境を切り替える際のセッション状態とコンテキストを管理することで、ワークフローを最適化します。様々な段階で異なるツールを必要とする複雑なプロジェクトにご活用ください。

スキルを見る