diff --git a/llmdoc/reference/ansible-version-compatibility.md b/llmdoc/reference/ansible-version-compatibility.md
new file mode 100644
index 0000000..df07d97
--- /dev/null
+++ b/llmdoc/reference/ansible-version-compatibility.md
@@ -0,0 +1,39 @@
+# Ansible 版本兼容性参考
+
+## 版本兼容性矩阵
+
+| Ansible 版本 | 状态   | 主要变更                     | 兼容性级别 |
+|------------|---------|-----------------------------|------------|
+| 2.9 及以下   | 不推荐  | 传统模块实现                 | 低         |
+| 2.10-2.13  | 部分兼容 | 模块命名空间变更              | 中         |
+| 2.14+      | 推荐    | 废弃 `warn` 参数，模块规范化   | 高         |
+
+## 关键变更详情
+
+### `warn` 参数的移除
+
+- **版本**：Ansible 2.14
+- **影响模块**：`command` 和 `shell`
+- **变更原因**：简化模块接口，提高安全性
+
+#### 迁移指南
+
+1. 移除 `warn: false`
+2. 使用 `ansible.builtin.shell` 替代
+3. 调整执行策略
+
+### 模块命名空间变更
+
+- 从 `command` → `ansible.legacy.command`
+- 推荐使用 `ansible.builtin.shell`
+
+## 最佳实践
+
+- 始终使用最新的 Ansible 版本
+- 定期检查并更新 Playbook
+- 使用 `ansible_version` 进行版本兼容性检查
+
+## 参考资源
+
+- [Ansible 官方版本发行说明](https://docs.ansible.com/ansible/latest/release_notes/index.html)
+- [Ansible 模块迁移指南](https://docs.ansible.com/ansible/latest/dev_guide/module_lifecycle.html)
\ No newline at end of file