Python工具技能创建器

一个用于快速创建Python CLI工具技能的工具集,支持依赖管理和离线使用。

  • by almcc
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 almcc/python-tool-skill-creator

使用说明

Python工具技能创建者

一组 python工具技能 --再加上创造技能,可以快速构建新的。

什么是python工具技能?

python工具技能是一种技能形式的AI代理工具。它在其 assets/ 目录。CLI是用 点击 并在运行时通过以下方式执行 uvx,所以:

  • 不 venv/,没有 __pycache__,没有 .pyc 文件污染了技能目录
  • 无需管理持久服务器进程(与MCP工具不同)
  • 依赖关系是通过一个已提交的 uv.lock --首次运行后可再现且离线
my-skill/
├── SKILL.md          ← trigger description + agent instructions
└── assets/
    ├── tool.py       ← Click CLI (entry point)
    ├── pyproject.toml
    └── uv.lock

代理通过以下方式运行该工具:

uvx --from /path/to/skill/assets my-skill <command> [options]

此仓库中的技能

f1 --F1日历(原型)

原始原型技能。通过提供F1比赛日历和赛程数据 OpenF1 API.

命令 描述
f1 races 列出当年的所有比赛(或 --year YYYY)
f1 race <round> 显示特定轮次的会话时间表

python-tool-skill-creator --脚手架新技能

元技能:加载它并要求代理构建一个新的python工具技能。它捆绑了一个脚手架脚本和一个参考文档,指导代理完成整个创建工作流程。

它的作用:

  1. 跑 scripts/init_python_tool_skill.py 生成目录骨架
  2. 实现 assets/tool.py 使用请求的Click命令
  3. 更新 assets/pyproject.toml 有依赖关系
  4. 锁定依赖关系 uv lock
  5. 通过以下方式测试工具 uvx
  6. 填写 SKILL.md 具有准确的描述和命令表
# Scaffold a new skill manually
python python-tool-skill-creator/scripts/init_python_tool_skill.py <skill-name> --path <output-dir>

weather --当前状况和预测

由...创建 python-tool-skill-creator.通过提供天气数据 开放气象API -免费,不需要API密钥。

命令 描述
weather current LOCATION 当前温度、条件、湿度和风
weather forecast LOCATION [--days N] 每日预测表(1-16天,默认7天)

回购布局

python-tool-skill-creator/
├── f1/                          ← prototype skill
├── weather/                     ← skill created by the creator skill
└── python-tool-skill-creator/   ← the creator skill itself
    ├── assets/template/         ← tool.py + pyproject.toml templates
    ├── scripts/                 ← init_python_tool_skill.py scaffolder
    ├── references/pattern.md   ← full pattern specification
    └── SKILL.md

创造新技能

具有创作者技能(推荐)

负载 python-tool-skill-creator 作为一种技能和提示:

“为<您的域名>创建python工具技能”

代理将端到端地构建、实施、锁定和测试技能。

手动地

  1. 脚手架 骨架:

    python python-tool-skill-creator/scripts/init_python_tool_skill.py my-skill --path .
    
  2. 实施 my-skill/assets/tool.py 使用您的Click命令。

  3. 添加依赖项 到 my-skill/assets/pyproject.toml 如果需要的话。

  4. 锁:

    cd my-skill/assets && uv lock
    
  5. 测试:

    uvx --from my-skill/assets my-skill --help
    uvx --from my-skill/assets my-skill <command>
    
  6. 填写 my-skill/SKILL.md --the description 字段控制代理何时触发技能。

编辑后 tool.py 或依赖关系,添加 --reinstall 强制uvx重建其缓存:

uvx --from my-skill/assets --reinstall my-skill <command>

Python工具技能与MCP工具

关注 MCP工具 Python工具技能
运行时 持久服务器进程 短暂 uvx 调用
安装 客户端中的服务器配置 uvx --from assets/
环境隔离 用户管理的venv/container uvx管理的,自动
Repo污染 可选 无--无venv,无.pyc
脱机使用 取决于服务器 在首次缓存填充后工作
依赖固定 服务器端 uv.lock 投入技能资产

需求

  • 紫外线 (curl -LsSf https://astral.sh/uv/install.sh | sh)

进一步阅读