GitHub 拉取请求模板

Devin 如何检测并使用 GitHub 风格拉取请求模板，包括 Devin 专用模板文件名。

​

Pull Request 模板

Devin 可以使用 GitHub 风格的 pull request 模板。它会在你的代码库中查找首个匹配的模板文件，并在生成或重新生成 PR 描述时使用该模板。除了标准的 GitHub 文件名之外，Devin 还支持一个 Devin 专用的变体，这样你就可以为 Devin 提供与人工作者使用的模板不同的版本。

​

1. 查找顺序

自上而下，先匹配者生效：

PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
docs/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
.github/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
PULL_REQUEST_TEMPLATE/devin_pr_template.md
docs/PULL_REQUEST_TEMPLATE/devin_pr_template.md
.github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
PULL_REQUEST_TEMPLATE.md
pull_request_template.md
docs/PULL_REQUEST_TEMPLATE.md
docs/pull_request_template.md
.github/PULL_REQUEST_TEMPLATE.md
.github/pull_request_template.md

名为 DEVIN_PR_TEMPLATE.md 和 devin_pr_template.md 的文件是可选的 Devin 专用覆盖模板（同时支持大写和小写两种文件名形式）。如果这两个文件都不存在，则会使用标准的 PULL_REQUEST_TEMPLATE.md 和 pull_request_template.md 位置。若仍未匹配到任何文件，Devin 会回退到其内置的默认结构。

​

2. 自定义 Devin 模板（可选）

通过创建以下任一文件来添加一个仅供 Devin 使用的模板：

.github/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
.github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
docs/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
docs/PULL_REQUEST_TEMPLATE/devin_pr_template.md
PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
PULL_REQUEST_TEMPLATE/devin_pr_template.md

如果你希望 Devin 在不改变用户在常规 PULL_REQUEST_TEMPLATE.md 或 pull_request_template.md 中看到内容的前提下，额外包含一些结构（例如风险检查清单提示），可以使用这种方式。大写和小写两种文件名形式都受支持。

如果你更偏好使用单一的共享模板，只需保留（或添加）：

.github/pull_request_template.md

占位符和 HTML 注释会自动清理。

​

3. 内置默认模板（未找到文件时）

如果没有模板文件，Devin 会使用一个内置默认模板，其中包含以下部分：

• Summary（摘要）
• Review & Testing Checklist（评审与测试清单）
• （可选）Mermaid diagram（Mermaid 图）
• Notes（备注）

除非你需要自定义，否则无需复制此模板；只要提供上述任一受支持的文件，即可完全替换该默认模板。

​

4. GitHub 参考

Devin 遵循 GitHub 的单文件模板解析规则。有关 GitHub PR 模板（包括多模板工作流）的更多信息，请参见此处。

---

最小配置，使 Devin 拥有自己的专属模板：

mkdir -p .github/PULL_REQUEST_TEMPLATE
echo "# [title]\n\n## Summary\n...\n" > .github/PULL_REQUEST_TEMPLATE/devin_pr_template.md

就可以了——打开或重新生成一个 PR，Devin 就会使用它。