企业官网建设流程全解析

如何用skillshare项目模式让团队共享AI技能：.skillshare完整指南

【免费下载链接】skillshare📚 Sync skills across all AI CLI tools with one command and simplify team sharing. Supporting Codex, Claude Code, OpenClaw & more项目地址: https://gitcode.com/gh_mirrors/skill/skillshare

skillshare 是一个用一条命令就能把所有 AI CLI 工具（Codex、Claude Code、OpenClaw 等）里的 AI 技能统一同步的工具。本指南教你使用 skillshare 项目模式（project mode）：把团队约定的编码规范、部署流程等 AI 技能统一存放在项目的.skillshare/目录中，随 git 仓库一起共享给全员——新成员克隆仓库后，只需两条命令就能获得完整的项目上下文。

为什么团队需要 AI 技能共享

想象这样一个场景：项目约定"所有接口必须使用 camelCase、错误返回统一格式"，但这些知识只写在 README 里，AI 助手并不知情，每次都要手动粘贴说明。

skillshare 项目模式把这类知识做成SKILL.md 技能文件，提交进仓库，AI 工具直接读取。适用场景包括：

💡 项目模式适合"某个仓库专属"的知识；如果公司级规范要跨所有项目共享，应使用全局（组织）模式，两者可并存互不冲突。

一键初始化：创建 .skillshare 目录

在项目根目录执行一条命令，skillshare 会自动创建.skillshare/目录并检测已安装的 AI CLI 工具：

cd my-project skillshare init -p

初始化过程会自动完成四步：创建.skillshare/目录 → 检测项目中的 AI CLI 目录（如.claude/、.cursor/）→ 创建目标技能目录 → 写入config.yaml。

几个实用细节：

• 自动检测：只要.skillshare/config.yaml存在，skillshare 会自动进入项目模式，后续命令无需再带-p标志
• 指定目标：skillshare init -p --targets claude,cursor可跳过交互直接指定
• 可见目录：如果你的仓库把技能视为"可评审的内容"，可用skillshare init -p --visible创建可见的skillshare/目录替代隐藏的.skillshare/

.skillshare 目录结构一览

初始化并添加技能后，目录结构如下：

my-project/ ├── .skillshare/ │ ├── config.yaml # 目标工具列表 + 远程技能清单（提交到 git） │ ├── skills.lock.json # 每个远程技能锁定的 commit（提交到 git） │ ├── .gitignore # 忽略 logs/、trash/、backups/ 等 │ └── skills/ │ ├── my-local-skill/ # 本地技能（手工或 skillshare new 创建） │ │ └── SKILL.md │ └── remote-skill/ # skillshare install 安装的远程技能 ├── .claude/skills/ │ └── my-local-skill → ../../.skillshare/skills/my-local-skill └── .cursor/skills/ └── (同上，符号链接结构)

两个关键设计：

• config.yaml 是"声明式技能清单"：团队共享的只有"装了什么"，具体内容由install -p按清单重建
• skills.lock.json 锁定版本：记录每个远程技能安装的 commit，确保团队成员装到完全相同的内容，类似package-lock.json

项目模式下，各 AI 工具目录里的链接使用相对路径（如../../.skillshare/skills/...），项目无论被移动还是克隆到哪台机器，链接都能正常工作。

日常协作工作流：新建技能 → 同步 → 提交

团队日常只需记住"编辑 → 同步 → 提交"三步循环：

# 1. 新建一个技能模板 skillshare new api-guide -p # 用编辑器填写 .skillshare/skills/api-guide/SKILL.md # 2. 同步到所有目标 AI 工具 skillshare sync # 3. 提交并推送 git add .skillshare/ git commit -m "Add api-guide skill" git push

sync命令会先把目标目录备份到backups/，再把.skillshare/skills/里的技能以符号链接方式分发到.claude/skills/、.cursor/skills/等每个目标目录：

同事侧更新也只需两条命令：

git pull skillshare install -p && skillshare sync

install -p（不带参数）会自动读取config.yaml里列出的全部远程技能并安装，Bob 无需知道 Alice 具体加了什么——配置即清单，清单即一切。

新人入职：两条命令完成配置

没有 skillshare 时，新成员要读 README 找技能列表、手动安装、逐个配置每个 AI 工具；有了 skillshare 项目模式：

git clone <团队项目仓库地址> cd my-project skillshare install -p && skillshare sync

完成。所有项目技能安装并同步到位。执行skillshare status可随时确认各目标的同步状态：

进阶：用 --track 共享团队技能仓库

除了项目内技能，团队还可以维护一个独立的共享技能仓库（比如前端团队的全套 UI 规范），用--track以 git 子仓库形式安装，保留完整提交历史：

skillshare install team/shared-skills --track --name _team-skills -p skillshare sync

之后skillshare update _team-skills即可拉取最新技能，更新记录会进入代码评审流程，团队对技能变更有完整追溯。

可视化看板：skillshare ui

所有操作都可以用 Web 看板完成。进入项目目录执行：

skillshare ui

看板会明确显示当前处于项目模式（侧边栏标注Project · <项目路径>），技能只作用于当前项目；同时自动隐藏"Git Sync"（项目模式直接复用项目自身的 git），并在安装远程技能后自动更新config.yaml的技能清单：

总结与延伸阅读

skillshare 项目模式让 AI 技能成为"代码"：存放在.skillshare/中随仓库版本化，用 lockfile 锁版本，用符号链接分发到每个 AI 工具，新人两条命令即可完成配置。

📌 想深入了解，可阅读以下文档与源码：

• 项目搭建完整指南：website/docs/how-to/sharing/project-setup.md
• 项目技能概念详解（含目录结构与锁文件说明）：website/docs/understand/project-skills.md
• 日常项目工作流：website/docs/how-to/daily-tasks/project-workflow.md
• init命令参考（-p、--visible、--discover等选项）：website/docs/reference/commands/init.md
• 项目路径解析核心实现：internal/config/project.go
• Web 看板项目模式处理：internal/server/handler_projects.go

【免费下载链接】skillshare📚 Sync skills across all AI CLI tools with one command and simplify team sharing. Supporting Codex, Claude Code, OpenClaw & more项目地址: https://gitcode.com/gh_mirrors/skill/skillshare