📚 教學中心
你想完成哪一種交接?讓 AI 帶你走。
APS 不是另一套要學的命令,而是 group project 的交接工具。要交接時,直接對本機 AI 說「用 APS 把這段工作交接給誰」最穩定;AI 會整理草稿、等你確認、再寫入共用 Google Drive。若交接卡住,APS Live 可作即時核對與交接追蹤;正式寫入仍回到本機 AI / terminal,由你確認。
🧭 你現在想做甚麼?
🔎 讀完後應該清楚兩件事
- 你對 APS 的運作流程有概念:它不是你的項目目標,而是在需要跨人、跨機、可追蹤交接時,幫 Adam 和 Jay 的 AI 對齊共同目標、整理交接、判斷能否接手。
- 你知道下一步怎樣操 APS:不用背命令;直接說「用 APS 把哪段工作交接給誰」,AI 會引導你確認、邀請、交接或收件。
⚡ 最快路徑
如果你不想分辨太多,直接把這段貼給本機代理型 AI:
請在目前本機工作目錄,按以下頁面完成 Agent Public Squares(APS)安裝、加入或升級: https://adamchanadam.github.io/agent-public-squares/docs/guides/aps-ai-agent-install.html
安裝成功後,AI 不應把安裝當成終點。它要主動建立「共同目標與分工」,先做到夠安全開始:共同目標、自己的用戶名稱、第一個可做小步、明顯不可做事項和最小驗收方式先清楚;其他角色、第一輪分工、邀請對象或詳細驗收可以先標為「未定」。公開頁以 Adam / Jay 作示範,只為方便分清兩邊;實際參與者和用戶名稱由用戶提供或確認,不可當作固定預設。
同一個 APS 合作目錄 只應有一份目前有效的共同目標與分工。三位或以上協作者要逐一確認;後加入協作者要先取得最新版,不應自行重建。只有共同目標、長期角色、驗收標準、不可做事項或會影響多個交接的分工邊界改變時,才修訂這份基準;普通任務細節由 AI 整理成當次交接或修訂,不要升格成新的共同基準。
💬 安裝後日常怎樣叫 AI?
- 要看整體交接狀態,說
Check APS。AI 會先判斷現在能否推進、卡在哪、下一句要叫 AI 做甚麼;排錯用的同步、來源編號和完整追溯資料由 AI 自己使用,只有需要深入排錯時才展開。它只整理本機已同步資料,不會自動派工,也不會背景自動監察。 - 要查看對方有沒有新交接,說
check Drive。APS 只整理已同步資料和下一步風險,不會自動通知對方,也不會自動打開對方的 AI。 - 要交給指定協作者,直接說
請用 APS 把這段工作交接給 Jay,先整理草稿,等我確認後才寫入共用 Drive。AI 會整理交接內容和風險,等你確認後才寫入共用 Drive 資料夾。
🔎 為甚麼要分人類頁和 AI 頁?
- 人類新手不需要先理解
npx、doctor、init、peer invite、peer add;邀請新協作者時,AI 會生成一次加入邀請碼;peer invite只是備用命令。 - 本機 AI 代理需要完整規格,否則容易在錯誤資料夾或錯誤 Drive 路徑動手。
- 安裝套件、寫入設定、寫入共用 Drive 資料夾前,仍要由用戶確認。