Skip to content

Commit 5c6f278

Browse files
committed
docs(ai): Add Google AI doc and update AI comparison table
Add new docs/google_ai.md that documents Antigravity's task.md artifact, explaining goals, constraints, implementation plan, and where task.md appears in the workspace. Include a sample task.md snippet. Update docs/AI.md to include a comparison table for OpenAI, Google, and Anthropic covering agent frameworks, web/local editors, CLIs, and research/note-taking tools. Signed-off-by: alanhc <[email protected]>
1 parent a1f0419 commit 5c6f278

File tree

2 files changed

+113
-0
lines changed

2 files changed

+113
-0
lines changed

docs/AI.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,3 +30,10 @@ https://youtu.be/6hRO1q8vv60
3030
## mcp
3131

3232
https://developers.openai.com/apps-sdk/build/mcp-server
33+
| 類型 / 公司 | OpenAI | Google | Anthropic |
34+
| ---------------------------------------- | ---------------------------------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------- |
35+
| Agent framework | Model Context Protocol (MCP) + OpenAI Agents SDK(Agent 標準 + SDK) | Agent Development Kit (ADK)、Vertex AI Agent Builder(雲端部署 Agent) | Claude Agent SDK(搭配 Claude Code / Claude 模型的 Agent SDK) |
36+
| Web-based AI editor / IDE(不含 NotebookLM) | Codex 線上編輯 / ChatGPT Code Interpreter | Google AI Studio、Firebase Studio、Gemini for Web、 | Claude Code Web App(claude.ai) |
37+
| Local AI editor / IDE | (OpenAI:目前無本地 IDE) | Gemini in Zed Editor、Antigravity(本地運行)、VSCode Gemini Plugin | Claude Code CLI(帶編輯能力) |
38+
| CLI tool | OpenAI CLI、Codex CLI(直接在終端呼叫 OpenAI API / 模型) | Gemini CLI(開源 AI agent,帶 Gemini 到你的 terminal) | Claude Code CLI(終端內的 Claude coding / agent 工具) |
39+
| Research / Note-taking Tools | (OpenAI:暫無專門筆記工具) | NotebookLM(AI 筆記與研究工具) | (Anthropic:暫無專門工具) |

docs/google_ai.md

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
antigravity
2+
Google Antigravity 的語境中,task.md 通常是 Agent 在執行任務時自動產生的「任務說明文件」(Task Artifact)。
3+
## task.md 的用途是什麼?
4+
5+
在 Antigravity 裡,每當你讓 Agent 做一個任務,例如:
6+
「幫我加一個 API endpoint」
7+
8+
「把這個 UI 改成深色模式」
9+
10+
「在 README 裡加入安裝教學」
11+
12+
「重構這個專案的目錄結構」
13+
14+
系統會產生一個 任務工件 (Artifact),其中最常見的就是 task.md。
15+
16+
🔍 task.md 通常包含:
17+
1. 任務目的 / Goal
18+
19+
說明你要求 AI 做什麼,以及這項任務想達到的結果。
20+
21+
2. 需求與約束條件
22+
23+
例如:
24+
25+
必須保留相容性
26+
27+
不可修改某些檔案
28+
29+
要符合 lint 規範
30+
31+
需在 browser/terminal/mcp 完整執行
32+
33+
3. Agent 計畫 / Implementation Plan
34+
35+
AI 會列出:
36+
37+
要修改的檔案
38+
39+
要新增的檔案
40+
41+
要做的步驟
42+
43+
如何驗證結果
44+
45+
4. 成果摘要 / Task Output Summary
46+
47+
任務完成後,Agent 會寫入:
48+
49+
已完成哪些變更
50+
51+
產生哪些 artifacts(browser recordings、screenshots、diffs 等)
52+
53+
5. 待辦事項 / Remaining Work
54+
55+
如果任務尚未完成,會列出剩下的部分。
56+
57+
🧪 為什麼 Antigravity 會做 task.md?
58+
59+
因為 Google Antigravity 是「agent-first 的 IDE」。
60+
61+
每件事背後都會產生一個計畫+追蹤文件:
62+
63+
方便你追蹤工作
64+
65+
讓 Agent 有上下文可繼續工作
66+
67+
便於審查與回溯
68+
69+
讓多個 Agent 能共同協作同一個任務
70+
71+
這比傳統「AI 直接修改檔案」更透明、更可控。
72+
73+
📂 task.md 通常出現在哪裡?
74+
75+
在每個 Agent 工作空間(Workspace)的 Task List 內。
76+
77+
你可以在:
78+
79+
Agent Side Panel
80+
81+
Task Manager
82+
83+
Artifacts 面板
84+
85+
看到 task.md。
86+
87+
```
88+
# Task: Add Signup API Endpoint
89+
90+
## Goal
91+
Implement a /signup endpoint with email + password validation.
92+
93+
## Plan
94+
1. Create route in routes/auth.js
95+
2. Add validation logic
96+
3. Update OpenAPI schema
97+
4. Write basic tests
98+
99+
## Output Summary
100+
- Added new route
101+
- Updated schema
102+
- Tests pending
103+
104+
## Remaining Work
105+
- Write full integration tests
106+
```

0 commit comments

Comments
 (0)