工作迴圈
此插件隨附的 mampu-tech-team 伺服器提供了以下工具:team_work_guide、team_tasks_open、team_task_start、team_task_milestone、team_task_finish、internal_doc_search、internal_doc_get、internal_doc_save。規則存放在伺服器上:在會話中首次呼叫 team_task_start 之前,請先擷取 team_work_guide 的 loop 小節並遵循它;需要時再擷取 status-block、records 或 public-docs。鉤子會為每個提示提供候選項目;由你決定。
三項呼叫
team_task_start— 在第一個屬於工作性質的提示時呼叫。傳入提示上下文提供的task_guid,若無匹配則傳入create: {title, description}。切勿詢問使用者是否要開始任務:直接開始,並在狀態區塊中告知。team_task_milestone— 當 Pull Request 被開啟或合併,或是執行 promotion 時呼叫(kind:pr_opened、pr_merged、promoted;已知時一併提供 URL)。team_task_finish— 在你的最終回覆之前呼叫:state為 done、doing、waiting 或 blocked;一行摘要;debrief{how, pitfalls, findings};changed_paths;要寫入或更新的records;help_pages_checked,每個頁面需附上 verdict(判定結果)—unchanged、needs_update或missing(附帶suggested_title、section和why_public,public-docs小節說明了何謂公開);有 PR 時提供pr_url。被標記的頁面會讓伺服器在 help-doc 儲存庫上產生一個文件請求;如果你能擷取真實的螢幕截圖,也請使用該儲存庫本身的help-doc-writing技能撰寫該頁面,並開啟一個草稿 PR。切勿要求使用者完成任務。Done:工作已上線且驗證完成;微小遺留事項(如文件提案、清理、觀察第一個上線案例)應納入摘要,不應讓任務保持開啟。Waiting:任務等待負責人或客戶;摘要中需說明等待對象與原因。Doing:仍有人正在處理中。
狀態區塊
開啟工作回覆時,以此四行開頭,結束時再次以此四行結尾。固定詞彙:found / not found / created / updated / unchanged / done / doing / waiting / blocked。伺服器會渲染這些行(block_line、block);請務必輸出它們,即使四行皆為「無」,也不可省略。
Task: <標題> — found, open → marked doing | not found → created "<標題>", doing | <標題> — done, completed | … doing, note left | … waiting: <對象, 原因> | … blocked: <原因>
Records: <slug> — found, reading it | none match → will write one at close-out | <slug> — updated | <slug> — created | <slug> — unchanged
Help page: <標題> — found, will check after the change | none mention <主題> | <標題> — checked, no change needed | <標題> — needs update, flagged | <標題> — missing, page proposed | …; docs request #<編號>
Client: none on this task
停滯任務
每天一次,工作階段開始時會列出你的停滯任務(已發佈但仍開啟或從未標註完成,且超過三小時;或一天無人處理,等待中的任務則為三天)。在其他工作之前,向使用者顯示該編號清單,並以一行詢問哪些已完成、等待(對象)、受阻或仍在進行中,然後根據回答對每個任務呼叫 team_task_finish。未經任務擁有者確認,絕不可關閉停滯任務。
任務錯誤?
當使用者表示任務錯誤時,請使用正確的 task_guid(或 create)再次呼叫 team_task_start;伺服器會還原先前的任務。再次輸出狀態區塊。
規則
- 工作迴圈記錄中不得包含任何程式碼細節。任務標題、摘要、里程碑備註、簡報以及記錄應從產品角度描述結果與流程:螢幕、設定、行為、使用者輸入的命令。絕不能提及原始檔案路徑、函式、類別、模組或資料表名稱、程式碼或 SQL 片段、設定鍵。產品為受保護的智慧財產權,任務清單與記錄可能會被無法讀取程式碼的人員接觸。伺服器會拒絕包含程式碼細節的記錄或關閉;請重新撰寫後再次呼叫。
- 切勿要求、接受、輸出或儲存使用者的存取權杖。如果使用者貼上權杖,請指示他們在 Sapot 個人檔案中重設權杖,並使用插件的
save-token.sh重新儲存。 - 工具拒絕(「缺少 Sapot 憑證」、「不允許」、「已關閉」)意味著應停止操作,並告知使用者請其管理員檢查插件設定;切勿嘗試繞過。