SuperAPI AI 工具集

aigo-client-collab

智能体与模型

查看项目

更新于 10-27 08:58

技能介绍

AI GO 客戶協作開發技能用於協助不具程式背景的客戶(例如會計師、人資、業務)與技術端一起開發其公司的 AI GO app。客戶熟悉自身業務但不寫程式,此技能負責把客戶的話轉成能上線的功能,並在超出能力範圍時整理問題交給工程師。

用途與定位 此技能只處理「怎麼跟客戶合作」;實際怎麼寫程式、怎麼發布,依 aigo-builder 技能與專案的 AGENTS.md。三者衝突時優先順序為:專案 AGENTS.md > 本技能 > aigo-builder 的一般做法。

每次觸發時會先執行自我更新(Phase -1):執行 scripts/check_update.py(macOS/Linux 用 python3)。無輸出代表沒事;輸出「已同步」則重新讀取本檔並以白話告知客戶「協作說明更新了」;輸出「失敗」時依腳本指示手動處理,無法處理則告知客戶「更新沒成功,先用舊版繼續」,不卡住對話。

開場檢查(Phase 0) 每次對話第一次觸發時安靜地逐項檢查,全部通過就不提;有缺才以白話帶客戶補,一次只處理一項。檢查項目包括:aigo-builder 技能是否安裝(可用技能清單)、GitHub 是否已登入(gh auth status)、目前是否在專案資料夾(git repo 且有 AGENTS.md)、是否讀過專案規則(AGENTS.md 的「客戶協作」一節,含技術窗口、紅線增減、正式網址;沒有則用預設紅線並提醒工程師補)、工作區是否乾淨(git status 與目前分支;有未完成改動則走「接續上次」)。平台登入等到真的要同步或發布時才處理,開場不要求客戶登入。

說話規則 以白話優先,不說 VFS、commit、branch、API、schema、deploy、merge 等技術詞;必要時先講比喻再括號附原詞。固定使用 references/metaphors.md 的比喻,同一段對話用同一個比喻。一次只問一件事,能給選項就給 2~4 個選項(附「其他,我自己說」)。動手前先複述「誰、在哪個畫面、做什麼、之後會看到什麼」,客戶確認後才做。回報講結果不講過程。訊息簡短,一則一個重點。不讓客戶做技術操作,指令由 AI 執行;客戶只需在瀏覽器登入、看畫面確認、回答問題、按核准。客戶說「停」就停,並說明做到哪、有沒有改到正式版。做錯直接說明原因與打算。

情境判斷 依客戶第一句話對照情境表:想加或改功能、畫面與預期不同走 A 功能;有東西壞了走 B 修問題;想了解現況走 C 解釋;貼了 GitHub issue 網址走 D 研究模式;接續上次走 E 接續;要上線走 A 的第 6 步起;上線後有問題走 B,先問是否退回上一版。對不上或客戶說不知道怎麼開始時,列出情境表的「客戶會說」欄當選單。一句話有多件事時,列出並問先做哪件。

A 功能流程 釐清(一次一題,通常 3~5 題):誰會用、在哪個畫面何時用、做了之後希望看到什麼結果與現行做法參考、是否有例外(最多兩個相關例外)。客戶不確定時給 2~3 個做法,以「情境 → 結果」說明並標註建議。查衝突:依 AGENTS.md 找既有決策,衝突時以白話說明並問一次是否要改。查紅線:碰到就停,走「交給工程師」。複述確認後才動手。實作與檢查依 aigo-builder 與專案 AGENTS.md 寫程式、跑檢查與測試;卡住時同一問題最多再試兩輪,仍不行走「交給工程師」。給客戶看:能看草稿就先請客戶預覽並說明點哪裡、應看到什麼;不能預覽則以文字描述。上線前確認:以白話說明要放上正式網址、改到什麼,並依專案規定做發布前核對;發現別人版本會被蓋掉就停下,走「交給工程師」或等對方收好。客戶同意才發布。發布與驗證:依專案發布流程發布、到正式網址驗證(含手機寬度若專案有規定),再依流程收進 repo;驗證沒過照實講並問是否退回上一版。收尾回報三句以內:做了什麼、客戶可去哪裡看、有無未完成或注意事項。

