stdlib-scripting

用途：在已确认无法安装依赖的受限环境（气隙系统、无 uv、无网络）中，创建仅依赖标准库、可移植的 Python 3.11+ 脚本。它是最后手段：若环境允许联网安装依赖，应改用 python-cli-architect 配合 Typer+Rich；限制未确认时先与用户核实，不要假设。\n\n主要能力与策略：运行时仅用标准库；开发期可用 pytest、ruff、ty（首选），或按项目使用 mypy/pyright；运行时例外须有书面理由与锁定策略。产出代码需通过 ruff 与项目类型检查，并有覆盖正常、边界与错误路径的 pytest 测试。提供 argparse CLI、结构化日志、错误边界、配置读取、异步仅用于 I/O 密集场景，以及特权命令执行等系统集成模式，并给出多文件项目骨架。\n\n使用方式：按 PHASE 0 研究、PHASE 1 重构影响分析、PHASE 2 创建、PHASE 3 验证推进。验证命令保持原样，包括：python -m py_compile <file>、grep -E "from typing import .*(Dict|List|Set|Tuple|Optional|Union)\b" <file>、ruff check <file>、uv run ty check <file>；项目统一 mypy 或无 uv 时用 mypy --strict <file>。所有新建或修改的脚本需校验 shebang：/python3-development:shebangpython <file_path>，确保使用 #!/usr/bin/env python3 且不带 PEP 723 元数据。完成后须输出 Refactoring Impact Analysis 与 Validation Report。\n\n适用场景：气隙或无网络、无 uv、无法安装第三方包的环境中的 CLI 与自动化脚本。限制：不适用于可联网的标准环境；禁止使用已弃用语法、无回退的平台特定行为，禁止跳过验证或测试；参考 typing-strategy.md、command-execution.md、type-safety-patterns.md 了解类型与命令执行细节。