用途:指导在 Agent Framework 的 Python 单仓库(monorepo)中管理包,包括新建连接器包、版本发布流程、依赖边界校验与根 API 懒加载。
主要能力:说明仓库结构(根包 agent-framework、packages/core 主包、foundry/anthropic 等连接器包、独立 uv 项目 lab);使用 uv 管理依赖、poethepoet 自动化任务;提供依赖边界规则(稳定依赖用 >=已知良好,<下一主版本,预发布与 <1.0 依赖用硬上界);定义 alpha/beta/rc/released 生命周期版本模式与 PyPI 分类器对应关系;描述根 agent_framework 的懒加载导出(_LAZY_MODULE_EXPORTS、init.pyi、all 同步)与 provider 命名空间的 getattr 懒加载;给出新建连接器包的 alpha 清单与晋升路径。
使用方式:常用命令包括 uv run poe setup、uv run poe install、uv run poe venv --python 3.12、uv lock --upgrade-package <dependency-name>、uv run poe upgrade-dev-dependencies、uv run poe validate-python-release --base-ref upstream/main、uv run poe validate-dependency-bounds-test、uv run poe validate-dependency-bounds-project --mode both --package core --dependency "<dependency-name>"、uv run poe add-dependency-and-validate-bounds。Lab 项目需在 packages/lab 下运行 uv sync --all-extras --all-groups 与 uv run poe test。安装选项含 pip install agent-framework-core、agent-framework-core[all]、agent-framework、agent-framework-foundry。
适用场景:维护或新增连接器包、调整依赖范围、执行发布校验、修改根公共 API 与文档(AGENTS.md、PACKAGE_STATUS.md、README 环境变量说明)。
限制:新建包须经核心团队批准;lab 被排除在根 uv 工作区之外;alpha 阶段不得加入 core[all] 或创建懒加载;rc 分类器仍为 Beta;根 uv 版本需手动统一升级;具体收费、平台与效果信息暂未提供。