Community生產力與協作github.com

Pu11en/sysmap

透過可點擊的儲存地圖來規劃與說明系統。適用於協作設計、延續規劃對話、系統說明或準備已達共識的實作計畫。將設計相關問題保留在對話中。

sysmap 是什麼?

此技能提供一個結構化方法,用於建立、維護及共同開發系統的互動式地圖。它強制在開始實作前先進行規劃,並將設計討論保留在聊天中,而非地圖上。地圖本身使用 `.plan.json` 格式,記錄系統的行為與元件,而所有討論、決策及未解決的問題則在原地圖之外的對話中進行。該技能支援多種平台,並遵循一份詳細的規劃指南,定義來源格式、零件記錄、導航及檢查項目。對於 AI 代理使用者來說,這項技能至關重要,因為它能確保規劃過程嚴謹、以證據為基礎,並與實作明確分離,從而避免常見的陷阱,例如在規格不明確的情況下就開始編碼,或在規劃過程中引入未經授權的實作。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pu11en/sysmap/tree/HEAD

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

在你喜歡的 AI 中提問

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

說明文件

透過系統地圖進行規劃

在開始繪製或建構之前,先建立共同的理解。地圖顯示系統行為;對話則容納討論。規劃絕不授予實作產品的權限。

在開始或恢復規劃之前,請先閱讀規劃指南。它定義了來源格式、零件記錄、導航及檢查項目。有關輔助工具設定與命令,請閱讀 README。

從證據開始

延續對話中唯一儲存的 .plan.json 來源。閱讀其目標、決策、未解決的問題以及目前的規劃位置。在描述現有行為之前,先檢查相關的專案證據。當來源很大時,僅載入目前零件及其相鄰零件。

對於新的對話,請選擇一個獨特且具描述性的來源名稱。切勿覆蓋其他對話的計畫。來源計畫具有權威性;所產生的圖形與清單並非可編輯的計畫。

區分經過驗證的事實、已同意的計畫、未知事項以及未被接受的提議。引用證據。切勿從模糊的標籤推斷先前的決策,或為了填補漏洞而編造事實。

在繪製前先定義意義

對於每個零件,記錄其單一職責、輸入、工作、結果、規則、下一個接收者、邊界及證據。使用指南中定義的欄位名稱。

將儲存與動作分開。區分等待狀態與工作。將每個結果連接到下一個零件預期的輸入。透過連接的零件走一個具體的範例。

使用簡短的標籤和具名箭頭。子頁面說明其父零件。透過明確的 detail 目的地連接它們,切勿使用相符的名稱或猜測的連結。將工具選擇、設計問題及關於已移除功能的評論排除在圖形之外。

協作與推進

先回答當前的問題。在提出另一個問題之前,先閱讀已確定的決策。明確要求的變更會更新來源,同時保留不相關的決策。協議僅接受實際顯示的提案。

在解決一個問題後,繼續朝下一個有意義的未解決零件前進。解釋其目的,提出有根據的方法,然後在會改變設計時,提出一個具體的選擇。不要將規劃變成面試,或在「已儲存」處就停止。

將次要的預設值標記為提案。切勿在未明確討論的情況下決定權限、隱私、成本或事實證據。在推進之前先解決混亂。如果沒有實質性的決策遺留,總結準備情況,並提供審查或另行授權的實作。

在聲稱完成前先行檢查

在變更計畫後,建置它並檢查受影響的連接及子頁面的意義。如果可以存取瀏覽器,也請檢查圖形與導航。誠實地報告無法執行的檢查。

輔助工具測試會檢查結構與產生的輸出,但不會檢查系統的真實性、實際的瀏覽器互動或與每個代理程式框架的相容性。

相關技能