SuperAPI AI 工具集

phira-env-contract

通用与其它

查看项目

更新于 10-16 03:41

技能介绍

用途:在编写可能受 Python/库版本、GPU/CPU 可用性或依赖策略影响的代码前,先推断并明确仓库的有效运行时环境与依赖策略,形成“环境契约”,约束实现选择,使后续失败可复现。

主要能力:按顺序执行检查清单,优先依据仓库产物而非假设。查找 pyproject.toml、requirements*.txt、poetry.lock、uv.lock、Pipfile.lock、environment.yml、conda*.yml、Dockerfile、docker-compose.yml、Makefile、noxfile.py、tox.ini、.python-version、.tool-versions、setup.cfg、setup.py;查找 CI(.github/workflows/、ci/);查找运行时文档(README*、docs/**)。推断 Python 版本:.python-version/.tool-versions 优先,其次 CI 固定版本,再次 Dockerfile,否则报告 unknown 并约束为广泛兼容代码。识别最小关键依赖集,只列影响本次改动的包(如 torch、jax、transformers、numpy、pydantic、hydra、lightning、accelerate、datasets),优先使用锁文件。确定依赖策略:任务明确允许新依赖则 deps allowed,否则默认 no new deps;无法推断则标记 unknown,仅当影响实现方式时才向 phira 提问。记录来源,引用具体产物或命令。

使用方式:在实现报告顶部附近提供“Environment contract”块,包含 Python、Platform、Key deps、Dependency policy、Hardware(仅相关时)、Provenance 字段。

限制:环境约束未知且实质影响正确性时,只提一个针对性问题,仅请求缺失约束;默认不升级或提升依赖版本。资料未提供具体安装命令、价格或平台支持信息。