Skip to content

About

跨 Agent 平台的公共技能仓库(Skills)——支持 Kimi/Cursor/Codex/Trae/Qoder 双通道同步

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

47 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CommonSkills 项目

AI Agent 公共技能仓库(CommonSkills) —— 统一管理跨 Agent 平台的共享技能(Skills),实现一处编写、多处复用。


📌 项目定位

本仓库集中管理所有可被多个 AI Agent 平台复用的技能(Skill),包括:

  • Kimi(Work 模式 / Kimi Code IDE 插件)
  • Cursor
  • Codex
  • Trae
  • Qoder
  • 以及任何支持 ~/.agents/skills/ 或 ~/.kimi/skills/ 规范的 Agent 工具

📁 目录结构

CommonSkills/
├── README.md                    # 本文件
├── .gitignore                   # Git 忽略规则
├── scripts/
│   └── sync-to-kimi.sh          # Kimi Work 模式复制同步脚本
│   └── setup-symlinks.ps1       # Windows 软链接批量设置脚本
├── [skill-name-1]/              # 技能目录 1
│   └── SKILL.md                 # 技能主文件(必须)
├── [skill-name-2]/              # 技能目录 2
│   ├── SKILL.md
│   └── references/              # 可选:参考资料
└── ...

当前共有 87 个公共技能,涵盖:写作、代码开发、数据分析、投研、办公自动化、PPT 生成等。


🧬 Nature Skills

nature-* 技能来自 Yuan1z0825/nature-skills,已于 2026-09-03 统一合并到本仓库,上游同步版本为 596f65b。这些技能面向科研工作流,包括文献检索与下载、阅读和文献管线、实验日志、统计与数据、科研绘图、论文/PPT/专利写作、审稿回复、引用核验等。

  • 本仓库保留完整的 SKILL.md、README.md、references/、脚本和静态资产,nature-shared 作为内部共享支持包随其余 nature-* 技能一起保留。
  • 不要单独安装到某个 Agent 的私有目录;先更新本仓库中的 nature-* 技能,再通过现有同步机制分发到 Cursor、Codex、Kimi 等支持的 Agent。
  • 后续更新时,可把上游仓库 clone 到临时目录,确认技能名与本地无冲突后,用 Copy-Item -Path <temp>\skills\nature-* -Destination . -Recurse -Force 覆盖合并,并更新这里的同步版本。

🔧 双通道 Agent 加载机制

不同 Agent 平台对技能目录的加载方式不同,本项目采用 双通道方案:

通道 A:Symbolic Link(软链接)—— 适用于 Cursor / Codex / Trae / Qoder / Kimi Code IDE

这些 Agent 平台扫描本地文件系统时跟随软链接(Symbolic Link),因此采用软链接方式:

Agent 程序 软链接路径 指向目标
Cursor / Codex / Trae / Qoder ~/.agents/skills/<skill-name> ~/CommonSkills/<skill-name>
Kimi Code IDE 插件 ~/.kimi/skills/<skill-name> ~/CommonSkills/<skill-name>

优势:

  • 实时同步:修改 CommonSkills 中的源文件,所有 Agent 立即生效
  • 零维护:无需手动复制
  • 节省磁盘空间

通道 B:Native Directory Copy(原生目录复制)—— 适用于 Kimi Work 模式

Kimi 桌面客户端(Work 模式)的 daimon 内核在扫描技能目录时,会跳过 Symbolic Link(软链接)。因此必须采用原生目录复制方式:

Agent 程序 复制目标路径 来源
Kimi Work 模式 ~/AppData/Roaming/kimi-desktop/daimon-share/daimon/skills/<skill-name> ~/CommonSkills/<skill-name>

特点:

  • 需要复制(不是软链接)
  • daimon 内核加载时视为原生技能,UI 可正常显示和调用
  • 更新后需重新同步

🚀 快速开始

1. 首次设置(Windows)

步骤 1:创建 CommonSkills 软链接(通道 A)

打开 PowerShell(管理员),运行:

# 为 ~/.agents/skills/ 创建软链接(Cursor / Codex / Trae / Qoder)
$common = "C:\Users\$env:USERNAME\CommonSkills"
$agents = "C:\Users\$env:USERNAME\.agents\skills"

# 如果目录不存在则创建
if (-not (Test-Path $agents)) { New-Item -ItemType Directory -Path $agents }

