开始之前
本指南使用 Twitter 示例 twitter-starter 来构建一个功能：分享一个巨大的 emoji，并在其下方附带文字。你将直接向 agent 描述你的需求，跟踪它的工作，并审查最终结果。你也可以将同样的流程用于其他功能或你想修复的缺陷。
- 安装 Panolayer、登录，并打开 Twitter Clone 示例。如果你还没有打开过仓库，请参见安装并设置 Panolayer。
- 使用内置的 Panolayer Agent。你也可以使用任何其他受支持的 agent，但需要先安装才能使用。设置方法参见受支持的 agent。
最终，你会得到一项已审查的改动，并记录在本地 Git 历史中。将其推送到远程仓库是另一个独立步骤。
启动 Panolayer Agent
- 在侧边栏中打开 My Agents。
- 点击 Monitor Agents 旁边的 + 按钮，打开 agent 菜单。
- 本次演练选择 Panolayer Agent。
该菜单包含 Panolayer Agent 以及你已安装的 agent。你可以任选其一来修复缺陷或编写代码。
Panolayer Agent 的用法与你已经在用的编码 agent 相同。 让它构建功能、修复缺陷，或回答关于你代码的问题。在 Chat with your codebase or build something… 中输入你的请求，并在工作过程中继续对话。
从问题出发？ 在 Issues 中选择 Fix，然后选择 Panolayer Agent。Panolayer 会把该问题的上下文带入任务中。这条路径请参阅首个缺陷演练。
给它一个结果明确的任务
描述哪里出了问题，或者你想构建什么、功能正常时应该是什么表现，以及 agent 需要保留哪些内容。如果你知道具体的文件或函数，请直接点名。
对于 Twitter 示例，请使用截图中显示的同一请求：
add a new feature where you can share a giant emoji with text underneath
在消息框中输入你的请求，然后点击发送箭头。
Panolayer Agent 在工作过程中可以使用代码地图找到相关的函数和关系。即使你不知道每个文件名，也可以描述你关心的行为。
如果 agent 提出问题，请在同一对话中回答。如果你需要缩小任务范围，请说明你想要的具体结果。
跟进工作进展，同时不占用你的工作区
当 Panolayer Agent 启动一次编码运行时，其进度会显示在对话中。编码工作在一个隔离的 Git worktree 中进行：这是一个独立的检出，agent 可以在其中编辑和测试代码，而你的主工作区始终保持可用。
在对话中查看任务进展
在 agent 构建巨大 emoji 功能的过程中，运行卡片会显示任务及其当前活动。你可以跟进进度，并查看它正在使用的文件和命令。
打开运行以查看更多细节
点击卡片右侧的 Open 查看该运行的活动。在 Stream 中选择一项活动，即可在右侧面板中查看对应的命令及其输出。使用 Back to agent 返回对话。
查看运行何时完成
工作完成后，卡片会更新为 Subagent run complete。Done 横幅会汇总检查结果和变更文件数量。你仍然可以选择 Open 查看已完成的运行。
你可以继续自己的工作，稍后再回到该运行。当有多个 agent 同时工作时，使用 Monitor Agents 查看总览。多个 agent 可以在各自独立的 worktree 中处理同一个仓库；合并前请先审阅它们的改动如何相互配合。
让后续消息与其任务保持关联。 发送后续消息时，请使用对话中显示的那条运行引用，以便明确你指的是哪个任务。
审阅验证结果
合并前，请结合验证结果审阅变更的代码。完整审阅 agent 改动的指南见审阅变更并提交。
当 agent 请求合并时，请阅读验证摘要：Rules passed、Verification runs 和 Files changed。请将新增的失败与原本就存在的问题分开审阅。
在本次运行中，摘要显示 110 of 121 rules passed、1 verification run 和 16 files changed。它单独列出了 11 pre-existing failures，并报告没有新增失败、警告或未检查的规则。你的具体数字取决于你的任务。
打开 Details 可进一步调查结果。摘要字段和状态的说明见理解验证结果。
当任务需要时，请在运行中的应用里检查实际行为。以本示例为例，试着发布一条带巨大 emoji 和下方文字的帖子，然后确认普通文字帖子仍能正常工作。
Merge when you’re ready
You decide what moves from the agent’s worktree into your branch. Choose Not now to keep reviewing. Once you’re satisfied with the changes and results, confirm the target branch and choose Merge into main for the Twitter sample.
The Merged into main confirmation shows a commit ID. This workflow records the change in local Git history, so you don’t need to commit that same change again.
Open Changes and find the commit in History. Check for unexpected uncommitted edits. If your repository has a remote and you want to share the commit, use Git → Push.
You’ve given an agent a task, followed its work, reviewed the result, and decided what reaches your branch.