編程 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 的其他功能。