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-* 技能来自 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 平台扫描本地文件系统时跟随软链接(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 立即生效 - 零维护:无需手动复制
- 节省磁盘空间
Kimi 桌面客户端(Work 模式)的 daimon 内核在扫描技能目录时,会跳过 Symbolic Link(软链接)。因此必须采用原生目录复制方式:
| Agent 程序 | 复制目标路径 | 来源 |
|---|---|---|
| Kimi Work 模式 | ~/AppData/Roaming/kimi-desktop/daimon-share/daimon/skills/<skill-name> |
~/CommonSkills/<skill-name> |
特点:
- 需要复制(不是软链接)
daimon内核加载时视为原生技能,UI 可正常显示和调用- 更新后需重新同步
打开 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
}# 复制到 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 实现:当 CommonSkills 仓库更新(pull / merge / checkout)时,自动触发同步脚本,确保 Kimi Work 模式的技能目录始终与仓库最新版本一致。
| Hook 类型 | 触发时机 | 作用 |
|---|---|---|
post-merge |
执行 git pull 或 git merge 后 |
同步最新技能到 Kimi Work 模式 |
post-checkout |
执行 git checkout 切换分支后 |
同步当前分支技能到 Kimi Work 模式 |
post-commit |
执行 git commit 后 |
可选:同步本地修改到 Kimi Work 模式 |
#!/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] 同步完成。"# 在 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-
在
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
-
提交到 Git
cd ~/CommonSkills git add my-new-skill/ git commit -m "add: my-new-skill" git push
-
自动同步(Git Hook)
post-commit/post-merge/post-checkout会自动执行同步脚本- Kimi Work 模式目录会复制新增技能
- 其他 Agent(Cursor/Codex/Trae/Qoder/KimiCodeIDE)通过软链接实时生效
-
验证
- 重启 Kimi 客户端(Work 模式),搜索新技能名称
- 在 Cursor/Codex/Trae/Qoder 中验证新技能可用
- 重启 Kimi 客户端,搜索新技能名称
- 在 Cursor/Codex/Trae/Qoder 中验证新技能可用
| 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 支持。
根本原因: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 模式加载。
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可能无效)
Kimi 客户端打包了 34 个内置技能(builtin-skills),位于:
~/AppData/Roaming/kimi-desktop/daimon-bundle/app/daimon/assets/builtin-skills/
这些技能有 builtInSkillsSha256 校验,不建议修改。
若宿主技能目录是指向仓库的 Junction,该宿主自行更新技能时会直接改写仓库文件(历史事故:time-awareness、worker-safety、kimiim 的 frontmatter 被回退)。处置方式见 docs/skill-host-sync.md:优先把宿主的写目录隔离出去并保留 extra_skill_dirs 只读加载。
排查步骤:
- 确认技能目录在
daimon-share/daimon/skills/下是原生目录(不是软链接)ls -la ~/AppData/Roaming/kimi-desktop/daimon-share/daimon/skills/<skill-name> # 如果显示 lrwxrwxrwx -> ...,说明是软链接,需要替换为复制
- 确认
SKILL.md的 YAML frontmatter 格式正确:--- name: skill-name description: 技能描述 version: 1.0.0 ---
- 确认技能目录名与
SKILL.md中的name一致 - 重启 Kimi 客户端
排查步骤:
- 确认软链接目标路径存在
- 确认软链接没有被破坏(如目标目录被移动或删除)
- 重新创建软链接:
rm -f ~/.agents/skills/<skill-name> ln -s ~/CommonSkills/<skill-name> ~/.agents/skills/<skill-name>
- yaolifeng.com - symlink_git_personal_agent_skill
- Kimi Code 官方文档:
.kimi/skills/和.agents/skills/目录规范 - Node.js
fs.readdir与dirent.isSymbolicLink()行为说明
| 版本 | 日期 | 变更 |
|---|---|---|
| 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 独立技能目录( |
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 确保技能加载逻辑未改变