skills 使用py脚本，如果涉及到第三方包怎么办

## Dependencies

This skill requires the following Python packages:

```bash
pip install pypdf2 pdfplumber pymupdf

然后在执行流程中要求 Agent 先验证：

```markdown
## Execution Flow

1. **Check dependencies**: Run `python -c "import pypdf2"` to verify. If fails, instruct user to install dependencies.
2. Run `scripts/pdf_parser.py <file>`

#!/usr/bin/env python3
"""PDF parser with fallback strategies"""

def parse_pdf(filepath):
    # Try multiple backends
    try:
        import pypdf2
        # use pypdf2
    except ImportError:
        try:
            import pdfplumber
            # use pdfplumber
        except ImportError:
            print("ERROR: No PDF library found. Please run: pip install pypdf2")
            sys.exit(1)

# Dockerfile for Agent runtime
FROM python:3.11-slim

RUN pip install pypdf2 pdfplumber pymupdf pandas openpyxl

# 所有 skills 的脚本共享这个环境
COPY skills/ /skills/

project/
├── skills/
│   └── pdf-skill/
│       ├── SKILL.md
│       ├── scripts/
│       │   └── pdf_parser.py
│       ├── requirements.txt
│       └── .venv/              # 虚拟环境放这里
│           ├── bin/
│           └── lib/

pdf-skill/
├── SKILL.md
├── scripts/
├── requirements.txt
└── .venv/              # 已装好依赖，直接可用
    ├── bin/
    └── lib/python3.11/site-packages/  # 已安装的包

pdf-skill/
├── SKILL.md
├── scripts/
│   └── pdf_parser.py
├── requirements.txt    # 只有依赖列表
└── setup.sh            # 可选：一键安装脚本

## First-time Setup

The virtual environment will be created automatically on first use.

**Detection logic for Agent:**

```bash
SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
VENV_PYTHON="$SKILL_DIR/.venv/bin/python"

if [ ! -f "$VENV_PYTHON" ]; then
    echo "📦 First use: Creating virtual environment..."
    cd "$SKILL_DIR"
    python3 -m venv .venv
    .venv/bin/pip install -r requirements.txt
    echo "✅ Setup complete"
fi

# Now run the script
$VENV_PYTHON scripts/pdf_parser.py "$@"

### Agent 执行时的实际流程

当用户说"帮我解析这个 PDF"：

1. Agent 加载 `pdf-skill` 的 `SKILL.md`
2. 读取到上面的检测逻辑
3. 检查 `.venv/bin/python` 是否存在
4. **首次运行**：
   ```bash
   cd /path/to/skills/pdf-skill
   python3 -m venv .venv              # 创建虚拟环境
   .venv/bin/pip install -r requirements.txt  # 安装依赖（需要网络）
   .venv/bin/python scripts/pdf_parser.py document.pdf

### 方案四：Skill 打包成容器（最隔离）

把整个 skill 打包成容器镜像，Agent 通过 Docker 运行：

```markdown
## Execution

Run the PDF parser in an isolated container:

```bash
docker run --rm -v $(pwd):/data pdf-skill:latest python /scripts/pdf_parser.py /data/document.pdf

这样依赖完全封装在镜像里，不污染主机环境。

## 现实中的两种主流做法

### 1. 轻量级（Claude/Cursor 风格）

- **假设环境已配置好**，Skill 文档只写"需要装什么"
- Agent 运行脚本时如果报错，把错误信息返回给用户
- 用户手动装依赖后重试

**优点**：简单直接  
**缺点**：体验断档，用户需要懂技术

### 2. 重量级（企业 Agent 平台风格）

- Agent 运行在一个**预装了常见库的沙箱**中
- 每个 Skill 可以声明 `requirements.txt`，平台自动安装
- 或者用 Nix/Guix 做声明式环境

**优点**：用户无感知  
**缺点**：实现复杂

## 针对你的 Himalaya 示例

看回你给的 `himalaya` skill，它其实用了类似的思路：

```markdown
prerequisites:
  commands: [himalaya]   # 声明需要 himalaya 命令

prerequisites:
  commands: [himalaya]
  install_hint: |
    curl -sSL https://raw.githubusercontent.com/pimalaya/himalaya/master/install.sh | sh