在开始你的首次会话之前，请确保你已经为仓库建立索引并完成设置。这些是帮助 Devin 理解并处理你的代码库的基础步骤。 除非你已经有一个完整且明确的计划，否则我们建议先使用 Ask 模式，与 Devin 一起制定计划，然后再切换到 Agent 模式来执行该计划。
- 了解你的代码是如何工作的
- 探索架构和依赖项
- 在实现之前规划任务并界定范围
- 为 Agent 会话生成富上下文的提示
你可以从主页面或 DeepWiki 页面触发 Ask 模式。
要在主页面使用 Ask 模式，切换到 Ask 模式并选择你想要提问的代码仓库。
要在 DeepWiki 页面使用 Ask 模式，在页面底部的聊天输入框中输入你的问题并点击 Ask。Devin 的 Knowledge 将会自动限定在该代码仓库范围内。
在我们的 Ask Devin 指南中了解更多信息。
一旦你已与 Devin 一起理解了问题并制定了计划，就可以切换到 Agent 模式了。
Agent 模式是 Devin 的完全自主模式，在该模式下它可以编写代码、运行命令、浏览网页，并端到端完成复杂任务。 当你准备：
- 实现功能或修复 bug
- 创建 pull request
- 运行测试并调试问题
- 执行需要修改代码的多步骤任务
时，请使用 Agent 模式。
你可以在主页面或 Ask Devin 会话中进入 Agent 模式。
对于范围尚未完全明确的任务，我们建议：
- 先使用 Ask 模式 来规划任务
- 构建 Devin Prompt，它会基于你的 Ask 会话生成一个范围清晰的计划
- 点击 Send to Devin 切换到 Agent 模式并执行任务
该流程如下所示：
若要从主页面进入 Agent 模式，将模式切换到 Agent，并选择你要处理的一个或多个代码仓库。
启动 Agent 会话时，你需要配置几个选项：选择代码仓库，以及选择一个 Agent。
选择你希望 Devin 使用的代码仓库。点击仓库选择器，可以查看所有已添加到 Devin 运行环境中的仓库。
选择代码仓库可以确保 Devin：
- 能访问你的代码库并进行修改
- 使用正确的分支作为起点
- 能向正确的仓库创建 pull request
你可以选择 Devin 在本次会话中使用哪种 agent 配置。不同的 agent 可能具备不同的能力，或针对特定类型的任务进行了专项优化。
目前，我们提供了一个适用于大多数任务的默认 agent，以及一个名为 Dana、专门为数据分析任务优化的数据分析 agent。
如果你不确定该使用哪个 agent，默认 agent 通常可以很好地完成大多数任务。
@ 提及为 Devin 提供关于文件、代码库或其他资源的特定上下文。当你在聊天输入框中键入 @ 时，你会看到一个可用提及项的下拉列表：
- @Repos - 引用特定代码仓库
- @Files - 引用代码库中的特定文件
- @Macros - 引用某个 Knowledge 条目对应的宏
- @Playbooks - 引用团队或社区的 playbook（操作手册），这些是详细的提示模板，可用于引导 Devin 的行为。
- @Secrets - 从 Devin 的会话管理器中引用某个特定机密（例如 API key、凭证等）
@ 提及可以帮助 Devin 准确理解你正在处理的内容，并减少提示中的歧义。
从那些具有明确成功标准并且能为 Devin 提供所需上下文的任务开始——就像你把工作交接给一位队友时那样。随着你逐渐熟悉，可以尝试越来越复杂的任务。我们看到用户和 Devin 合作完成了各种工作，从修复小 bug，到有针对性的重构，再到大规模迁移，甚至从零构建完整功能。
一般来说：如果一个任务由你来做，三小时以内能完成，Devin 大概率也能完成。对于更大的项目，把它拆分成多个聚焦的会话，并将它们作为批量会话并行运行。
快速创建一个 PR（我们建议在 Playbook 中使用此提示）
