技能 python-cli-patterns
💻
在 Python 中创建命令行界面需要理解参数解析、输出格式化和配置管理。本技能提供可直接使用的模式，帮助使用 Typer 和 Rich 库构建专业的 CLI 工具。
支援: Claude Codex Code(CC)
1
下載技能 ZIP
2
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
3
開啟並開始使用
測試它
正在使用「python-cli-patterns」。 创建一个在表格中显示用户状态的 CLI 命令
預期結果:
- ✓ 用户表格显示 ID、姓名、邮箱和状态列
- ✓ 状态列使用绿色复选标记显示活跃用户
- ✓ 标题使用粗体洋红色文本样式
- ✓ 表格包含标题和正确的列对齐
安全審計
低風險v3 • 1/10/2026
Documentation skill providing CLI development patterns. Contains legitimate environment variable access for configuration and filesystem access for config file handling. These are standard practices for CLI applications and align with the stated purpose.
5
已掃描檔案
1,089
分析行數
2
發現項
3
審計總數
風險因素
審計者: claude 查看審計歷史 →
品質評分
59
架構
100
可維護性
81
內容
30
社群
90
安全
70
規範符合性
你能建構什麼
构建开发工具
使用专业的 CLI 界面创建内部开发工具和自动化脚本
配置基础设施
构建支持分层配置文件和环境变量的配置管理 CLI
创建数据管道
开发带有进度跟踪和丰富输出格式化的数据处理 CLI
試試這些提示
基础 CLI 结构
创建一个带有主命令和一个子命令的基础 Typer CLI 应用程序
添加 Rich 输出
添加 Rich 表格来显示结果，并为长时间运行的操作添加进度条
配置处理
实现从 ~/.config/myapp/ 加载配置文件和环境变量支持
生产级模板
创建一个生产就绪的 CLI 模板，包含状态管理、错误处理和配置子命令
最佳實務
- 使用类型注解来启用自动验证和帮助文本生成
- 将相关命令分组到子应用程序中以获得更好的组织和可发现性
- 在回调级别实现 --verbose 和 --config 选项，以便在所有命令中一致访问
避免
- 避免对核心功能使用 os.system() 或 subprocess 调用 - 应使用 Typer 命令代替
- 不要硬编码配置值 - 应使用环境变量和配置文件
- 避免将业务逻辑与输出格式化混合 - 分离关注点以提高可测试性
常見問題
需要什么 Python 版本？
需要 Python 3.10 或更高版本。Typer 使用现代类型注解功能。
需要哪些库？
安装 typer 和 rich。使用：pip install typer rich。要获得完整的 CLI 支持，请添加 pydantic-settings。
如何处理环境变量？
使用 typer.Option(envvar='VAR_NAME') 来读取环境变量，并自动回退到默认值。
用户数据安全吗？
本技能仅提供模式。实际的数据处理取决于您如何实现 CLI。
如何测试 CLI 命令？
使用 Typer 的 CliRunner（来自 typer.testing）。使用参数列表调用命令并断言退出码和输出。
与 Click 或 argparse 相比如何？
Typer 基于 Click 构建，使用 Python 语法。它比 argparse 更简洁，同时提供 Rich 集成以实现美观的输出。