# 遍历 CommonSkills 中所有技能,创建软链接
Get-ChildItem $common -Directory | ForEach-Object {
    $skill = $_.Name
    $src = Join-Path $common $skill
    $dst = Join-Path $agents $skill
    if (Test-Path $dst) { Remove-Item $dst -Force }
    New-Item -ItemType SymbolicLink -Path $dst -Target $src
}

# 同样为 ~/.kimi/skills/ 创建软链接(Kimi Code IDE 插件)
$kimi = "C:\Users\$env:USERNAME\.kimi\skills"
if (-not (Test-Path $kimi)) { New-Item -ItemType Directory -Path $kimi }
Get-ChildItem $common -Directory | ForEach-Object {
    $skill = $_.Name
    $src = Join-Path $common $skill
    $dst = Join-Path $kimi $skill
    if (Test-Path $dst) { Remove-Item $dst -Force }
    New-Item -ItemType SymbolicLink -Path $dst -Target $src
}

步骤 2:复制到 Kimi Work 模式(通道 B)

# 复制到 Kimi 桌面客户端技能目录
$common = "C:\Users\$env:USERNAME\CommonSkills"
$kimiWork = "C:\Users\$env:USERNAME\AppData\Roaming\kimi-desktop\daimon-share\daimon\skills"

Get-ChildItem $common -Directory | ForEach-Object {
    $skill = $_.Name
    $src = Join-Path $common $skill
    $dst = Join-Path $kimiWork $skill
    if (Test-Path $dst) { Remove-Item $dst -Recurse -Force }
    Copy-Item -Path $src -Destination $dst -Recurse
}

🔄 自动同步机制(Git Hook)

原理

通过 Git Hook 实现:当 CommonSkills 仓库更新(pull / merge / checkout)时,自动触发同步脚本,确保 Kimi Work 模式的技能目录始终与仓库最新版本一致。

已配置的 Hook

Hook 类型 触发时机 作用
post-merge 执行 git pull 或 git merge 后 同步最新技能到 Kimi Work 模式
post-checkout 执行 git checkout 切换分支后 同步当前分支技能到 Kimi Work 模式
post-commit 执行 git commit 后 可选:同步本地修改到 Kimi Work 模式

同步脚本逻辑(scripts/sync-to-kimi.sh)

#!/bin/bash
# 双通道同步脚本
# 通道 A:软链接(已存在,无需操作)
# 通道 B:复制到 Kimi Work 模式目录

COMMON="C:/Users/$(whoami)/CommonSkills"
KIMI_WORK="C:/Users/$(whoami)/AppData/Roaming/kimi-desktop/daimon-share/daimon/skills"

echo "[Sync] 开始同步 CommonSkills -> Kimi Work 模式..."

cd "$COMMON" || exit 1
for skill in */; do
    skill=${skill%/}
    src="$COMMON/$skill"
    dst="$KIMI_WORK/$skill"
    
    # 跳过非目录项和隐藏文件
    [ -d "$src" ] || continue
    [[ "$skill" == .* ]] && continue
    
    # 如果目标是软链接,先删除
    if [ -L "$dst" ]; then
        rm -f "$dst"
        echo "  [移除软链接] $skill"
    fi
    
    # 复制为原生目录
    rm -rf "$dst"
    cp -r "$src" "$dst"
    echo "  [已复制] $skill"
done

echo "[Sync] 同步完成。"

激活 Hook

# 在 CommonSkills 目录下
cd ~/CommonSkills
chmod +x scripts/sync-to-kimi.sh

# 链接 hook
cp scripts/sync-to-kimi.sh .git/hooks/post-merge
cp scripts/sync-to-kimi.sh .git/hooks/post-checkout
chmod +x .git/hooks/post-merge
chmod +x .git/hooks/post-checkout

➕ 新增技能的标准流程

  1. 在 CommonSkills/ 下创建新技能目录

    mkdir -p ~/CommonSkills/my-new-skill
    cat > ~/CommonSkills/my-new-skill/SKILL.md << 'EOF'
    ---
    name: my-new-skill
    description: 新技能描述
    version: 1.0.0
    ---
    
    # 新技能内容
    ...
    EOF
  2. 提交到 Git

    cd ~/CommonSkills
    git add my-new-skill/
    git commit -m "add: my-new-skill"
    git push
  3. 自动同步(Git Hook)

    • post-commit / post-merge / post-checkout 会自动执行同步脚本
    • Kimi Work 模式目录会复制新增技能
    • 其他 Agent(Cursor/Codex/Trae/Qoder/KimiCodeIDE)通过软链接实时生效
  4. 验证

    • 重启 Kimi 客户端(Work 模式),搜索新技能名称
    • 在 Cursor/Codex/Trae/Qoder 中验证新技能可用
    • 重启 Kimi 客户端,搜索新技能名称
    • 在 Cursor/Codex/Trae/Qoder 中验证新技能可用

