Codex Skill 批量迁移到 WorkBuddy Skill 系统 Skill

Codex Skill 批量迁移到 WorkBuddy Skill 系统 Skill

它解决什么问题

~/.codex/skills/ 与 ~/.workbuddy/skills/ 的 SKILL.md 结构大体一致（目录 + SKILL.md + frontmatter），但直接复制会踩三类坑：

1. frontmatter 缺失或缩进错：部分 Codex skill 没有 frontmatter，或 name/description 字段多了缩进，导致 WorkBuddy 识别失败。 2. CRLF 行尾：Codex 侧文件多为 CRLF，WorkBuddy 解析首行 --- 时可能因 \r 误判。 3. 同名冲突：两边同名目录（如 miaoshou-erp-*）直接覆盖会丢失 WorkBuddy 已有版本。

迁移原则

• 用户级优先：默认迁到 ~/.workbuddy/skills/（跨项目可用）；仅项目相关 skill 才放 {workspace}/.workbuddy/skills/。
• 排除项：*.backup.* 目录、.system 隐藏/系统内置目录一律不迁。
• 冲突策略：同名目录保留 WorkBuddy 现有版，不覆盖。
• 可验证：迁移完必须逐条跑首行 --- 解析验证，不允许"看着对了就完"。

分步操作

Step 1：盘点源目录

ls ~/.codex/skills/ | wc -l
find ~/.codex/skills -name SKILL.md | wc -l
# 找出可能冲突的同名目录
for d in ~/.codex/skills/*/; do
  name=$(basename "$d")
  [ -d ~/.workbuddy/skills/"$name" ] && echo "CONFLICT: $name"
done

Step 2：复制（保留冲突侧）

用 rsync 的 --ignore-existing 保证不覆盖 WorkBuddy 已有同名目录：

rsync -av --ignore-existing \
  --include='*/' \
  --include='SKILL.md' \
  --exclude='*.backup.*' \
  --exclude='.system' \
  ~/.codex/skills/ ~/.workbuddy/skills/

Step 3：修 CRLF

# 找出 CRLF 文件
find ~/.workbuddy/skills -name SKILL.md -print0 \
  | xargs -0 file | grep CRLF
# 逐个转换
find ~/.workbuddy/skills -name SKILL.md -print0 \
  | xargs -0 sed -i '' 's/\r$//'

Step 4：补 frontmatter

对无 frontmatter 或缺字段的文件，补上：

---
name: <目录名>
description: <一句话说明，取自 SKILL.md 正文首段或 README>
---

Step 5：验证（必跑）

用 Python 逐条验证（不要 shell grep，macOS 上 \r 会让 ^---$ 误判）：

import pathlib
ok = bad = 0
for p in pathlib.Path("~/.workbuddy/skills").expanduser().glob("*/SKILL.md"):
    if p.read_text().lstrip().startswith("---"):
        ok += 1
    else:
        bad += 1
        print("FAIL:", p)
print(f"PASS {ok} / FAIL {bad}")

常见坑

• 不要用 shell `grep '^---$'` 验证：文件若带 \r，匹配会失败造成假阴性；统一用 Python lstrip().startswith("---")。
• 备份目录不要排除漏：*.backup.* 后缀的目录是历史备份，混入会翻倍。
• 同名冲突先人工确认：保留哪一侧要过目一遍 SKILL.md 内容，别盲信 rsync 的 --ignore-existing。

验收

• 复制成功数量 = 源目录数 − 排除项 − 冲突保留项。
• 验证脚本 FAIL = 0。
• 随机抽 3 条在 WorkBuddy 里能正常触发/展示。