AgentSkillsCN

python-script

通过全面的日志记录与安全检查，打造稳健的 Python 自动化方案。当任务需要进行复杂的数据处理、调用经过身份验证的 API、执行条件性文件操作，或实现超越简单 Shell 命令的错误处理时，可优先选用此方案。

SKILL.md
--- frontmatter
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

  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