發布與發佈工作流程
公開儲存庫中繼資料
- 對於公開儲存庫,代理必須設定 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,以使安裝的命令正常工作。
- 若儲存庫代表單一工具或產品,代理必須發佈單一套件(將相關腳本打包)。