universal-file-opslisted

# universal-file-ops > **受众**：本技能专为**普通大模型/智能体用户**设计，非专业开发者。目标是让智能体能规范地使用 Python 创造工具脚本，输出即正确，无需反复调试。 ## 触发场景 **正向触发词**（满足任一即触发）： - 「帮我规范地处理文件…」「检查 Python 脚本规范」「生成测试」 - 「帮我搭建 Python 环境」「安装 Python 包」「切换 Python 版本」 - 「这个脚本有什么问题」「帮我 OO 化这个 Python 文件」 **否定条件**（满足任一项即不触发）： - 用户明确说「只用系统 Python，不用技能」 - 任务仅需单次文件读取，无需规范化/质量保证 ## 核心能力 > 📚 **渐进式加载**：本技能采用渐进式 MD 体系，`SKILL.md` 为入口（≤460行），详细内容拆分到 `references/*.md` 按需加载。 1. **通用文件操作 (工具箱 B)** — 标准化 IO、**原子写入**、自动备份、错误码输出 2. **Python 脚本质量流水线 (脚本流水线 C)** — 前置规范加载 → 需求一览表 → 代码生成 → 规范化 → 审查 → OO 化建议 → 测试生成 → 沙箱执行 → 修复循环 → 终版报告 3. **Python 环境管理 (环境 A)** — 版本安装/切换/包管理/干净重装（`scripts/python_env.py`，含网络重试） 4. **脚本类型区分** — 自动识别临时脚本 vs 正式工具，临时脚本豁免 600 行 OO 化限制 5. **沙箱测试** — `py_tools.py sandbox-test` 在隔离临时 venv 中自动编译并执行测试 6. **自引用 I/O** — 所有文件写入强制通过 `text_crud.py` / `file_ops.py` 或 `utils.atomic_write()`，禁止原生 `open()`/`write()` 7. **流程钩子系统** — `scripts/hook_runner.py` 强制执行三阶段流水线，每步写状态文件，不可跳过、不可乱序 ### 渐进式文件索引 | 文件名 | 位置 | 说明 | |--------|------|------| | `references/antipatterns.md` | 反模式 | 常见错误模式和正确做法 | | `references/report_templates.md` | 报告模板 | A/B/C 三阶段固定报告格式 | | `references/error_codes.md` | 错误码手册 | UFO-XXXX 全类错误码说明 | | `references/guide.md` | 使用指南 | 完整操作教程和示例 | | `references/faq.md` | 常见问题 | 14 对 Q&A | | `references/py_standards.md` | Python 编码规范 | 13 节规范说明 | | `references/permissions.md` | 权限说明 | 安全风险扫描结果 | | `references/changelog.md` | 更新日志 | 版本更新记录 | → 详见 [references/guide.md](references/guide.md) 完整使用指南 → 反模式参见 [references/antipat