通用文件与 Python 流水线

要解决什么问题

很多智能体在帮用户「改个文件」或「写个 Python 小工具」时，会直接 open() 覆盖写入、跳过格式检查，或在系统 Python 里乱装包。结果是半截文件、环境被污染、脚本一跑就报错，用户还要反复口述「再检查一遍」。本技能把目标定在普通大模型用户：输出应尽量一次可用，而不是留给用户当调试练习。

技能如何工作

整体是三阶段钩子流水线，由 hook_runner.py 强制顺序执行，每步落盘状态，不能跳过也不能乱序（致命错误才 fail 并阻断后续）。

• Phase A（环境）：python_env.py 检测/创建 venv、装依赖；H-A11 用语义路由到文件工具箱 B 或脚本流水线 C。
• Phase B（文件 CRUD）：读 → 内存处理 → 原子写入（utils.atomic_write() / text_crud.py、file_ops.py）→ 回读校验，避免写入中断留下残缺文件。
• Phase C（脚本流水线）：先加载 references/py_standards.md 等规范，生成需求表与 .py，再 normalize → review → 可选 oo-ify（正式工具且 >600 行；临时脚本可豁免）→ gen-test → 隔离 venv 沙箱 sandbox-test；失败进入 H-C09 修复循环（最多 3 次），最后 H-C10 按 report_templates.md 出结构化报告。

技能自身也约束 I/O：禁止在流水线里用原生 open(..., "w") 写文件；错误统一为 UFO-XXXX JSON（见 references/error_codes.md）。入口 SKILL.md 较短，细节按需读 references/*.md。

适用边界

• 会触发：规范处理文件、搭环境/装包/切版本、审查或 OO 化脚本、生成测试、问「脚本有什么问题」等。
• 不触发：你明确说「只用系统 Python，不用技能」；或只是单次只读，不需要规范与质量保证。
• 路由不确定时，技能会问你；H-C10 是唯一允许在前置已 fail 时仍尽量出报告的路径（其余钩子要求前置为 done）。