Skill

团队共用的 Skill 放在一个 Git 仓库里,自动装到每个人的每个 agent 上。

Skill 是一份教 agent 怎么做某件事的说明,比如团队的代码评审标准、发版步骤。每个 agent 都有自己放 Skill 的目录,一个人用五个 agent 就要放五份,一个团队十个人就是五十份,还要保持一致。

Yihee 做的事很简单:团队把 Skill 放在一个 Git 仓库里,每个人的电脑自动把它们装到五个 agent 各自的目录里,并保持最新。

团队的一个 Skill,装到五家 agent 各自读取的目录,逐个核对。你自己已经有同名的,不覆盖。

team-skills · 团队的 Skill 仓库

  • Claude Code

    ~/.claude/skills/code-review

    装上了
  • Codex

    ~/.codex/skills/code-review

    装上了
  • Grok

    ~/.grok/skills/code-review

    装上了
  • OpenCode

    ~/.config/opencode/skills/code-review

    装上了
  • Pi

    ~/.agents/skills/code-review

    装上了

管理员:设一个 Skill 源仓库

在「团队管理 → 项目与 Skill」的「Skill 源仓库」里填一个仓库,格式 owner/repo。

仓库里的结构是这样的:

team-skills/
├── code-review/
│   └── SKILL.md
├── release-checklist/
│   └── SKILL.md
└── skills/
    └── weekly-report/
        └── SKILL.md
  • 每个带 SKILL.md 的目录就是一个 Skill,目录名就是 Skill 的名字。
  • 可以直接放在仓库最外层,也可以放在 skills/ 目录下。
  • SKILL.md 开头 description: 那一行会显示在 Skill 页的列表里。

发布一个新 Skill,或者更新一个已有的,就是往这个仓库推一次提交。没有别的步骤。

仓库是私有的也可以,但每位成员的电脑要能用自己的 git 凭据克隆它。

成员:什么都不用做

加入团队后,Skill 会自己装好。之后在这些时候检查更新:

  • Yihee 启动后。
  • 每 4 小时。
  • 打开 Skill 页时。
  • 你手动点「现在检查更新」。

装到这五个位置:

agent 目录
Claude Code ~/.claude/skills
Codex ~/.codex/skills
OpenCode ~/.config/opencode/skills
Grok ~/.grok/skills
Pi ~/.agents/skills

装的是指向同一份文件的链接,所以五个 agent 看到的内容一定相同,更新一次全部生效。

队友更新了 Skill

后台拉到更新时,会弹一条提示,写明新加了哪些、改了哪些。侧栏「Skill」旁边会出现数字。

Skill 页:按「没装全」「你自己的版本」「跟着团队更新」分组
Skill 页:按「没装全」「你自己的版本」「跟着团队更新」分组

在 Skill 页里,新加的 Skill 名字旁边标「新」,内容改过的标「改过」。点开看一眼,标记就消了。

我自己改过的 Skill 会被覆盖吗

不会。

如果某个 agent 的目录里已经有一个同名的 Skill,而它不是 Yihee 装的(是你自己写的,或者你改过),Yihee 不会动它。这个 Skill 会出现在「用的是你自己的版本」分组里,并说明它的内容和团队的一样还是不一样。

这种状态下它不会跟着团队更新。想换回团队的,点「换成团队的」:你原来那份是文件夹的话会进废纸篓,可以找回。

没装全

「本机没装全」分组里的 Skill,是至少有一个 agent 上没装。点开能看到每个 agent 的状态,点「补装到 N 个工具」。

团队删掉了一个 Skill

从仓库里删掉后,下次更新时,各个 agent 目录里指向它的链接会被清掉。你自己的那份副本不受影响。

不想自动更新

「设置 → 同步 → 团队 Skill」里关掉「自动更新」。关掉后 Skill 页上会出现一个「更新」按钮,你想更新时自己点。

Yihee 自带的两个 Skill

Skill 页最下面的「Yihee 自带」里有两个,是给终端里的 agent 用的。Yihee 自己的 Pal 不需要装,本来就会。

Skill 装了之后能做什么
yihee-cron-tasks 在 Claude Code 或 Codex 里直接说「帮我建一个每天九点的巡检任务」
yihee-session-handoff 在 Claude Code 或 Codex 里直接说「把这个交给小王」

这两个不会自动装,要你点「安装到 Claude Code / Codex…」。它们靠 yihee 命令行和桌面应用通信,所以还需要装命令行,安装窗口里有命令可以复制。

出问题的时候

提示 原因 怎么办
管理员尚未设置 skill 源仓库 团队还没配 请管理员在团队管理里填
源仓库没拉下来,显示的是上次的内容 这次没连上,或者没权限 点「重试」。私有仓库先确认本机 git 能克隆它
内容不一致 某个 agent 上的那份和团队的不一样 点开看是哪个,决定要不要「换成团队的」
源已移除 团队把它从仓库里删了 不用管,或者删掉你本地那份

拉不下来时,先在终端里试一下 git clone 这个仓库。终端里能克隆,Yihee 就能拉。