mcpField
P
python-scripting

python-scripting

github.com/89jobrien开发4139 次安装10 周前更新
代码仓库

关于 python-scripting

用于借助 uv 和 PEP 723 内联元数据编写独立 Python 脚本的技能，适合开发者处理自动化、数据处理和命令行任务，并提供参数、输入输出及可复现性方面的指导。

主要功能

  1. 01生成独立 Python 脚本
  2. 02PEP 723 内联依赖
  3. 03argparse 命令行参数
  4. 04处理输入与输出
  5. 05可复现构建指导

适用场景

  1. 01编写一次性自动化脚本
  2. 02用小型工具处理数据
  3. 03创建 Python 命令行工具

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/89jobrien/steve --skill python-scripting

安装后在 Claude Code 中输入/python-scripting确认已加载。

附带文件references/uv-script.template.py

详细介绍

Python 脚本技能

使用 uv 和 PEP 723 内联脚本元数据创建独立的 Python 脚本。

此技能的功能

  • 创建独立的 Python 脚本
  • 使用 PEP 723 内联依赖
  • 设置参数解析
  • 处理输入/输出
  • 配置可复现构建

适用场景

  • 独立实用脚本
  • 一次性自动化任务
  • 快速数据处理
  • CLI 工具
  • 需要依赖项的脚本

参考文件

  • references/UV_SCRIPT.template.py - 带有 PEP 723 元数据的 Python 脚本模板

PEP 723 格式

#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.12"
# dependencies = [
#   "requests",
#   "rich",
# ]
# ///

运行脚本

uv run script.py [args]

依赖项会在首次运行时自动安装。

最佳实践

  • 使用 exclude-newer 确保可复现性
  • 添加包含用法示例的文档字符串
  • 使用 argparse 处理 CLI 参数
  • 返回退出码（0 表示成功，非零表示错误）
  • 让脚本专注于单一任务

评论

支持 Markdown