跳至主要內容

Recipe：私有企業 Skills

使用 token 認證安裝來自私有 repository 的 skills。

情境​

你的組織將內部 skills 存放在私有的 GitHub/GitLab repository 中。你需要在不將憑證暴露於 config 檔案的情況下安裝並更新這些 skills。

解決方案​

步驟 1：設定認證​

skillshare 會從環境變數偵測 token，平台專屬的變數優先於通用的 fallback：

平台環境變數
GitHub / GitHub EnterpriseGITHUB_TOKEN
GitLab / 自架 GitLabGITLAB_TOKEN
BitbucketBITBUCKET_TOKEN（+ 選用的 BITBUCKET_USERNAME）
Azure DevOpsAZURE_DEVOPS_TOKEN
Gitea / 自架 GiteaGITEA_TOKEN
CNBCNB_TOKEN
任何平台（fallback）SKILLSHARE_GIT_TOKEN
# 選項 A：Git credential helper（建議用於 GitHub）
gh auth login   # 為 HTTPS 設定 git credential helper

# 選項 B：平台專屬的環境變數
export GITHUB_TOKEN=ghp_xxxxxxxxxxxxx      # GitHub
export GITLAB_TOKEN=glpat-xxxxxxxxxxxxx    # GitLab
export AZURE_DEVOPS_TOKEN=your-pat-here    # Azure DevOps

# 選項 C：通用 fallback（適用於任何 HTTPS host）
export SKILLSHARE_GIT_TOKEN=your-token-here

步驟 2：從私有 repo 安裝​

skillshare install your-org/internal-skills --track

skillshare 會自動從上述環境變數中偵測 token。

步驟 3：驗證追蹤狀態​

skillshare list

已安裝的 repo 會以 _ 前綴顯示（tracked repository）：

_your-org-internal-skills/
├── code-review/
├── testing-standards/
└── deployment-checklist/

步驟 4：更新循環​

skillshare check    # 偵測上游變更
skillshare update   # 拉取最新版本
skillshare sync     # 推送到 targets

驗證​

  • skillshare list 顯示已追蹤的 repo
  • skillshare check 能連線到 remote 並比對 hash
  • skillshare sync 在所有 targets 中建立 symlinks

變化​

  • 選擇性安裝：skillshare install your-org/internal-skills --track --skill code-review 只安裝單一 skill
  • CI/CD token：在 pipeline 中，從 CI secrets 設定平台專屬的環境變數（例如 GITHUB_TOKEN）
  • 自架 GitLab：設定 GITLAB_TOKEN 並使用 HTTPS URL：skillshare install https://gitlab.internal.com/team/skills.git --track
  • 自架 Gitea：設定 GITEA_TOKEN。若主機名稱不含 gitea，也需將其列入 gitea_hosts
  • Gitee / AtomGit：透過 SKILLSHARE_GIT_TOKEN 搭配 HTTPS URL 支援

相關​