Communitygithub.com

ship-change-develop

在 develop 分支上按照專案規定完成變更提交:執行 yarn verify、語意化版本號、更新 CHANGELOG、按名稱暫存檔案、在主旨中加入版本號,然後推送。每當變更準備好提交時使用。

ship-change-develop 是什麼?

此技能定義了針對 karolinakita-ux/portfolio 專案在 `develop` 分支上提交變更的嚴格工作流程。它整合了驗證、版本號選擇、變更日誌撰寫、精確的檔案暫存以及提交訊息格式化等步驟,確保每次提交都符合專案的貢獻規範。使用者只需描述變更內容,該技能便會引導其完成整個流程:從 `yarn verify`(型別檢查、Lint、Prettier、測試、建置)開始,然後根據變更影響判斷語意化版本(major/minor/patch),依格式更新 `CHANGELOG.md`,最後使用包含版本號的提交訊息提交指定的檔案並推送。此外,還要求將每個變更的單元(檔案、函式、分支)與其對應的測試明確列出,以確保測試覆蓋率。此技能與任何支援 Claude Code、Cursor 或 Codex 等 AI 代理的環境相容,因為它完全基於 Markdown 指令與 CLI 操作。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/karolinakita-ux/portfolio/tree/HEAD/.claude/skills/ship-change

在你喜歡的 AI 中提問

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

說明文件

在 develop 上提交變更

每次提交都對應一個版本。CONTRIBUTING.md 中的規則(「每次提交」);簡要說明如下:

  1. 驗證。 執行 yarn verify(型別檢查、Lint 零警告、Prettier 檢查、測試、含預渲染的建置)。修正程式碼本身,而非繞過規則:若要例外,必須在 -- 後面加上單行停用與原因說明。
  2. 檢查工作目錄。 執行 git status。使用者可能還有未完成的編輯:僅列出此變更有更動的檔案。其餘檔案保持未暫存狀態。
  3. 提交前選擇版本號(讀取 package.json 中的 version 以及 CHANGELOG.md 的開頭,且是現在的最新值,而非之前的值):
    • major:移除或重新命名頁面、改變網址、重新設計
    • minor:新增可見內容或功能
    • patch:修正、文案、圖片、樣式、依賴、設定、測試、文件
  4. 更新變更日誌。 在唯一的 ## Unreleased 標題下方新增 ### X.Y.Z - YYYY-MM-DD(若此標題在釋出後已消失,則將其加在最新的 ## Release 上方),並包含 Added / Changed / Fixed / Removed 群組,每個群組為一行純文字,僅使用短連字符。
  5. 提交 列出的檔案 (按名稱):執行 git commit -- <files>,主旨為 <變更內容(祈使句) (X.Y.Z)>,加上簡短說明內文,若由 Claude 撰寫則加上共同作者標記。
  6. 檢查提交 核對訊息:執行 git show --stat HEAD。然後推送至 develop。

在提交之前,請列出每個變更的單元(檔案、函式、分支),並標明涵蓋該單元的測試。若有未經測試的分支,必須補上測試,或在回覆中附註說明。

Individual skills in this repo

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

相關技能