用途:将项目升级到更新的 django-modern-rest(dmr)发布版本;当要提升 dmr 版本,或依赖更新导致导入(imports)报错时使用。
主要能力:每个破坏性 dmr 版本都附带官方迁移提示。该技能收录最近三个破坏性版本的提示文件(references/ 下每个版本一个文件),包含 0.13→0.14、0.14→0.15、0.15→0.16 三份。包的 CHANGELOG.md 列出破坏性变更本身。提示强调不要猜测 API 如何变化,而应读取所跨每个版本的提示并全部应用。
使用方式:先确定当前版本(uv pip show django-modern-rest、pip show django-modern-rest,或 uv.lock、poetry.lock、requirements.txt 中锁定的版本)与目标版本(用户指定,否则用 PyPI 最新版)。告知用户中间包含哪些版本并按顺序逐个应用,绝不跳过。然后更新 pyproject.toml(或 requirements 文件)并安装,使类型检查器看到新 API。按从旧到新读取所选版本的提示文件,将每个编号条目应用到整个项目(源码、测试、fixtures、settings、管理命令),一次只处理一个版本并保持该版本的改动集中以便逐个审查。若需要版本相关文档,可加载对应版本的索引 https://django-modern-rest.readthedocs.io/en/<version>/llms.txt。
验证:运行项目类型检查器以捕获重命名和类型变更的 API;运行测试套件;运行 python manage.py check,使用 OpenAPI 时运行 python manage.py dmr_export_schema <schema-path> 并与旧 schema 对比,确认只有预期变更;在项目中搜索提示中提到的每个符号,全部清除即完成。
限制:本技能仅含 0.13 起三个版本的提示;项目版本早于 0.13 时,旧版提示不在技能内——0.13.0 起见 GitHub releases 描述,更早见 CHANGELOG.md,需先以同样方式应用。不得改动业务逻辑、响应契约或设置,超出提示条目要求的部分;若条目与用户想保留的项目行为冲突,应停止并询问。最终给出简短报告:按顺序应用的版本、按提示条目分组的每项变更、无法解决的条目及原因(含具体文件与行号)。