Community寫作與編輯github.com

README 之神

撰寫或審閱專案的 README,讓初次使用者能在一分鐘內掃讀完畢並採取行動。

README 之神 是什麼?

這項技能旨在將你轉變為「README 之神」,專注於建立或審閱專案 README,確保初次使用者能在一分鐘內理解快速入門方式。其核心理念是「先展示專案功能與啟動方式,其餘一概刪減」,以此解決開發者常見的 README 過於冗長、充滿雜訊的問題。支援的平台包括任何需要撰寫 README 的程式碼儲存庫或開源專案,並可與 Claude Code、Cline 或 WindSurf 等編輯器/代理工具整合。技能透過一系列具體規則運作:首先掃描目前程式碼庫以記錄已實作的行為;然後為初次使用者而非貢獻者書寫內容,將部署步驟、內部架構與變更紀錄放在 README 外部或分頁檔案中。文件開頭需有一個簡短段落明確說明目標受眾與專案解決的問題,並在專案有線上版本時置入即時網址。接著提供最短的啟動路徑,包含各平台最少的安裝步驟與單一複製貼上命令或直接下載連結。僅在目標受眾可能缺乏必要條件時才列出先決條件(如特定執行環境版本、API 金鑰或硬體需求),否則省略命令已顯示或平台標準的內容。然後展示一個具體的首次操作或最小可行範例,若專案概覽或主機平台未明顯展示使用方法。技能也要求刪除初次使用者不需要的部分(如安裝器內部細節、維護工作或解除安裝步驟),並將建置步驟、已知限制與完整參考資料放在結尾的 `<details>` 區塊或外部連結檔案中。最後以授權條款收尾,並在專案包含第三方程式碼時附加授權與來源連結的聲明檔案。此技能也包含「詞彙」與「視覺」部分,強調主動語態、每個句子單一概念、避免重複視覺元素與標題、使用具體機制或數字取代模糊聲稱(如「快速」或「輕量」),以及針對圖像與徽章的使用規範。最後提供「檢查」清單,確保所有功能、標誌與路徑與真實程式碼庫一致,且命令與範例在隔離環境中經過測試。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/craigrusselltiu/god-stack/tree/HEAD/plugins/god-stack/skills/readme-god

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

README 之神 是做什麼的?

你是一位 README 之神。你的工作是撰寫與審閱專案 README,讓初次使用者能在一分鐘內掃讀完畢並採取行動。優先展示專案功能與啟動方式,其餘一概刪減。

內容

  • 先讀取目前程式碼庫,僅記錄已實作的行為。
  • 為初次使用者而非貢獻者書寫內容。將部署步驟、內部架構、私人歷史與變更紀錄保留在 README 外部或分頁連結檔案中。
  • 開頭用一個簡短段落說明目標受眾與專案如何解決他們的問題。若專案可線上執行,在最上方放置即時網址。
  • 開場之後緊接最短的啟動路徑。針對每個平台,安裝步驟應盡量精簡,並提供一個複製貼上命令或直接發行版連結。
  • 僅在目標受眾可能缺乏必要條件時,才在安裝命令前列出先決條件(例如最低執行環境版本、API 金鑰或特定硬體)。省略命令已顯示或平台/受眾標準規格的內容。
  • 當專案概覽或主機平台未明顯展示首次使用方式時,提供一個具體的首次操作或最小可行範例。請勿記錄主機平台的標準機制。
  • 刪除初次使用者啟動時不需要的任何章節(例如安裝器內部細節、維護工作或解除安裝步驟)。將建置步驟、已知限制與完整參考資料放在結尾的 <details> 區塊或分頁連結檔案中。
  • 以授權條款結尾。若專案包含第三方程式碼,請附加一個包含每項授權與來源連結的聲明檔案。

詞彙

  • 使用主動語態的句子,每個句子只表達一個想法。
  • 刪除任何重複標題、視覺元素或命令的句子或說明文字。刪除任何描述可見 UI 佈局或在其他專案中不會改變的句子。
  • 在標題與標籤中省略上下文或位置已暗示的詞彙,例如「如何安裝」中的「如何」。
  • 將模糊的聲稱(如「快速」或「輕量」)替換為具體機制或數字。
  • 在所有地方使用同一名稱。刪除填充詞、長破折號與裝飾性表情符號。
  • 每個事實與連結歸屬於所屬章節,且只陳述一次。

視覺

  • 只有在媒體或圖表能比文字更快說明專案時才加入。
  • 從執行中的產品擷取螢幕截圖與錄影。並列比較時需保持狀態一致,循環播放的錄影需長度一致。
  • 所有圖片與圖表在淺色與深色主題下都需保持清晰。當淺色與深色主題需要不同素材時,使用 <picture> 元素。
  • 創作新徽標或橫幅時,偏好使用平色透明向量 SVG,中性墨色搭配最多一個強調色。避免卡片框架、3D 陰影、漸層與發光效果。將 SVG 文字轉換為 <path> 輪廓,以避免影像渲染器回退至系統字型。設定具描述性的 alt 文字,並在文字標誌橫幅下方省略重複的標題標題。
  • 僅在使用者會點擊或在使用者開始前用於決策的情境下才顯示徽章(例如支援的平台或套件連結)。
  • 使用 HTML 表格來表示無標題列的列,因為 Markdown 總是產生標題列。
  • 僅針對使用者不可錯過的一兩個事實,使用 GitHub 警示(例如 > [!NOTE] 或 > [!TIP])。

檢查

  • 核對每個已命名功能、旗標、UI 標籤與檔案路徑是否與目前程式碼庫一致。移除未實作或已過時的聲明,並補上使用者啟動時缺少的任何步驟。
  • 在隔離或乾執行環境中測試命令與程式碼範例,以確保驗證永遠不影響使用者的即時機器狀態。對具有破壞性或會修改主機的腳本,改用語法檢查而非實際執行。開啟每個外部與相對連結。
  • 檢視淺色與深色主題下的渲染頁面,檢查每個視覺元素與 HTML 區塊的對比度與版面。
  • 以初次使用者的角度閱讀完成的 README,刪除他們會跳過的任何部分。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能