路線圖與工作日誌
維護一份實用的當前計畫與可追溯的決策記錄,不強加新的佈局。遵循使用者的指示與專案的慣例。保留現有名稱、識別碼、語言、連結、未提交的變更以及不相關的內容。對於新計畫,使用使用者明確指定或合理暗示的語言;若不清楚則應詢問。不要強加語言。
使用時機
用於涉及路線圖、開發計畫、佇列、工作日誌、項目狀態或繼續排程工作的請求。範例包括「路線圖上接下來要做什麼?」、「繼續已同意的項目」、 «дорожная карта»、 «план разработки»、 «дневник разработки»、 «что дальше по плану?» 以及 «продолжай разработку по плану»。從上下文判斷要求的範圍;狀態查詢是唯讀的。
首先探索
識別專案根目錄並閱讀其說明。找出既有的路線圖、佇列、項目筆記與交接文件;名稱與位置可能各異。閱讀相關項目、其驗收標準、當前佇列以及連結的筆記。檢查相關的實作、版本控制狀態(若可取得),以及當請求需要評估當前狀態時的證據。不要假設使用 Git、特定目錄結構或特定的狀態詞彙。對於多個儲存庫,請遵循現有的連結;若無法存取權威位置,則詢問使用者,而非自行發明替代方案。
根據請求選擇對應的模式:
- 唯讀: 根據相關文件與證據回答。區分記錄中的宣稱與經獨立查證的事實;不做任何編輯。
- 初始化: 若尚無計畫,與所有者討論其偏好的工作方式,並提議合適的結構、位置、範圍、初始項目及其排序;必要時包含軌道、代理角色與初始卡片。如需深入探索,若可用且適當,使用
grill-me;若無,則提議安裝它,但未經許可不得安裝或阻擋工作流程。否則自行促成簡潔的結構化討論,並針對未解決的選擇提供建議。在建立檔案前取得使用者知情同意;不要憑空發明優先級或承諾。 - 採用: 若規劃材料已存在,直接就地使用。當所有者要求進行全面檢視時,使用與初始化相同的可選結構化討論,但僅針對未解決的部分。解釋任何提議的新檔案、遷移或大幅重寫,並先取得知情同意。不要默默建立一個平行的真相來源。
- 恢復: 讀取最新的指令、作用中佇列、項目筆記以及相關的當前狀態。針對當前證據與使用者最新的決策,解決矛盾或過時的指示;若仍有重大衝突則應詢問。若項目尚未選定或委派,請在實作前先協商確定一個。已儲存的計畫或批准文件不構成開始工作的授權。
- 更新: 根據請求對現有記錄進行限定範圍的變更。保持項目的狀態、剩餘工作以及受影響的佇列條目一致;保留歷史記錄與不相關項目的排序。對於新建檔案或大幅重寫,請解釋提議的變更並先取得知情同意。僅限於某個項目的請求並不授權實作或重寫計畫的其餘部分。
記錄與協調
使用專案既定的安排。通常,路線圖總結項目及其當前順序;工作日誌則記錄決策、發現、證據與歷史。使用連結而非重複長篇細節。保持識別碼穩定。不要默默刪除決策或已取消的工作:將它們標記為已取代或已取消,並在相關時提供原因。
當決策、暫停或順序變更時,在授權範圍內更新受影響的當前摘要與後續步驟指示;將先前的指示標記為歷史。暫停或延期的計畫不得顯示為活躍的繼續指示。不要僅僅因為新增了一則筆記就重新排序不相關的工作。若必要的修正超出授權範圍,應向使用者提出標記,而非擴大編輯範圍。
除非所有者已授權更廣泛的範圍,否則一次只處理一個項目,且不自動開始下一個。完成的子階段不代表完成了父項目的完成;記錄剩餘部分。將工作模式與權限和預算分開:繼續工作的授權並非全面性的生產環境操作或外部寫入的許可。保持已記錄完成、待使用者驗收以及已完全接受的工作之間有所區分。在交接點、決策點、已驗證的結果與阻礙點處保持簡潔的檢查點,包含剩餘事項與如何恢復;在重複執行前,先驗證不確定的進行中動作。在共享檢出目錄中進行多檔案更新前,應在寫入前立即檢查版本控制狀態與髒路徑,針對剛讀取的內容進行狹義編輯,保留不相關的工作,並在未經授權的情況下驗證限定範圍的變更,但不提交或發布。
對於跨越數個項目、代理或工作階段、有預算、或所有者授權軌道或連續模式的工作,請先閱讀長時間執行工作。
狀態與證據
使用專案的狀態詞彙。若無,則建議使用 OPEN、IN PROGRESS、BLOCKED、PARTIAL 以及 DONE,並為專案協商其含義。根據驗收標準與實際證據(而非意圖或代理的未經證實宣稱)記錄狀態。對於 PARTIAL,應說明剩餘事項與任何阻礙。保持受影響的狀態參考一致。
記錄實際執行的檢查、其結果與範圍,以及相關時由誰執行。證據可能是歷史性或來自其他執行者;應標示其來源與適用性,且不得暗示已重新執行。若後續變更使某項檢查失效,請識別或執行適當的驗證。切勿發明指令、結果、測試計數、核准或用戶驗收。自動化測試、已發佈的程式碼以及正式運作是截然不同的宣稱:切勿從實作或測試推斷出運作中的驗收。若所需的驗收尚未發生,保留 PARTIAL 或專案的對等狀態,並說明缺少的環境或核准。
在授權編輯後,檢查受影響的狀態、佇列、連結,以及與證據和範圍的一致性。報告所做的變更、實際執行的檢查以及未解決的項目。不得宣稱未執行的驗證。