Community寫作與編輯github.com

metyatech/skill-release-publish

代理技能,用於管理技能發布與 npm 套件發佈流程

skill-release-publish 是什麼?

此代理技能專為自動化處理軟體發布與 npm 套件發佈流程而設計。它確保公開儲存庫具備完整的社群規範文件(如 issue 模板、PR 模板、SECURITY.md 等),並自動設定 GitHub 描述、主題與首頁。在版本管理方面,代理會自行決定版本號,同時更新套件版本與 Git 標籤,並在單一操作中完成 GitHub Release 建立與 npm 套件發佈。對於 metyatech 旗下的套件,代理可直接執行 `npm publish`;其他則引導使用者自行操作。發佈前會執行必要的準備命令與安全性檢查,並在發佈後進行驗證,包含確認註冊表版本、測試全新安裝與全域更新(若適用)。此技能支援 GitHub、npm 生態,並整合標準儲存庫主題分類,適合維護多個開源或內部套件發布管線的開發團隊。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add metyatech/skill-release-publish

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

在你喜歡的 AI 中提問

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

說明文件

發布與發佈工作流程

公開儲存庫中繼資料

  • 對於公開儲存庫,代理必須設定 GitHub 的描述、主題與首頁欄位。
  • 公開儲存庫必須包含:.github/workflows/ci.yml、問題模板、PR 模板、SECURITY.md、CONTRIBUTING.md、CODE_OF_CONDUCT.md 以及 CHANGELOG.md。
  • CI必須執行儲存庫標準的 lint、測試與建置命令。

版本管理與發佈流程

  • 當發佈內容變更時,代理必須更新版本中繼資料,並必須保持套件版本與 Git 標籤一致。
  • 當要求選擇版本時,代理必須自行決定。
  • 升級版本時,代理必須在同一更新中建立 GitHub Release 並發佈套件。
  • 對於 metyatech 所擁有套件的 npm 發佈,代理必須直接執行 npm publish。已設定自動化令牌。
  • 對於其他套件,代理必須要求使用者執行 npm publish。
  • 發佈前,代理必須執行必要的準備命令(npm install、npm test、npm pack --dry-run 等),並必須在準備就緒後才繼續。
  • 若發佈時驗證失敗,代理必須要求使用者完成發佈步驟。
  • 代理必須在發佈前執行相依性安全性檢查,必須處理重大問題,並必須報告結果。

發佈後驗證

發佈後,代理必須更新任何本地安裝的副本至新發佈的版本,並必須驗證解析的版本。代理不得在驗證完成(或使用者明確拒絕)之前報告「完成」。

代理必須將驗證表達為明確的驗收標準,並附上結果(通過 / 失敗 / 不適用)與證據:

  • AC1(註冊表) — 驗證已發佈版本存在於註冊表中(例如 npm view <pkg> version)。
  • AC2(全新安裝) — 驗證最新套件可解析並執行(例如 npx <pkg>@latest --version)。
  • AC3(全域更新,若適用) — 若套件已全域安裝,請更新至已發佈版本並驗證(例如 npm ls -g <pkg> --depth=0、npm i -g <pkg>@latest,然後 <cmd> --version)。若 AC3 不適用,代理必須將其標記為「不適用」並明確說明原因。

對於 npm CLI:

  • 若已全域安裝:檢查 npm ls -g <pkg> --depth=0,透過 npm i -g <pkg>@latest 更新,然後使用 <pkg> --version 驗證。
  • 若未全域安裝:跳過全域更新,並透過 npx <pkg>@latest --version(或生態系統等效指令)驗證可用性。

標準儲存庫主題

代理必須從以下標準集合中指派主題。每個儲存庫在適用時必須至少有一個標準主題。不符合任何標準主題的儲存庫必須使用與其領域相關的描述性主題。

  • agent-skill — 儲存庫包含 SKILL.md(可安裝的代理技能)。
  • agent-tool — 代理使用的 CLI 工具或 MCP 伺服器(例如 task-tracker、agents-mcp、compose-agentsmd)。
  • agent-rule — 規則來源或規則集儲存庫(例如 agent-rules)。
  • unreal-engine — Unreal Engine 插件或範例專案。
  • qti — QTI 評測生態系統工具或函式庫。
  • education — 課程內容、教學材料或學生面向平台。
  • docusaurus — Docusaurus 插件或擴展。

可自由新增其他描述性主題(語言、框架、領域關鍵字)於標準主題旁。當儲存庫面貌發生實質變化時,代理必須檢閱並更新標準主題集。代理必須在新儲存庫合規門檻中驗證主題是否已設定。

已發佈成品要求

  • 代理必須填入套件中繼資料(名稱、描述、repository、issues、homepage、engines)。
  • 代理必須驗證可執行入口點與所需的 shebang,以使安裝的命令正常工作。
  • 若儲存庫代表單一工具或產品,代理必須發佈單一套件(將相關腳本打包)。

相關技能