编程 Agent

🟢 不会移动资金。Coding 可以修改所选项目检出目录中的文件并运行命令。如需避免影响主工作目录，请使用隔离工作树。

Coding 为 Minara 提供理解项目上下文的工程工作区。Agent 会先检查仓库，遵循项目内的指令，只修改与任务相关的最小范围，并使用项目自己的工具验证结果。

适合用于理解陌生代码库、实现功能、修复失败测试、审查变更、改进算法，以及处理金融工程代码。涉及金融工程时，Agent 会明确数据、精度和风险假设。

开始编程任务

1. 在 Web UI 中打开 Coding。
2. 新建项目文件夹或添加现有文件夹。从机器上选择任意文件夹需要使用 Minara 桌面应用。
3. 对于新的 Git 任务，关闭输入框中的 工作树 可使用所选本地检出目录；打开它可隔离该任务。
4. 工作树模式会优先选择可用的 main；如果不存在，则回退到有效的默认或当前本地分支。你也可以从分支选择器中选择其他本地基线；此操作不会切换本地检出目录。
5. 描述目标并发送第一条提示词。Agent 开始操作前，Minara 会从所选基线创建 minara/task-* 分支和托管工作树。项目、检出目录、终端、文件和工作台工具会持续绑定到该任务。

任务开始时，Minara 会读取根目录的 AGENTS.md 和 CLAUDE.md。它还会发现嵌套的指令文件和仓库结构，在修改每个文件前加载适用规则。

项目、检出目录与工作树

项目是注册到 Coding 的仓库或文件夹。检出目录是某个任务实际使用的目录。

关闭工作树模式时，分支选择器会列出本地分支，显示当前分支和未提交文件数量，并可创建或检出分支。打开工作树模式后，它只选择新任务分支的基线，不会切换本地检出目录。当切换会覆盖本地变更时，Git 仍会拒绝操作。

Agent 可以做什么

• 探索文件、架构、类型、配置和项目历史。
• 在绑定的检出目录中编辑、新增、重命名和删除文件。
• 运行终端命令、测试、类型检查、构建和项目专用验证。
• 项目提供开发服务器或预览命令时，检查应用预览和运行时行为。
• 在交付代码的同时说明算法、数据流、故障原因和取舍。
• 只要求分析时，审查现有 diff，不修改文件。

Browser & Computer Use

Browser 与 Computer Use 组成一项交互能力。Minara 可以读取页面结构、截取屏幕、点击、输入、滚动、拖动和发送按键。操作过程会显示在同一个会话中。

• 在云端环境中，操作可见的云浏览器或云电脑会话。
• 在桌面端，操作本地浏览器和电脑界面。
• 普通网页优先使用页面结构。画布、桌面应用或缺少可靠选择器的控件使用可视化电脑控制。

它可以检查本地预览、复现 UI 问题、验证响应式布局，或完成基于浏览器的开发流程。状态发生变化后，Minara 会再次检查屏幕。发布、购买、发送或删除等外部重要操作需要先确认。

审查每一轮变更

Coding 轮次修改文件后，回复中会出现变更集卡片，显示受影响的路径、增加行和删除行。打开 Review 检查 diff。

文件在轮次完成后没有再次变化时，可以选择 Undo 恢复该轮修改。Minara 会先比较当前文件与记录的修改后状态。如果撤销会覆盖其他编辑，操作将因冲突停止，不恢复任何文件。

大型文件或二进制文件可能只显示变更，不提供可撤销的文本快照。提交前以 Git diff 为准。

安全与 Git 边界

• 任务在绑定的检出目录中工作。扩大范围需要明确指示，并且文件夹权限必须允许。
• 绑定项目前，Minara 会检查目录是否可读写。
• 已有用户变更归用户所有。Agent 会保留这些变更，避免无关清理。
• 除非明确要求，否则 Agent 不会提交、推送、创建或切换分支、创建拉取请求、重写历史或丢弃变更。
• Coding 不会绕过金融操作以及浏览器和电脑重要操作的确认规则。

示例提示词

探索这个仓库，说明架构、运行命令和主要风险。

创建隔离工作树，为报告页面实现 CSV 导出，并运行相关测试。

找出身份验证测试失败的根因。修改代码前先说明诊断结果。

审查当前 diff 的正确性、安全性和缺失测试。不要修改文件。

打开本地预览，复现移动端布局问题，修复后分别在桌面和移动尺寸下验证。

后续阅读

• 编程任务需要带引用的外部证据时，使用深度研究。
• 如需生成带托管组件和发布流程的实时数据仪表盘，使用 Data Studio。
• Web 仪表盘介绍 Web UI 的其他功能。