Community程式設計與開發github.com

Dev-PGVAA/skills

解釋程式庫中行為的位置、建立或重新整理以證據為基礎的架構圖,或以 Mermaid 或 draw.io 繪製真實元件關係。適用於程式庫導覽與架構圖表。

skills 是什麼?

這個技能旨在協助開發者與 AI 代理程式快速理解一個大型程式庫的組織結構、行為分佈以及元件關係。它提供三種主要工作模式:快速定位特定功能或檔案的「位置查詢」模式、根據參考文件(`orient` 與 `diagram`)建立或更新持久性地圖或架構視覺圖的模式。此技能特別強調以「證據」為基礎:它會區分原始碼證據、宣告式配置以及觀察到的執行期行為,並明確記錄檢查過的檔案範圍與尚未確定的部分。支援的平台包括所有能執行 `orient` 與 `diagram` 參考腳本的環境(例如 CLI 工具或 AI 代理框架),它利用平行探索策略在大型程式庫中獨立掃描不同的領域區塊(如 API、worker、UI),再由父級代理進行索引整合與邊界驗證,最後輸出真實的檔案路徑、符號、進入點與依賴關係。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Dev-PGVAA/skills/tree/HEAD/codebase-map

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

程式碼地圖

找到使用者任務所需的程式碼,並在要求時保留有用的導覽資訊。區分原始碼證據、宣告式配置和觀察到的執行期行為。

根據要求的產出選擇路線

  • X 在哪裡/快速導覽: 讀取相關的現有地圖,並根據檢出的路徑進行驗證。用簡短的流程和進入點連結回答;不需要寫文件。
  • 建立/重新整理持久性地圖: 使用 orient。保留現有的文件佈局和本地指示。
  • 架構視覺圖: 使用 diagram。可以在不先生成文件套件的情況下,透過專注的原始碼掃描來產生圖表。

平行探索

對於大型程式庫,委派獨立的有限區域(例如 API/認證、工作者/資料、UI/導覽)。每個搜索任務都是唯讀的,並傳回真實的路徑/符號、進入點、帶有證據的依賴關係、不確定性以及檢查的確切修訂版。不要要求每個搜索任務掃描整棵樹。

父任務擁有索引、共用文件和跨區域的連線。在寫入之前,驗證邊界陳述、去重,並調和矛盾的名稱。如果代理程式不可用或範圍很小,則以序列方式執行相同的聚焦探索。只有當委派能節省工作量時才有用;切勿為每個檔案建立一個代理程式。

證據與完成

套件的存在並不證明它會在生產環境中執行;匯入並不能證明網路部署。記錄檢查了什麼以及尚有哪些未知。使用可用的工具驗證所有交付的本地連結和圖表來源語法。報告實際驗證結果和最好的起始檔案,而不是整個程式庫列表。

回答的語氣

先說重點。不要有開場鋪陳、不要「不是 X 而是 Y」、不要聊天殘留、不要強調重要性。短句與長句並列。事實和限定詞要保持與證據相符的強度。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能