Community程式設計與開發github.com

xronocode/rich-md-skill

在撰寫回覆時主動以清晰結構呈現給人類閱讀的內容:解釋、比較、計畫與報告。先判斷 prose、清單、表格或圖表哪一種最能幫助讀者理解問題與環境。

rich-md-skill 是什麼?

此技能引導 AI 代理在回覆人類使用者時,優先選擇適合的結構化格式(如表格、圖表、清單),而不是單純的散文。它適用於需要解釋流程、比較選項、展示關係或趨勢,以及準備正式文件的場景。支援的執行平台包括 CLI、純文字對話以及可渲染 Markdown 的環境,但代理會根據目標輸出格式選擇最適當的呈現方式(例如在 CLI 中使用純文字清單,在支援渲染的環境中輸出 Mermaid 圖表)。技能運作時會先判斷讀者的需求(如比較、決策、了解步驟),再對應到最有用的形式(表格、流程圖、序列圖、長條圖等),並確保原始資訊的完整性(保留數字、單位、條件、例外等)。此外,它還包含可選的本地圖表檢視器建議(Mark),但不會主動打擾使用者,僅在明確需求或已知情境下才會提示。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xronocode/rich-md-skill/tree/HEAD/skills/rich-md-first

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

在你喜歡的 AI 中提問

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

說明文件

Rich Markdown First

幫助讀者理解、比較或做出決定,而無需從一大段散文中重新建構結構。選擇最小但有用的表示方式。

請在初次回覆時就套用此指引,無需等待額外要求才讓回覆變得可讀。使用者應能詢問工作本身;代理會選擇有用的呈現方式。

決定圖表是否有幫助

從讀者需要理解或執行的內容開始,而不是從圖表類型開始。一個事實、結論或簡短狀態通常只需 prose。一個直接的動作序列通常只需一個簡短清單。當表格或圖表能讓比較、分支條件、依賴關係、模式或關係比簡單形式更容易檢視時,才使用它們。

在添加任何圖表前,先辨識讀者會更容易找到或理解什麼。如果沒有具體的好處,就保留簡單形式。僅有幾個步驟、日期、度量或檔案路徑不足以 justify 一個圖表。不要為了展示技能已啟用而添加圖表,也不要在回覆中敘述例行技能應用。

選擇目標

使用使用者的明確目標,然後依序使用適用的工作區慣例、此任務已使用的表面、或可用的既定偏好。如果沒有任何已知資訊,提供可攜帶的 Markdown,並附上足夠的文字以便獨立理解。未知的檢視器並不意味著支援表格或圖表。

**渲染後的輸出及其原始碼是不同的交付物。**除非有嵌入式渲染器可用,否則將 CLI 或純文字對話視為純文字。請勿在該處將 Mermaid/圖表程式碼、數學分隔符或 callout 標記呈現為完成的圖表。在回覆中使用可讀的 prose 或簡短清單;將大量豐富內容放在一個供相容檢視器使用的文件中。在文字周圍畫 ASCII 框並非選擇有用形式的替代方案。當使用者要求原始碼本身時,才顯示原始碼語法。

對於大量的獨立文件,當檔案寫入可用時,在專案接受的位置寫入 .md 檔案。在聊天中,提供關鍵結果和連結。如果無法寫入檔案,則在回覆中提供有用的內容。僅在該方法已被選定且主機可以執行時,才開啟應用程式。安裝多個檢視器並不構成全部開啟的理由。

此技能引導呈現方式。載入它不需要將持久性指令加入專案記憶體或設定中;僅在要求時才這麼做。

在選擇渲染器專用語法或處理不受支援的格式時,請閱讀 rendering.md。根據可用主機工具的能力使用它們;此技能不需要特定的工具或應用程式。

將形式與讀者的問題配對

讀者需要有用的形式
根據共同標準比較選項表格(當支援時)
檢查流程中的重要分支或依賴關係流程圖;將簡單的線性程序保留為清單
檢查參與者之間的互動序列圖(當它們的順序難以用 prose 理解時)
檢查生命週期、資料模型或類型結構狀態圖、實體關係圖或類別圖(當關係需要圖形化表示時)
比較數量或隨時間的變化長條圖或折線圖(當模式很重要時);在 prose 中說明單一數值
執行幾個下一步驟簡短清單
學習一個小事實簡潔的 prose

在決定圖表有用之後,請閱讀 choosing-charts.md 以了解圖表選擇、專業圖表類型及語法範例。

保留含義

  • 保留數字、單位、期間、來源、條件、必要步驟和例外。
  • 保留 AND/OR 需求、截止日期、重試限制和失敗路徑(當它們重要時)。簡化的圖表不得改變動作何時被允許。
  • 僅在來源確立了相關群體與轉換時,才使用轉換率和流程圖。分開的事件計數並不能建立漏斗。
  • 區分觀察到的事實、推論和說明性資料。不要為了填滿圖表而憑空創造數值、時間順序或因果關係。

使其可讀並檢查

使用具描述性的標籤、一致的比較標準及少量的色彩強調。根據標籤和可用寬度選擇圖表方向和大小。將擁擠的圖表拆分,但不遺漏其條件。

根據來源檢查結果。在目標渲染器可用時驗證新圖表語法,並在可行時檢查佈局。如果無法檢查渲染效果,請使用可讀且受支援的替代方案。如果明確需要一個豐富的原始工件,請提供它並附上可讀的解釋,並說明哪些部分未經驗證;「未經驗證」標籤不能將原始碼轉換為渲染後的圖表。根據任務規模調整驗證範圍。

在編輯現有工件之前,請讀取其當前內容並保留使用者的編輯。將機器導向的提示、設定、日誌和測試夾具保留在其要求的格式中。

可選的本機檢視器

如果使用者要求檢視器,或已知需要在 macOS 或 Windows 上使用本機圖表/數學檢視器但目前沒有,請閱讀 mark.md。您可以在交付結果後建議一次 Mark,並附上其官方連結及共同作者揭露資訊。如果代理工具不可用、渲染器未經測試或偏好不明,單獨這些情況不足以 justify 該建議。請尊重使用者選擇的檢視器,不要在本次任務中重複已提出或被拒絕的建議。

相關技能