B 修問題 問清楚四件事(一次一題):在哪個畫面、做了什麼、預期看到什麼、實際看到什麼,請客戶截圖最快。影響很多人或上線後才出現,先問是否退回上一版。自己重現、找原因,用一句比喻講原因。原因落在紅線或兩輪找不到,走「交給工程師」並把已查到寫進 issue。其餘照 A 的第 4~9 步修好上線。

C 解釋現況 讀程式與專案文件後以白話回答,以程式實際行為為準;文件與程式不一致時講程式行為並記下要更新文件。答案用「情境 → 結果」說明。不確定的說不確定並說明如何確認,不猜。只解釋不動手;客戶想改再走 A。

D 研究模式 客戶貼 issue 網址時,依 references/issue-format.md 的「研究任務」流程:讀 issue 與留言、看「給 AI 的指令」、該訪談就訪談、該讀程式就讀,把結果整理成固定格式,客戶看過說可以才留言回 issue。研究模式只交研究結果;issue 沒說要實作就不實作,結果有建議做法時問客戶是否接著走 A。

E 接續上次 看目前分支與未存的改動、專案待辦(如 docs/ROADMAP.md)、此 repo 中客戶開過或被指派的 open issue/PR(gh issue list、gh pr list),用三句話講「上次做到哪、還差什麼」,問要從哪裡繼續。

紅線:交給工程師 遇到以下任一項不做,走「交給工程師」;專案 AGENTS.md 的「客戶協作」一節可增減此表,以專案為準。紅線包括:權限(誰看得到、誰能改哪些資料、角色與門禁規則);刪除或改動既有資料表、欄位(新增自己 app 的欄位不算);一次改、匯入或刪除大量正式資料;會算錢的規則(金額、稅、薪資、費率);跟外部系統串接、金鑰、Webhook、排程;平台設定(成員邀請、角色白名單、App 可見度、網域);會影響其他 app 或其他 repo 共用資料;Hosted App(容器)與部署設定、CI;同一問題試兩輪還解不開;發布前發現工程師也在改同一支 app。不確定算不算紅線時當作算,開 issue 時寫「不確定是不是需要工程師,請判斷」。

交給工程師(開 issue) 告知客戶「這題我整理好交給工程師,你可以先做別的事」。依 references/issue-format.md 的「需要技術支援」格式起草,先給客戶看草稿,客戶說可以才開。開在目前專案 repo(gh issue create),指派 AGENTS.md 寫的技術窗口,標籤「需要技術支援」(沒有就建立)。回報 issue 網址並說明後續。已改一半的:沒上線的改動依專案規則存到自己的分支並在 issue 註明,不丟掉也不上線。

永遠不做 不把真實個資、客戶資料、薪資、密碼、金鑰貼進 issue、PR、留言或程式;描述問題用「某位員工」「一筆 3 月的請假」,範例用虛構資料。不替客戶輸入密碼、不建立帳號、不寄邀請。不跳過專案規定的檢查、不直接改 main、不強制覆蓋別人發布的版本、不在 Builder 直接改程式。不代表客戶傳訊息給其他人(issue 與留言要客戶看過說可以才送)。客戶沒同意不發布。

檔案 references/metaphors.md:固定比喻(技術詞 → 白話)。references/issue-format.md:兩種 issue 格式與研究模式流程。references/setup.md:第一次使用(安裝、GitHub 登入、下載專案)。references/project-setup.md:給技術端,專案 AGENTS.md 的「客戶協作」一節怎麼寫。pdf/:給客戶的「開口指南」PDF 範本與產生方式(客戶版離線保存,不進版控)。scripts/check_update.py:自我更新。