🤖 AutoAgent-TW

> 工業級自主開發代理系統 (Autonomous Agent Framework v2.4.1)

![Version](CHANGELOG.md) ![License: MIT](https://opensource.org/licenses/MIT) ![Engine: GSD](https://juejin.cn/post/7622885592715739145)

AutoAgent-TW 是一套專為 Antigravity IDE 深度整合的自主開發代理框架。它不只是一個 AI 助手，而是一位具備 高韌性 (Resilience)、自我修復 (Self-Healing) 與 長期記憶 (Long-term Memory) 的全端虛擬工程師。

---

🏗️ 核心架構支柱 (The Three Pillars)

1. 🛡️ 高韌性執行 (Resilience & Fault-Tolerance)

內建 Phase-based 容錯機制 與 Buffer Engine。面對數百個檔案的重構任務，自動啟動「分片處理」與「斷點續傳」，徹底終結 AI 超時與 Spin 問題。

2. 🧠 知識庫引擎 (Knowledge Automation)

全自動知識流向：LineBot ➔ Google Drive ➔ NotebookLM。整合向量檢索與主動分享機制，實現即時技術問答與文檔同步。

3. 🚀 GSD 流程哲學 (Get Shit Done Methodology)

嚴格執行 Discuss ➔ Plan ➔ Execute ➔ QA ➔ Ship 標準化流程。每一波修改都具備原子化提交 (Atomic Commits) 與 UAT 驗證機制。

---

💻 指令指南 (CLI Command Guide)

---

📊 系統邏輯流 (High-Level Architecture)

graph TD
    User([User Request]) --> Helper{/aa-helper}
    Helper --> Plan[Plan: Research / Roadmap]
    Plan --> Exec[Execute: Multi-Agent Parallelism]
    Exec --> Buffer[(Running Buffer: JSONL)]
    Buffer --> Exec
    Exec --> QA[QA: Test / Audit / Review]
    QA --> Guard[Guard: Security Scan]
    Guard --> Ship[Ship: Documentation / Delivery]
    
    subgraph Knowledge_Pipeline
    Line[LineBot] --> GDrive[Google Drive] --> NLM[NotebookLM]
    end

---

🏁 快速開始 (Getting Started)

1. 環境需求：Windows 10/11, Python 3.10+, Node.js, Git。 2. 一鍵安裝 (推薦)：在 PowerShell (系統管理員) 執行：

    Set-ExecutionPolicy Bypass -Scope Process -Force; .\aa-installer.ps1

3. 啟動開發：在 IDE Terminal 輸入 aa-tw --help 即可開始。

---

🛠️ 開發工具整合 (Development Tools)

為了追求極限開發效率，系統整合了以下專業開發工具：

Ripgrep (rg): 工業級文本檢索工具，替代傳統 grep。
優勢: 速度快 10x+，自動忽略 .gitignore。
範例: rg "search_term" --stats
Starship: 跨 Shell 的超快提示字元，優化開發日誌的 Token 消耗。
JetBrainsMono Nerd Font: 視覺化符號支援，提供極致的終端開發體驗。

環境初始化 (Setup)

若需重新建立高效能開發環境，可執行：

.\scripts\install_env.ps1: 自動化安裝全套工具。
.\scripts\setup_starship.ps1: 自動化 PowerShell 提示字元配置。

---

📜 免責聲明 (Disclaimer)

自主修改風險：本系統具備原生命令執行權限，請在隔離環境或 Git 受控環境下運行。
成本控管：請密切關注 Token 花費，系統已內建預算警告提醒。

---

Created with ❤️ by tom0930. Dedicated to the future of Agentic Workflows.

device-pair

Summary

Install to Claude Code