跳至主要內容

核心概念

理解這些概念能幫助你充分運用 skillshare。

你想了解什麼?

問題閱讀
skillshare 如何搬動 skills?Source & Targets
merge 跟 symlink 有什麼差別?Sync Modes
如何分享組織層級的 skills?Tracked Repositories
SKILL.md 裡面要放什麼?Skill Format
Project 層級的 skills 怎麼運作?Project Skills

總覽

關鍵概念

概念是什麼深入了解
Source & Targets單一事實來源,多個目的地→ Source & Targets
Sync ModesMerge、copy、symlink — 檔案如何被連結→ Sync Modes
Tracked Repos--track 安裝的 Git repos→ Tracked Repositories
Skill FormatSKILL.md 結構與 metadata→ Skill Format
Project Skills限定於單一 repository 的 skills→ Project Skills
Organization Skills透過 tracked repositories 實現組織層級的 skills→ Organization-Wide Skills

快速摘要

Source & Targets

  • Source~/.config/skillshare/skills/ — 你編輯 skills 的地方
  • Targets:AI CLI 的 skill 目錄 — skills 透過 symlink 部署到這裡

Sync Modes

  • Merge(預設):每個 skill 個別建立 symlink,保留 target 中的本機 skills
  • Copy:每個 skill 個別複製,保留本機 skills
  • Symlink:整個目錄是單一個 symlink

Tracked Repos

  • --track 安裝的 Git repos
  • _ 為前綴(例如 _team-skills/
  • 透過 skillshare update <name> 更新

Skill Format

  • 含 YAML frontmatter 的 SKILL.md
  • 必要欄位:name
  • 選用欄位:description、自訂 metadata

Project Skills

  • 限定於單一 repository 的 skills(.skillshare/skills/
  • 透過 git 與團隊共享 — 當 .skillshare/ 存在時會自動偵測
  • Sync mode 可依 target 個別設定(預設 merge,也可選 symlink)

Organization Skills

  • 透過 tracked repositories(--track)在所有專案間共享
  • 安裝一次,用 skillshare update --all 更新
  • 與 project skills 互補:organization 負責標準規範,project 負責 repo 專屬情境

設計理念

skillshare 背後設計決策的深入說明。

主題摘要
Why Local-First單一執行檔、零相依、預設離線可用
Security-First15+ 種稽核模式、供應鏈威脅模型
Sync Modes Deep DiveMerge 與 symlink 的權衡取捨細節
Comparisonskillshare 與其他工具的比較
Skill Design撰寫有效 skills 的指引