docs(calculate-version): 新增 README 並補上 entrypoint/CI/CD 註解

依 doc-funcs 產生 README（專案列表、功能列表、使用範例），並為 CI/CD workflow 補上逐行註解。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 10:41:34 +08:00
parent 923c94d198
commit 6f9df6743c
3 changed files with 310 additions and 0 deletions
@@ -1,12 +1,27 @@
+# =============================================================================
+# 用途: calculate-version 專案的 CD workflow。
+#       在程式碼推送至 master 分支時,自動釋出並標註 (tag) 成品版本。
+# 更新日期: 2026/06/26 10:28:36
+# =============================================================================
+
+# workflow 名稱,顯示於 Gitea Actions 介面。
 name: CD
+# 觸發條件設定。
 on:
+  # 於 push 事件觸發。
  push:
+    # 僅在推送至 master 分支時觸發。
    branches:
    - master
 jobs:
+  # job 識別碼:釋出並標註版本。
  release-tag-version:
+    # job 顯示名稱。
    name: Release Tag Version
+    # 指定執行於 ubuntu runner。
    runs-on: ubuntu
    steps:
+    # 呼叫共用的 release-tag-version composite action,自動產生版本標籤並釋出。
    - name: 釋出並標註成品版本
+      # 版本以變數 ACTION_RELEASE_TAG_VERSION 控制,便於統一升級。
      uses: https://gitea.jsc.idv.tw/composite-actions/release-tag-version@${{ vars.ACTION_RELEASE_TAG_VERSION }}