Skills Atlas — Repo 使用說明書 以自然語言描述目標，dothething 自動規劃並執行。 本地自走型 AI Agent，底層為 Claude Opus 4.6 與 45+ 工具。

search_web 走本地 SearXNG 實例，整合 Google、Bing、DuckDuckGo 與圖像搜尋；fetch_page 用 Notte 解析靜態頁面；browser_agent 透過 Camoufox（反指紋 Firefox 分支）跑互動式抓取與多步流程。可選 --headed 開視窗 debug，SERPER_API_KEY 啟用 Serper 補強，TWOCAPTCHA_API_KEY 自動解 captcha。

檔案層提供 read_file、write_file、edit_file、batch_read、diff_files；系統層有 run_command、shell_session（保留環境變數與 cwd）、run_code、glob、list_dir、search_file、http_request。視覺工具 analyze_image 與 analyze_data 處理截圖、CSV、JSON。預設 cwd 是當前目錄，--cwd 可改。

透過 AgentMail 整合，提供 email_create_inbox、email_send、email_list、email_read、email_wait_for_message。email_wait_for_message 可暫停代理執行，等到符合條件（寄件人 / 主旨 / thread）的郵件抵達再續跑，適用於 OTP 驗證、客戶確認、註冊流程等非同步場景。

自訂技能放在 ~/.dtt/skills/<name>/SKILL.md，frontmatter 支援 inline: true（注入系統提示）、allowed-tools（限縮工具集）、disable-model-invocation（隱藏自動觸發）。MCP 伺服器寫在 ~/.dtt/mcp.json，代理會自動發現所有暴露的工具。剪貼簿與 request_user_input 也都是工具，模型隨時能來找你。

必填 OPENROUTER_API_KEY。選填：SERPER_API_KEY（補強搜尋）、TWOCAPTCHA_API_KEY（自動解 captcha）、AGENTMAIL_API_KEY、AGENTMAIL_INBOX_ID、AGENTMAIL_HUMAN_EMAIL（OTP 轉發）。檔案 ~/.dtt/env 以 0600 權限存放，shell export 會即時覆寫保存值，CI 環境下換 key 不必改檔。

預設主腦 Claude Opus 4.6，--fast 改用 Opus 4.6-fast（便宜但能力較弱）。Summarizer / Notte 解析 / delegate 子任務固定走 Sonnet 4.6。Oracle 預設 GPT-5.4，--oraclepro 升級為 GPT-5.4-pro 處理深度疑難。模型呼叫全程經 OpenRouter，可在 dashboard 追蹤 token 與成本。

技能放在 ~/.dtt/skills/<name>/SKILL.md，子目錄可任意組織。Frontmatter 支援：name、description、inline: true（注入系統提示）、allowed-tools: [Read, Write]（含 allowed-tools 等同 inline）、disable-model-invocation: true（從自動清單隱藏）。Inline 技能直接成為 prompt 一部分；非 inline 技能由 use_skill 以隔離任務形式呼叫。

設定檔結構標準：{ "mcpServers": { "<name>": { "command": "npx", "args": [...], "env": { "API_KEY": "${ENV_VAR}" } } } }。符合 MCP 規範的伺服器均可接入，包括 Notion、Slack、Linear、Postgres、Playwright 等。代理啟動時自動列舉伺服器、載入工具描述，併入主清單供模型決策。

./dtt.sh --pipe --prompt "Summarize the README" | pbcopy 直接把摘要丟進剪貼簿。--pipe 抑制所有 log，stdout 只有最終報告；exit code 0 完成、2 部分完成、1 失敗。可在 cron、shell script、CI step 直接呼叫，把代理嵌進既有自動化流程而非另起一個 SaaS。

browser_agent 處理需要點擊、表單、登入、驗證碼的多步流程；fetch_page 用 Notte 解析靜態頁面節省 token；http_request 直接打 API。設定 TWOCAPTCHA_API_KEY 後遇到 reCAPTCHA / hCaptcha 會自動轉送解碼。--headed 可顯示視窗用於 debug，但平常無頭執行更省資源。

設好 AGENTMAIL_API_KEY 與 AGENTMAIL_INBOX_ID，代理即擁有獨立收信地址。任務需要驗證碼或等待回覆時，email_send 寄出後，email_wait_for_message 暫停執行，直到符合條件（寄件人、主旨、thread）的郵件抵達。AGENTMAIL_HUMAN_EMAIL 可將需人工驗證的信件轉到指定信箱。

./dtt.sh --orchestrator 啟動全螢幕終端機介面，每個 agent 一行顯示狀態、phase、耗時、累積成本，可即時展開查看 log。內建 smart launcher 會在開工前估算成本，預設上限 16 個並行 agent。適合 N 家公司同時做 prospect research、N 個競品同時拆解、N 個語系同時翻譯落地頁。

./dtt.sh --prompt "..." --max-cost 5.00 在累計花費達到 5 美元時暫停。下回 ./dtt.sh --resume <thread-id> --max-cost 10.00 接著跑，避免長任務失控。配合 --max-loops 可同時設輪數上限。

任何被 --max-cost、Ctrl-C、或 OS 重啟打斷的工作，都可以 ./dtt.sh --resume <id> 接著做。~/.dtt/threads/<id>/cache/ 是 per-thread scratch 目錄，所有日誌會自動 redact API key 與 token，再寫入磁碟。

代理跑迴圈時，鍵盤敲下任何按鍵都會打開輸入框，把你的補充指示注入下一輪 prompt。若不想打斷當下的工具呼叫，按 Ctrl-Q 把訊息排隊，等該步完成才注入。比起重啟一次 prompt，這對長任務的引導效率高得多。

日常任務可用 --fast 切換至 Opus 4.6-fast 降低費用；推理困難時加 --oraclepro，將 oracle 從 GPT-5.4 升級為 GPT-5.4-pro 取得第二意見。兩者可同時使用：主腦走 fast，oracle 走 pro，兼顧成本與決策品質。

長時間任務執行期間無需持續監控。--notify-desktop 完成時發出系統通知；--notify-email <addr> 透過 AgentMail 寄信，可由行動裝置接收。除錯時加 --verbose 取得完整 traceback、--debug 查看原始 API payload 與 cache 命中率，用於定位 prompt 結構問題。