Community生產力與協作github.com

Lujker/road-map-journal

用於處理專案路線圖、開發計畫、佇列、工作日誌或項目狀態:詢問下一步、繼續或恢復排程工作、記錄決策、更新項目,或比對證據與狀態。遵循專案本身的慣例。觸發詞包括「дорожная карта」、「что дальше по плану?」、「продолжай разработку по плану」、「запиши решение」、「обнови статус пункта」。

road-map-journal 是什麼?

此技能旨在維護一個實用的當前計畫與可追溯的決策記錄,同時尊重並遵循專案既有的慣例與佈局,不強加新的結構。它支援多種操作模式:唯讀(僅查詢不動內容)、初始化(從零建立計畫架構)、採用(整合現有規劃材料)、恢復(繼續未完成的工作)以及更新(修改現有記錄)。技能會自動偵測請求的範圍與模式,並優先使用專案自己的狀態詞彙(如 OPEN、IN PROGRESS 等),若無則可協商建立。它強調基於證據的狀態管理,避免假設或虛構,並要求任何重大變更(如新建檔案、遷移或重寫)都必須先取得使用者明確同意。此技能適用於任何需要結構化任務追蹤與決策記錄的開發環境,特別是當專案涉及多個代理、工作階段或共享程式碼庫時,可提供一致的協作框架。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lujker/road-map-journal/tree/HEAD/skills/road-map-journal

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

路線圖與工作日誌

維護一份實用的當前計畫與可追溯的決策記錄,不強加新的佈局。遵循使用者的指示與專案的慣例。保留現有名稱、識別碼、語言、連結、未提交的變更以及不相關的內容。對於新計畫,使用使用者明確指定或合理暗示的語言;若不清楚則應詢問。不要強加語言。

使用時機

用於涉及路線圖、開發計畫、佇列、工作日誌、項目狀態或繼續排程工作的請求。範例包括「路線圖上接下來要做什麼?」、「繼續已同意的項目」、 «дорожная карта»、 «план разработки»、 «дневник разработки»、 «что дальше по плану?» 以及 «продолжай разработку по плану»。從上下文判斷要求的範圍;狀態查詢是唯讀的。

首先探索

識別專案根目錄並閱讀其說明。找出既有的路線圖、佇列、項目筆記與交接文件;名稱與位置可能各異。閱讀相關項目、其驗收標準、當前佇列以及連結的筆記。檢查相關的實作、版本控制狀態(若可取得),以及當請求需要評估當前狀態時的證據。不要假設使用 Git、特定目錄結構或特定的狀態詞彙。對於多個儲存庫,請遵循現有的連結;若無法存取權威位置,則詢問使用者,而非自行發明替代方案。

根據請求選擇對應的模式:

  • 唯讀: 根據相關文件與證據回答。區分記錄中的宣稱與經獨立查證的事實;不做任何編輯。
  • 初始化: 若尚無計畫,與所有者討論其偏好的工作方式,並提議合適的結構、位置、範圍、初始項目及其排序;必要時包含軌道、代理角色與初始卡片。如需深入探索,若可用且適當,使用 grill-me;若無,則提議安裝它,但未經許可不得安裝或阻擋工作流程。否則自行促成簡潔的結構化討論,並針對未解決的選擇提供建議。在建立檔案前取得使用者知情同意;不要憑空發明優先級或承諾。
  • 採用: 若規劃材料已存在,直接就地使用。當所有者要求進行全面檢視時,使用與初始化相同的可選結構化討論,但僅針對未解決的部分。解釋任何提議的新檔案、遷移或大幅重寫,並先取得知情同意。不要默默建立一個平行的真相來源。
  • 恢復: 讀取最新的指令、作用中佇列、項目筆記以及相關的當前狀態。針對當前證據與使用者最新的決策,解決矛盾或過時的指示;若仍有重大衝突則應詢問。若項目尚未選定或委派,請在實作前先協商確定一個。已儲存的計畫或批准文件不構成開始工作的授權。
  • 更新: 根據請求對現有記錄進行限定範圍的變更。保持項目的狀態、剩餘工作以及受影響的佇列條目一致;保留歷史記錄與不相關項目的排序。對於新建檔案或大幅重寫,請解釋提議的變更並先取得知情同意。僅限於某個項目的請求並不授權實作或重寫計畫的其餘部分。

記錄與協調

使用專案既定的安排。通常,路線圖總結項目及其當前順序;工作日誌則記錄決策、發現、證據與歷史。使用連結而非重複長篇細節。保持識別碼穩定。不要默默刪除決策或已取消的工作:將它們標記為已取代或已取消,並在相關時提供原因。

當決策、暫停或順序變更時,在授權範圍內更新受影響的當前摘要與後續步驟指示;將先前的指示標記為歷史。暫停或延期的計畫不得顯示為活躍的繼續指示。不要僅僅因為新增了一則筆記就重新排序不相關的工作。若必要的修正超出授權範圍,應向使用者提出標記,而非擴大編輯範圍。

除非所有者已授權更廣泛的範圍,否則一次只處理一個項目,且不自動開始下一個。完成的子階段不代表完成了父項目的完成;記錄剩餘部分。將工作模式與權限和預算分開:繼續工作的授權並非全面性的生產環境操作或外部寫入的許可。保持已記錄完成、待使用者驗收以及已完全接受的工作之間有所區分。在交接點、決策點、已驗證的結果與阻礙點處保持簡潔的檢查點,包含剩餘事項與如何恢復;在重複執行前,先驗證不確定的進行中動作。在共享檢出目錄中進行多檔案更新前,應在寫入前立即檢查版本控制狀態與髒路徑,針對剛讀取的內容進行狹義編輯,保留不相關的工作,並在未經授權的情況下驗證限定範圍的變更,但不提交或發布。

對於跨越數個項目、代理或工作階段、有預算、或所有者授權軌道或連續模式的工作,請先閱讀長時間執行工作。

狀態與證據

使用專案的狀態詞彙。若無,則建議使用 OPEN、IN PROGRESS、BLOCKED、PARTIAL 以及 DONE,並為專案協商其含義。根據驗收標準與實際證據(而非意圖或代理的未經證實宣稱)記錄狀態。對於 PARTIAL,應說明剩餘事項與任何阻礙。保持受影響的狀態參考一致。

記錄實際執行的檢查、其結果與範圍,以及相關時由誰執行。證據可能是歷史性或來自其他執行者;應標示其來源與適用性,且不得暗示已重新執行。若後續變更使某項檢查失效,請識別或執行適當的驗證。切勿發明指令、結果、測試計數、核准或用戶驗收。自動化測試、已發佈的程式碼以及正式運作是截然不同的宣稱:切勿從實作或測試推斷出運作中的驗收。若所需的驗收尚未發生,保留 PARTIAL 或專案的對等狀態,並說明缺少的環境或核准。

在授權編輯後,檢查受影響的狀態、佇列、連結,以及與證據和範圍的一致性。報告所做的變更、實際執行的檢查以及未解決的項目。不得宣稱未執行的驗證。

參考資料

  • 通用範本 — 可選的起點,需根據專案調整。
  • 情境範例 — 關於模式與範圍選擇的簡潔範例。
  • 長時間執行工作 — 軌道、檢查點、暫停與停止、驗收、預算、共享檢出。
  • 多儲存庫協調 — 保留工作並在跨檢出目錄中區分已記錄、Git 與執行中的狀態。

相關技能