TRAE-AI编程
Atoms 与智能体协作
使用 Atoms 智能体从项目的 Chat 中进行规划、构建、研究、分析和改进。关闭 团队模式 可向 Alex 发起专注请求，开启后则可使用 Mike 和专家团队。本指南说明如何切换模式、提及智能体、跟进问题和计划、将后续请求加入队列、查看版本，以及在结果不正确时进行恢复。
智能体团队协作的工作方式
关闭 团队模式 时，由 Alex 处理请求。当工作需要 Mike 协调多个阶段，或当你想提及产品经理、架构师、数据分析师或其他可用专家时，请开启 团队模式。
在团队模式中，工作可以从一个智能体传递给另一个智能体。请关注 Working Process 和智能体消息，直到没有任何工作处于活动状态。如果结果生成了一个版本卡片，请选择 Preview 在 App 预览 中打开它，并在发布或请求进一步更改之前进行测试。
开启或关闭团队模式
团队模式 开关位于 Chat 输入框旁边的 <strong>+</strong> 菜单中。开关关闭时，由 Alex 处理请求。开关开启时，Chat 可以使用 Mike 和可用的专家智能体。
切换前请注意： 当深度研究或 Atoms 云处于活动状态时，你无法更改团队模式。深度研究仅使用 Iris，因此常规的 Group Members 列表不可用。请使用当前 Chat 中显示的智能体。如果团队模式被固定为开启且显示的是 Alex，请直接提及 Alex 来处理工程任务。若要使用标准的团队模式选项，请离开专用工作流并打开普通项目 Chat。
- 打开项目 Chat。
- 选择消息框旁边的 <strong>+</strong>。
- 在菜单中，为团队工作流开启 团队模式。当你希望由 Alex 处理请求时，请将其关闭。
- 关闭菜单，编写请求并发送。
如果你在团队模式关闭时输入 <strong>@</strong>，Chat 会显示 Switch to team mode to mention Agent。选择 Team 可开启团队模式并打开 Group Members，或选择 Engineer 以关闭选择器并继续与 Alex 协作而不进行提及。
开启或关闭团队模式
让 Mike 协调工作
当 团队模式 已开启且 Mike 在 Group Members 下可用时，如果你希望由 Mike 决定应由哪些智能体处理工作，请发送一条不带 <strong>@</strong> 提及的消息。对于跨越多个阶段的结果，这是最简单的选择。如果深度研究处于活动状态，请改用 Iris。
- 确认 Mike 可用。当开关可用时，开启 团队模式。如果开关被锁定，仅当 Mike 出现在 Group Members 下时才使用此工作流。
- 描述最终结果、项目当前状态、重要限制，以及你将如何评估结果。
- 发送不带 <strong>@</strong> 提及的请求，以便 Mike 进行协调。若要明确指定他，请输入 <strong>@</strong> 并在 Group Members 下选择 Mike。
- 关注 Working Process 和智能体消息。出现问题时进行回答。如果计划卡片已准备好，请选择 Approve 继续；如果计划需要修改，请打开其箭头菜单并选择 Decline。
这种请求会为 Mike 提供足够的信息来规划工作，而无需你亲自分配每一个步骤。
直接提及某个智能体
当你清楚应该由谁接收某项专注任务时，请提及该智能体。
- 在普通项目中，选择 Chat 输入框旁边的 <strong>+</strong> 并开启 团队模式。如果某个专用工作流锁定了该模式，请跳过此步骤，并仅使用当前 Chat 中显示的智能体。
- 在消息框中输入 <strong>@</strong>。
- 在 Group Members 下选择该智能体。
- 在提及之后，说明任务、重要背景、哪些内容必须保持不变，以及你期望的结果。
- 发送消息。
从 Group Members 中选择一个智能体
Group Members 通常包括 Alex、Bob、David、Emma 和 Mike。在受支持的 shadcn/ui 或 Atoms 云项目中，还会显示 Sarah 和 Adrian。启用深度研究后，提及选择器中只会显示 Iris。请以你的 Chat 中显示的列表为准。
| Agent | 角色 | 适合在以下情况下使用该智能体 |
|---|---|---|
| Mike | 团队负责人 | 任务需要在多个智能体之间进行规划、分派或协调。 |
| Emma | 产品经理 | 你需要明确用户、优先级、范围、工作流或功能取舍。 |
| Bob | 架构师 | 你需要系统结构、数据模型、集成或技术限制方面的帮助。 |
| Alex | 工程师 | 你希望构建、更改、修复或测试项目实现。 |
| David | 数据分析师 | 你希望分析数据、文件、指标或趋势。 |
| Iris | 深度研究员 | 你需要基于证据的市场、竞品、受众或技术研究。 |
| Sarah | SEO 专家 | 你希望为受支持的 Web 项目规划并改进 SEO 内容。 |
| Adrian | 广告专家 | 你希望为受支持且已发布的 Web 项目准备或分析 Google Ads。 |
你不能提及未显示在 Group Members 下的智能体。请让 Mike 与可用团队协调，或使用可启用所需专家的专用工作流。
与多个智能体协作
你可以在同一条 团队模式 消息中提及多个智能体。适用于彼此独立且不会互相覆盖的任务，并请明确说明每个智能体应处理哪一部分。
请清楚地区分每项分配，并说明该智能体是否可以更改项目，还是只能进行审查。
对于存在依赖关系的工作，不要一次性把每个阶段都发送给多个智能体。请让 Mike 协调顺序，并包含你必须批准工作的节点。
只使用实现结果所需的智能体，然后在工作完成后查看 Credits used。
跟进任务、审批和交接
请在项目 Chat 中跟进工作。Working Process 显示活跃的智能体步骤，问题卡片等待你的回答，计划卡片等待批准，而当项目生成可预览的版本时会出现版本卡片。
| 你看到的内容 | 含义 | 你需要做什么 |
|---|---|---|
| Working Process显示某个智能体处于活动状态 | 当前步骤仍在运行。 | 等待结果。如果 Queue 已启用，你可以输入下一条指令并按 Return 将其加入队列，而不会中断当前工作。 |
| 问题卡片 | Mike 需要信息，工作流才能继续。 | 回答每个问题；如果还有下一页，请使用Next；然后选择Submit。 |
| 计划卡片 | 拟议计划已准备好供审查，且尚未开始执行。 | 选择Approve继续。若要请求修改，请打开 Approve 旁边的箭头并选择Decline。 |
| 某个智能体的最终回复 | 该智能体已完成其分配的步骤。 | 在将整个请求视为完成之前，请检查Working Process和后续消息。 |
| 另一个智能体开始工作 | 工作已移交给另一位专家。 | 关注新智能体的消息；如果它请求信息或批准，请进行响应。 |
| 版本卡片 | 项目生成了一个可供审查的版本。 | 对于最新版本，选择Preview。对于历史版本，请先选择Load preview，然后选择View Preview。 |
书面答复、计划或研究摘要本身并不能确认项目已发生更改。如果请求包含实现内容，请查找生成的版本卡片，选择 Preview，并在 App 预览 中测试完整的用户流程。
发送有用的后续请求
有用的后续请求会告诉智能体哪些内容发生了变化、哪些必须保持不变，以及如何检查结果。
当某个智能体正在工作时，请在 Chat 输入框中输入下一条指令。当输入框显示 Press Return to queue the message 时，按 Return。该消息会被添加到输入框上方的 Queue 面板中等待，而不会中断当前工作。
在第一条消息加入队列后，Queue 面板会自动出现。如果它已折叠，请将其展开。拖动消息可重新排序；你也可以对单条消息使用 Send now、Edit 或 Remove。带附件的排队消息无法编辑。Queue 标题栏还提供 Clear queue、Pause processing queued messages 和 Resume processing queued messages。
如果 Queue 不可用，请等待当前任务完成后再发送后续请求。不要重复发送相同指令，因为重复请求可能会造成相互冲突的工作。
查看已排队的后续请求
当工作卡住或方向错误时进行恢复
从步骤 1 开始，只有在前一步无法解决问题时才继续往下。
- 检查当前状态。 阅读最新的智能体消息和 Working Process。查看是否有智能体仍处于活动状态、是否有问题或计划等待你的输入，或是否有后续请求在 Queue 中等待。
- 纠正方向。 发送一条清晰的纠正说明。描述预期结果、所需的最小改动，以及哪些内容必须保持不变。必要时提及应处理此事的智能体。
- 仅在必要时停止活动工作。 选择 Chat 输入框右侧的方形停止控件。其工具提示为 Click if you want to stop all tasks。在确认框中，选择 Yes, I'm Sure。这会停止该 Chat 中的所有活动任务，被中断的回复会标记为 Response stopped。
- 恢复到已知良好的版本。 如果某项已完成的更改让项目变得更糟，请在项目标题栏中选择 Versions。选择最后一个已知良好的版本。如有必要，请先选择 Load preview，再选择 View Preview。在版本预览中，选择 Restore to this version。确认前请注意：
- 如果出现 Sync database，请仔细检查。它默认已选中。如果你希望随版本一起恢复数据库，请保持选中；如果你希望保留当前数据库，请取消选中。
- 选择 Restore 进行确认。项目将返回到所选版本。后续版本仍会保留在 Versions 中，并可在需要时重新应用。
- 报告 Atoms 的问题。 如果 Atoms 本身的行为不符合预期，请在最新相关智能体消息上打开 <strong>...</strong> 并选择 Feedback。当前 chat ID 和 message ID 会自动附加。请描述准确步骤、你的预期、实际发生的情况，并在有帮助时附上清晰截图。
在停止或恢复之前。 不要仅仅因为任务耗时比预期更长就使用这两项操作。停止可能会丢弃当前进度。恢复会更改项目当前状态，并且在选中 Sync database 时也可能更改数据库。
停止所有活动任务
检查结果、积分和敏感信息
在你发布、更新或依赖结果之前，请确认：
- 每个请求的阶段都已完成，包括任何移交给其他智能体的部分。
- 最终版本能在 App 预览 中正确打开。
- 主要用户流程从头到尾都能正常工作。
- 智能体保留了你要求其不要更改的信息、功能和设计。
- 结果中没有出现私人信息、凭据或仅限内部使用的内容。
查看已用积分
在某次已完成轮次的最后一条智能体消息上，打开 <b>...</b>。菜单中会显示 Worked for；当该轮次结束且用量可用后，会显示 Credits used。若要检查工作区余额，请打开你的个人资料菜单，并在桌面端选择 Plans，或在移动端选择 Plans and credits。在 Plans and credits 面板中，查看 Credits remaining。
请在每次轮次完成后查看 Credits used，并在批准大量工作之前检查套餐和范围。
查看 Worked for 和 Credits used
不要将密码、API 密钥、身份验证令牌、付款详情，或不必要的个人或机密信息粘贴到 Chat 中。
常见问题
如果 Atoms 因请求可能有害而拒绝，我该怎么办？
当请求的结果可能不安全时，Atoms 可能会拒绝请求或要求澄清。不要试图隐藏、伪装或拆分有害请求来绕过该响应。
- 如果你的目标是正当的，请说明安全目的、谁授权了该工作，以及结果绝不能做什么。
- 删除真实个人数据、凭据、机密信息，以及可能伤害他人或系统的指令。
- 请求防御性说明、安全检查清单或无害示例，而不是会助长滥用的操作说明。
- 在发送前检查修改后的请求，并将其限制在完成安全任务所需的信息范围内。
如果明显正当且无害的请求仍被拒绝，请联系 Atoms Support，并附上 Chat Link 和经过脱敏处理的请求副本。请说明预期用途，但不要包含敏感信息，也不要要求 Support 绕过安全控制。
更多建议：