✅ 上線審查 / 申請

所有對外服務上線前的標準流程。下載 Skill → 自動掃瞄原始碼 → 填寫維運資訊 → 提交審查。

⏱ 預估完成時間 30~60 分鐘 · 一般 SLA：3 工作日

STEP 1

下載並套用上線審查 Skill (Markdown)

Claude / Cursor 直接讀取 Skill；或讓 tmc CLI 自動掃瞄你的 repo。

最新版本：v2.4 · 1 週前

📥 直接下載

.md

放到 .claude/skills/ 或 .cursor/skills/

⚡ 用 tmc 套用

CLI

在你的 repo 根目錄執行：

tmc apply release-review

STEP 2

連接 Bitbucket 並掃瞄原始碼

檢查目錄命名、啟動 / 重啟方式、Log 位置與寫法、設定檔結構等公司架構規範。

Repository： Branch：

掃瞄完成 · 2 分鐘前 | 12 ✓ 通過 3 ⚠ 警告 1 ✗ 失敗

✓ 目錄結構符合 src/main/java 命名規範 structure-naming
✓ Dockerfile 使用公司 base image (java-jdk:21) docker-base
⚠ Log 寫入位置應為 /var/log/app/，目前為 ./logs/ log-location
⚠ 啟動腳本未含 healthcheck endpoint 設定 healthcheck
✗ 缺少 RUNBOOK.md （必要文件）必修
⚠ 建議在 application.yml 加入 graceful-shutdown graceful-shutdown
✓ 已配置 Prometheus metrics endpoint metrics
+ 展開其餘 9 項通過項目 ↓

查看 scan-result.json 預覽 ▾

{
  "repo": "orderservice",
  "branch": "release/v4.18",
  "scannedAt": "2026-05-16T09:38:14Z",
  "skill": "release-review@2.4",
  "summary": { "pass": 12, "warn": 3, "fail": 1 },
  "results": [
    { "id": "log-location", "level": "warn",
      "msg": "Log path should be /var/log/app/",
      "found": "./logs/" },
    { "id": "runbook-required", "level": "fail",
      "msg": "RUNBOOK.md missing" }
  ]
}

STEP 3

維運資訊表單

交付給 SRE 的標準資料 · 部分欄位會從 Skill 掃瞄結果自動帶入。

如何重新啟動服務

Log 檔案位置

告警條件

弱掃報告

📄 vulnerability-2026-05-15.pdf

✓ 0 critical · 2 high · 8 medium

整體架構圖 — 線上繪製（簡易 Web 繪圖元件示意）

| drag to move · double-click to edit

此元件示意：拖拉節點、雙擊編輯文字、連線、儲存成 SVG 或 PNG。實作可採用 mxgraph (drawio) / excalidraw / tldraw。

準備好了嗎？

送審後會跳轉至外部電子簽呈系統，並自動帶入 scan-result.json、維運表單、架構圖。

📨 提交上線審查 →