📝 各 Agent 技能目录速查

Agent 技能目录 加载方式 是否需要重启
Kimi Work 模式 ~/AppData/Roaming/kimi-desktop/daimon-share/daimon/skills/ 复制(原生目录) ✅ 需要重启客户端
Kimi Code IDE ~/.kimi/skills/ 软链接 / Junction ❌ 实时生效
Cursor ~/.cursor/skills/ 或 ~/.agents/skills/ 软链接 / Junction ❌ 实时生效
Codex ~/.codex/skills/ 或 ~/.agents/skills/ 软链接 / Junction ❌ 实时生效
Trae ~/.trae/skills/ 或 ~/.agents/skills/ 软链接 / Junction ❌ 实时生效
Qoder ~/.qoder/skills/ 或 ~/.agents/skills/ 软链接 / Junction ❌ 实时生效

注:~/.agents/skills/ 是通用共享目录,被多个 Agent 支持。


⚠️ 已知限制与注意事项

1. Kimi Work 模式不支持软链接

根本原因:Kimi 桌面客户端的 daimon 内核在扫描 daimon-share/daimon/skills/ 时,使用 fs.readdir 的 withFileTypes: true 并检查 dirent.isSymbolicLink(),主动跳过所有 Symbolic Link(软链接)和 Junction(目录联接)。

验证过程:

  • test-native-daimon(原生目录)→ ✅ 可加载
  • cubox(原生目录)→ ✅ 可加载
  • agently-mail(软链接)→ ❌ 不可加载
  • backend-dev(软链接)→ ❌ 不可加载

结论:只有原生目录(非软链接)才能被 Kimi Work 模式加载。

2. 配置差异

Kimi 客户端 Work 模式与 Kimi Code IDE 插件使用不同的配置文件:

  • Kimi Code IDE 插件:~/.kimi/config.toml(支持 extra_skill_dirs)
  • Kimi Work 模式:daimon-share/daimon/runtime/kimi-code/config.toml(extra_skill_dirs 可能无效)

3. 内置技能(builtin-skills)

Kimi 客户端打包了 34 个内置技能(builtin-skills),位于:

~/AppData/Roaming/kimi-desktop/daimon-bundle/app/daimon/assets/builtin-skills/

这些技能有 builtInSkillsSha256 校验,不建议修改。

4. 宿主被动更新技能会写穿透仓库

若宿主技能目录是指向仓库的 Junction,该宿主自行更新技能时会直接改写仓库文件(历史事故:time-awareness、worker-safety、kimiim 的 frontmatter 被回退)。处置方式见 docs/skill-host-sync.md:优先把宿主的写目录隔离出去并保留 extra_skill_dirs 只读加载。


🔧 故障排查

问题:Kimi Work 模式找不到某个技能

排查步骤:

  1. 确认技能目录在 daimon-share/daimon/skills/ 下是原生目录(不是软链接)
    ls -la ~/AppData/Roaming/kimi-desktop/daimon-share/daimon/skills/<skill-name>
    # 如果显示 lrwxrwxrwx -> ...,说明是软链接,需要替换为复制
  2. 确认 SKILL.md 的 YAML frontmatter 格式正确:
    ---
    name: skill-name
    description: 技能描述
    version: 1.0.0
    ---
  3. 确认技能目录名与 SKILL.md 中的 name 一致
  4. 重启 Kimi 客户端

问题:软链接在其他 Agent 中失效

排查步骤:

  1. 确认软链接目标路径存在
  2. 确认软链接没有被破坏(如目标目录被移动或删除)
  3. 重新创建软链接:
    rm -f ~/.agents/skills/<skill-name>
    ln -s ~/CommonSkills/<skill-name> ~/.agents/skills/<skill-name>

📚 参考文档


🏷️ 版本历史

