安裝
npx eve@latest init my-agent適合誰
這份技能適合想用「檔案系統優先」方式搭持久化 AI 代理的人:核心能力放在約定位置,專案更容易檢查、擴展和執行。它也適合準備在本機新建一個代理目錄、並能接受官方初始化命令副作用的人。
它不適合只想在對話裡臨時試一句、卻不想在磁碟上新建專案的人。官方起步命令會建立目錄、安裝依賴、初始化 Git,並啟動互動式終端介面。若你還不能執行 npx,或不能接受這些寫入與介面啟動,先停在閱讀說明,不要執行初始化。
官方倉庫見 https://github.com/vercel/eve 請只按該頁已寫出的命令操作。目前處於測試階段,行為可能變化。
3 分鐘完成第一次嘗試
只走官方寫出的這一條起步路徑。
前置條件:本機能執行 npx,目前工作目錄允許新建資料夾,並且你明確同意一次本地初始化。先確認:執行後會新建 my-agent 目錄、安裝依賴、初始化 Git,並啟動互動式終端介面。若你還不想寫磁碟或開啟該介面,不要執行下面的命令。
安裝位置:在你準備放新專案的目錄開啟終端,確認上述副作用後執行:
npx eve@latest init my-agent
低風險核對:命令結束後,不要急著改業務邏輯。先在新目錄裡開啟 instructions.md,核對該檔是否存在,以及註解是否仍寫著它是必需的、始終生效的系統提示。這是唯讀檢查。
成功訊號:出現名為 my-agent 的新目錄,依賴已經裝上,Git 已初始化,互動式終端介面被拉起,並且能看到必需的 instructions.md。若目錄沒出現或該檔缺失,不要自行補其他安裝器,回到官方頁面核對命令原文。
使用案例
案例一:從零搭一個可檢查的代理專案。官方命令 npx eve@latest init my-agent 會建立 my-agent 目錄、安裝依賴、初始化 Git,並啟動互動式終端介面。適合想先有一份約定目錄結構、再往裡放能力的人。動手前先確認目前目錄沒有同名資料夾;若原文沒有寫出如何跳過介面或跳過 Git,就不要假設存在這類開關。
案例二:檢查並理解始終生效的系統提示。原文給出的典型結構裡,instructions.md 被標成必需,並且是始終生效的系統提示。適合初始化完成後、先唯讀開啟該檔、確認代理預設指令放在哪裡的人。檔案系統優先意味著你用普通檔就能檢查;原文沒有寫出其他提示檔的必填關係時,不要自行補全目錄職責。
使用邊界
eve 目前處於測試階段,並受 Vercel 測試條款約束,介面與行為可能變化。條款頁是 https://vercel.com/docs/release-phases/public-beta-agreement 請以該頁為準。
起步命令只有一條被原文寫出:npx eve@latest init my-agent。不要編造未出現的安裝器。該命令會寫目錄、裝依賴、初始化 Git 並開啟終端介面,因此不適合只想做純說明核對、卻拒絕任何本地寫入的場景。
原文把 eve 寫成檔案系統優先的持久化 AI 代理框架,核心能力放在約定位置。它沒有列出可用用戶端名單,也沒有寫出如何接到未點名的程式設計助手。instructions.md 被標為必需的系統提示,但完整目錄樹、部署方式和金鑰設定原文沒有展開,不要補。