python-script

Python Scripter

Overview

Design and run Python scripts with clear requirements, safety checks, and reproducible logging.

Workflow

1. Confirm inputs, outputs, constraints, and preferred libraries.
2. Identify risky operations and secure explicit approval.
3. Scaffold a script with PEP 723 metadata and structured logging.
4. Lint with uvx ruff check --fix .agents/scripts/{script_name}.py.
5. Run with uv run --script .agents/scripts/{script_name}.py and monitor logs.
6. Report results, risks encountered, and any follow-up steps.

Logging requirements

• Log to .agents/logs/{script_name}.log and stream to console
• Capture start/end timestamps, parameters, file operations, and errors
• Add RotatingFileHandler if logs may grow large

Template

Read references/script-template.md for the full script template.

Safety practices

• Provide dry-run or rollback paths
• Validate external inputs and API responses
• Use temporary directories for intermediates
• Never run destructive steps without confirmation