Finds common Python code smells with the ast module, such as bare except clauses, mutable default arguments, missing docstrings, very long functions and long argument lists. Use when the user asks for a quick review of Python code, a cleanup pass or a pre-commit style check.
日本語の概要は準備中です。原文の説明を表示しています。
実行スコア 未検証
インストール方法を見るインストールする前に、エージェントに与えられる指示の中身を確認できます。
A fast, dependency-free first pass over Python files. It does not replace a linter, it gives an agent concrete line numbers to start a review from.
python scripts/smells.py src/
python scripts/smells.py app.py utils.py --max-lines 40
Directories are searched recursively for .py files. Hidden folders and __pycache__ are skipped.
| Rule | Meaning |
|---|---|
bare-except | except: without an exception type hides real errors |
mutable-default | a list, dict or set used as a default argument value is shared between calls |
missing-docstring | a public function or class (no leading underscore) has no docstring |
long-function | a function is longer than --max-lines (default 50) |
too-many-args | a function takes more than --max-args parameters (default 6) |
syntax-error | the file could not be parsed |
JSON with files (number of files checked) and findings, a list of
{"file", "line", "rule", "message"}. The exit code is 1 when there are findings and 0 otherwise.
Group the findings by rule, fix the bugs first (bare-except, mutable-default), then the readability
items. Do not add docstrings that only repeat the function name.
A path that does not exist exits with code 2.
まだレビューはありません。使ってみた感想をお寄せください。
ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。
まだコメントはありません。最初のコメントを書いてみませんか。
Runs a list of HTTP checks against a base URL from a JSON file and reports status codes, response time and body assertions. Use when the user asks whether an API is up, wants a smoke test after a deploy, or needs to verify that endpoints return what the docs promise.
日本語の概要は準備中です。原文の説明を表示しています。
Turns git log output into a grouped markdown changelog using conventional commit prefixes such as feat, fix and docs. Use when the user prepares a release, asks for release notes, or wants a summary of what changed between two tags.
日本語の概要は準備中です。原文の説明を表示しています。
Writes clear git commit messages in the conventional commits style from a diff or a description of the change. Use when the user asks for a commit message, wants to tidy up a message before pushing, or has staged changes and no wording yet.
日本語の概要は準備中です。原文の説明を表示しています。
Profiles a CSV file column by column, reporting inferred type, missing values, unique counts and min, max and mean for numeric columns. Use when the user hands over a CSV and asks what is in it, whether the data is clean, or what to check before analysis.
日本語の概要は準備中です。原文の説明を表示しています。
Checks a Dockerfile for common problems such as unpinned base images, running as root, ADD instead of COPY, secrets in ENV or ARG and apt-get without cleanup. Use when the user asks to review, harden or slim down a Dockerfile.
日本語の概要は準備中です。原文の説明を表示しています。
Compares a .env file with its .env.example template and reports missing keys, undocumented extra keys, empty values and example files that contain real looking secrets. Use when the user asks why an app fails on startup with missing configuration, or wants to check environment files before committing.
日本語の概要は準備中です。原文の説明を表示しています。