| name | python-script |
| description | Create robust Python automation with full logging and safety checks. Use when tasks need complex data processing, authenticated API work, conditional file operations, or error handling beyond simple shell commands. |
Python Scripter
Overview
Design and run Python scripts with clear requirements, safety checks, and reproducible logging.
Workflow
- Confirm inputs, outputs, constraints, and preferred libraries.
- Identify risky operations and secure explicit approval.
- Scaffold a script with PEP 723 metadata and structured logging.
- Lint with
uvx ruff check --fix .agents/scripts/{script_name}.py. - Run with
uv run --script .agents/scripts/{script_name}.pyand monitor logs. - Report results, risks encountered, and any follow-up steps.
Logging requirements
- Log to
.agents/logs/{script_name}.logand stream to console - Capture start/end timestamps, parameters, file operations, and errors
- Add
RotatingFileHandlerif 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