版本 日期 变更
1.0.0 2026-07-15 初始建立,支持 Kimi/Cursor/Codex/Trae/Qoder 双通道同步
1.0.1 2026-07-15 docs: 明确同步范围仅限 Kimi Work 模式,Chat 模式不受影响
1.0.2 2026-07-15 docs: 完全移除 Chat 模式引用,同步范围精确为 Kimi Work + Kimi Code IDE
1.0.3 2026-07-15 fix: 删除技能目录速查表中的重复 Kimi Code IDE 行
1.1.0 2026-07-15 fix: 修复 5 个技能的前置元数据(time-awareness、worker-safety 补充 frontmatter;gongkao-review-allinone、kimi-webbridge-desktop、kimiim 修正 name 与目录名不匹配)
1.1.1 2026-07-15 fix: 移除同步脚本中的 Chat 模式残留引用;修复时间戳比较逻辑(目录级 -> SKILL.md 文件级)
1.1.2 2026-07-15 fix: 修正技能总数 64 -> 62;更新 git hooks 到最新同步脚本版本
1.1.3 2026-07-15 docs: 新增完整复盘验证报告 _FINAL_VERIFICATION_REPORT.md
1.1.4 2026-08-03 docs: 技能总数 62 -> 86;同步 vpdn-diagnose 全链路更新与 elsewhere-api.ps1
1.1.5 2026-08-04 docs: 技能总数 86 -> 87;新增 yunmai-disable(企业 SASE/EDR 客户端静默与禁用方法论)
1.1.6 2026-08-10 docs: 通道 A 补全各 Agent 独立技能目录(/.codex、/.cursor、/.trae、/.qoder)并明确 Junction 为免管理员等效方案;移除空壳技能 kimi-webbridge-desktop 与 ppt-master

🆕 TeleAgent 接入说明

TeleAgent 是一款 Windows 桌面端 AI Agent 工具(v2.0.3),技能目录位于 C:\Users\zhaox.config\TeleAgent\skills\。

同步机制

TeleAgent 采用 Junction(目录联接) 方式接入 CommonSkills:

Agent 程序 技能目录路径 方式
TeleAgent ~/.config/TeleAgent/skills/CS_ Junction -> ~/CommonSkills/

命名约定

来源 在 TeleAgent 中的名称 说明
CommonSkills CS_ Junction 指向 CommonSkills 源目录
TeleAgent 官方 保持原名 canvas-design, docx 等内置技能
TeleAgent Hub 保持原名 eleppt-pro, elecom-ppt-writer 等市场技能
TeleAgent -> CommonSkills 保持原名 已添加 create_source: teleagent 标记
同名冲突 Tele_ 如 Tele_skill-creator 避免与 CommonSkills 冲突

初始化

首次设置需以管理员身份运行:

# 1. 停止 TeleAgent
Stop-Process -Name "TeleAgent" -Force

# 2. 运行初始化脚本
powershell -ExecutionPolicy Bypass -File "scripts\init-teleagent-junctions.ps1"
# 或手动执行:
# 备份
Copy-Item "C:\Users\zhaox\.config\TeleAgent\skills\*" "C:\Users\zhaox\CommonSkills\_backup\teleagent\" -Recurse
# 创建 junction
Get-ChildItem "C:\Users\zhaox\CommonSkills" -Directory | Where-Object { $_.Name -notin @('.git','scripts','_backup') } | ForEach-Object {
    New-Item -ItemType Junction -Path "C:\Users\zhaox\.config\TeleAgent\skills\CS_$($_.Name)" -Target $_.FullName -Force
}

# 3. 重启 TeleAgent
Start-Process "D:\Program Files\TeleAgent\TeleAgent.exe"

日常维护

使用 scripts\sync-teleagent.ps1 脚本进行同步:

# 检查状态(管理员)
powershell -ExecutionPolicy Bypass -File "scripts\sync-teleagent.ps1" -Action check

# 执行同步(管理员)
powershell -ExecutionPolicy Bypass -File "scripts\sync-teleagent.ps1" -Action sync

# 从备份恢复(管理员)
powershell -ExecutionPolicy Bypass -File "scripts\sync-teleagent.ps1" -Action restore

注意事项

  • TeleAgent 的 .config\TeleAgent\skills\ 目录受 Windows 权限保护,所有操作需管理员权限
  • TeleAgent 维护 skills-metadata.json 记录技能指纹,junction 内容实时更新,指纹自然匹配
  • 部分 TeleAgent 内置技能(如 canvas-design、frontend-design)在 CommonSkills 中没有对应项
  • 来自 TeleAgent Hub 的技能(如 eleppt-pro、elecom-ppt-writer)已反向导入 CommonSkills,create_source: teleagent 标记
  • 如果 TeleAgent 更新版本,需检查 builtin-meta.json 确保技能加载逻辑未改变

About

跨 Agent 平台的公共技能仓库(Skills)——支持 Kimi/Cursor/Codex/Trae/Qoder 双通道同步

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages