📚 入门教程

mkdir todo-cli && cd todo-cli
git init
claude

创建一个 Python 待办事项 CLI 应用：
1. 使用 click 库处理命令行参数
2. 使用 JSON 文件存储数据
3. 支持 add、list、complete、delete 命令
4. 添加单元测试

# todo.py
import click
import json
import os

TODO_FILE = "todos.json"

def load_todos():
    if os.path.exists(TODO_FILE):
        with open(TODO_FILE, "r") as f:
            return json.load(f)
    return []

def save_todos(todos):
    with open(TODO_FILE, "w") as f:
        json.dump(todos, f, indent=2)

@click.group()
def cli():
    """待办事项 CLI 应用"""
    pass

@cli.command()
@click.argument("task")
def add(task):
    """添加新的待办事项"""
    todos = load_todos()
    todos.append({"task": task, "done": False})
    save_todos(todos)
    click.echo(f"✅ 已添加: {task}")

@cli.command()
def list():
    """列出所有待办事项"""
    todos = load_todos()
    for i, todo in enumerate(todos):
        status = "✓" if todo["done"] else " "
        click.echo(f"{i+1}. [{status}] {todo['task']}")

if __name__ == "__main__":
    cli()

$ python todo.py add "学习 Claude Code"
✅ 已添加: 学习 Claude Code
$ python todo.py add "完成项目"
✅ 已添加: 完成项目
$ python todo.py list
1. [ ] 学习 Claude Code
2. [ ] 完成项目

创建一个天气查询 CLI：
1. 使用 requests 库调用 wttr.in API
2. 支持城市名称查询
3. 显示温度、天气状况、湿度
4. 添加 --json 参数输出 JSON 格式

# weather.py
import click
import requests

@click.command()
@click.argument("city")
@click.option("--json", "json_output", is_flag=True, help="输出 JSON 格式")
def weather(city, json_output):
    """查询城市天气"""
    url = f"https://wttr.in/{city}?format=j1"
    response = requests.get(url)
    data = response.json()
    
    current = data["current_condition"][0]
    
    if json_output:
        click.echo(response.text)
    else:
        click.echo(f"🏙️  {city} 天气")
        click.echo(f"🌡️  温度: {current['temp_C']}°C")
        click.echo(f"☁️  天气: {current['weatherDesc'][0]['value']}")
        click.echo(f"💧 湿度: {current['humidity']}%")

if __name__ == "__main__":
    weather()

创建一个 GitHub 文件上传脚本：
1. 使用 PyGithub 库
2. 支持指定仓库和分支
3. 自动处理文件更新
4. 添加日志记录

# github_upload.py
from github import Github
import os
import argparse

def upload_file(token, repo_name, file_path, branch="main"):
    """上传文件到 GitHub"""
    g = Github(token)
    repo = g.get_repo(repo_name)
    
    with open(file_path, "r") as f:
        content = f.read()
    
    file_name = os.path.basename(file_path)
    
    try:
        # 尝试更新现有文件
        contents = repo.get_contents(file_name, ref=branch)
        repo.update_file(
            file_name,
            f"Update {file_name}",
            content,
            contents.sha,
            branch=branch
        )
        print(f"✅ 已更新: {file_name}")
    except:
        # 创建新文件
        repo.create_file(
            file_name,
            f"Create {file_name}",
            content,
            branch=branch
        )
        print(f"✅ 已创建: {file_name}")

if __name__ == "__main__":
    parser = argparse.ArgumentParser()
    parser.add_argument("--token", required=True)
    parser.add_argument("--repo", required=True)
    parser.add_argument("--file", required=True)
    parser.add_argument("--branch", default="main")
    args = parser.parse_args()
    
    upload_file(args.token, args.repo, args.file, args.branch)