04_stack_trace_debug — промпт для Claude Code: разбор Python-трейса
Промпт 04_stack_trace_debug для Claude Code: находит первопричину Python stack trace, называет проблемный вызов и предлагает исправление. Разбирает вставленный traceback.
MIT ★ 2 744 обновлён 2026-10-08
.claude/commands/04_stack_trace_debug.mdЧто делает 04_stack_trace_debug
Промпт направляет Claude Code к первопричине Python-ошибки: нужно назвать её, указать вызов, на котором она возникает, и предложить исправление. Ответ ограничен 200 выходными токенами; предпочтителен один короткий абзац без списков, блоков кода и вступления.
В файле также приведён пример с двумя исключениями: сначала приложение не находит gzip-файл, затем обработчик ошибки получает KeyError по ключу id. Это помогает увидеть, что разбор должен учитывать и исходную ошибку, и исключение при её обработке. Для установки сохраните промпт по пути .claude/commands/04_stack_trace_debug.md; жёсткий лимит ответа означает, что подробное пошаговое объяснение здесь не поместится.
Какие задачи решает
- найти первопричину ошибки в Python traceback
- указать вызов, который привёл к исключению
- предложить исправление по stack trace
- различить исходную ошибку и исключение при её обработке
Примеры запросов агенту
- Разбери этот Python traceback, назови причину ошибки и предложи исправление: [вставь traceback]
- Покажи, какой вызов вызывает исключение, и объясни кратко, как его исправить: [вставь traceback]
Как установить 04_stack_trace_debug
Вручную: положить файлы
.claude/commands/04_stack_trace_debug.mdКак использовать
Вставьте текст в начало диалога или в инструкции проекта
Вопросы о 04_stack_trace_debug
Как установить 04_stack_trace_debug в Claude Code?
Сохраните файл промпта по пути .claude/commands/04_stack_trace_debug.md.
Что делает 04_stack_trace_debug?
Просит Claude Code определить причину Python-ошибки по stack trace, указать проблемный вызов и предложить исправление. Ответ должен уложиться в 200 выходных токенов.
Какой формат ответа задаёт промпт?
Предпочтителен один короткий абзац без списков, блоков кода и вступления. Лимит — 200 выходных токенов.
Исходный текст
04_stack_trace_debug.md · MIT
---
name: stack_trace_debug
content_shape: stack-trace
reference_tokens_per_char: 0.30
description: Diagnose a Python stack trace in at most 200 output tokens (~800 chars).
---
[session-metrics:compare-suite:v2:prompt=stack_trace_debug]
Diagnose the root cause of the Python stack trace below in 200 OUTPUT TOKENS OR FEWER. Prefer one tight paragraph. State the cause, point at the offending call, and suggest the fix. No code blocks, no lists, no preamble.
---
```
Traceback (most recent call last):
File "/app/workers/ingest.py", line 87, in process_batch
for record in batch_iter(file_path, chunk_size=chunk):
File "/app/workers/ingest.py", line 34, in batch_iter
with gzip.open(path, "rt", encoding="utf-8") as fh:
File "/usr/lib/python3.12/gzip.py", line 74, in open
binary_file = GzipFile(filename, gz_mode, compresslevel)
File "/usr/lib/python3.12/gzip.py", line 174, in __init__
fileobj = self.myfileobj = builtins.open(filename, mode or 'rb')
FileNotFoundError: [Errno 2] No such file or directory: '/tmp/ingest/2026-04-19/batch_0042.json.gz'
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
File "/app/workers/ingest.py", line 132, in <module>
main()
File "/app/workers/ingest.py", line 128, in main
process_batch(manifest_entry, chunk_size=CHUNK_SIZE)
File "/app/workers/ingest.py", line 91, in process_batch
metrics.record_failure(manifest_entry["id"])
KeyError: 'id'
```
<!-- PREDICATE -->
````python
def check(text: str) -> bool:
# Approximate the 200-token budget by char length (~4 chars/token).
# Allow a small margin for tokenizer variance.
return 0 < len(text) <= 900
````
© centminmod · MIT · centminmod/my-claude-code-setup