# 单个 skill 目录
skill-manager install ~/skills/pdf-tool

# 单个 command 文件
skill-manager install ~/commands/deepresearch.md

# 包含多个 skills 的目录（批量安装）
skill-manager install ~/skills/external-skills/

# 包含多个 commands 的目录（批量安装）
skill-manager install ~/commands/

skill-manager install https://github.com/owner/skill-repo
skill-manager install owner/skill-repo

# 完整 URL 到子目录
skill-manager install https://github.com/jgtolentino/insightpulse-odoo/tree/main/docs/claude-code-skills/community

# 简写格式：owner/repo/branch/path/to/skills-directory
skill-manager install jgtolentino/insightpulse-odoo/main/docs/claude-code-skills/community

# 使用脚本安装
scripts/install.sh [--target <dir>] <source>

# 示例
scripts/install.sh ~/dev/my-skills/pdf-tool
scripts/install.sh ~/dev/my-commands/deepresearch.md
scripts/install.sh ~/dev/my-skills/
scripts/install.sh ~/dev/my-commands/
scripts/install.sh https://github.com/anthropics/claude-code
scripts/install.sh jgtolentino/insightpulse-odoo/main/docs/claude-code-skills/community

# 显式指定目标（从非项目目录调用时使用）
scripts/install.sh --target /path/to/project/.claude ~/dev/my-skills/pdf-tool

scripts/list.sh

scripts/remove.sh <name>

scripts/update.sh [name]

scripts/check.sh

python3 scripts/record.py list

scripts/init.sh [选项]

# 初始化所有默认 Agent
scripts/init.sh

# 仅初始化指定 Agent
scripts/init.sh --qoderwork --workbuddy

# 初始化全部 Agent（含 .claude）
scripts/init.sh --all

# 预览模式（不实际修改文件）
scripts/init.sh --dry-run

# 初始化并同步更新 .gitignore
scripts/init.sh --gitignore

# ========== 安装 ==========
# 安装本地单个 skill
skill-manager install ~/dev/my-skills/pdf-tool

# 批量安装本地目录下的所有 skills
skill-manager install ~/dev/my-skills/
skill-manager install ../other-project/.claude/skills/

# 在 Codex 全局目录中调用时，安装到 ~/.codex/skills/
cd /Users/maoking/.codex
skill-manager install ~/dev/my-skills/pdf-tool

# 在 QoderWork 全局目录中调用时，安装到 ~/.qoderworkcn/skills/
cd ~/.qoderworkcn
skill-manager install ~/dev/my-skills/pdf-tool

# 从全局目录调用但安装到指定项目（使用 --target 避免装错位置）
skill-manager install --target /path/to/project/.claude ~/dev/my-skills/pdf-tool

# 从 GitHub 仓库根目录安装
skill-manager install https://github.com/anthropics/claude-code
skill-manager install anthropics/claude-code

# 从 GitHub 子目录安装
skill-manager install https://github.com/jgtolentino/insightpulse-odoo/tree/main/docs/claude-code-skills/community
skill-manager install jgtolentino/insightpulse-odoo/main/docs/claude-code-skills/community

# ========== 查看与管理 ==========
# 列出已安装的 skills
skill-manager list

# 卸载 skill
skill-manager remove pdf-tool

# ========== 更新与检查 ==========
# 检查所有 skills 的更新
skill-manager check

# 更新所有 git 克隆的 skills
skill-manager update

# 更新指定 skill
skill-manager update claude-code

# 查看安装记录
python3 scripts/record.py list

# 1. 先 dry-run 看计划（默认只打印，不动任何链接）
python3 scripts/relink-skill.py \
  --old /path/to/skills/old-name \
  --new /path/to/skills/new-name

# 2. 项目级安装位置因人而异，把你的项目根传进来（可多次）
python3 scripts/relink-skill.py --old ... --new ... \
  --roots ~/code/project-a --roots "~/Library/Application Support/MyProjects"

# 3. 历史快照目录（visualizations、post-freeze 等不再运行的现场）默认不修，用排除模式跳过
python3 scripts/relink-skill.py --old ... --new ... \
  --exclude-glob '*/visualizations/*' --exclude-glob '*/post-freeze/*'

# 4. 确认计划无误后执行，并留 JSON 报告备查
python3 scripts/relink-skill.py --old ... --new ... \
  --exclude-glob '*/visualizations/*' --apply --report /tmp/relink-report.json

# 5. 不确定项目都在哪时，全盘扫描整个用户主目录
#    （自动跳过 Caches/Containers/iCloud 挂载/图库等重资源区，耗时数分钟；
#     外置卷另用 --roots /Volumes/卷名 追加，exFAT 不支持软链通常可略）
python3 scripts/relink-skill.py --old ... --new ... --full-home \
  --exclude-glob '*/visualizations/*' --exclude-glob '*/post-freeze/*'

# 6. 登记优先（最快路径）：先为当前技能的链接建档，之后改名直接查表零扫描
python3 scripts/relink-skill.py --old /当前/技能目录 --new /当前/技能目录 --register --roots <项目根>
#    下次改名（秒级，读 registry install_links 直接定位）：
python3 scripts/relink-skill.py --old /旧目录 --new /新目录 --from-registry --apply

skill-manager/
├── SKILL.md                    # 本文件
├── CHANGELOG.md                # 变更日志
├── CLAUDE.md                   # AI 开发助手说明
├── LICENSE.txt                 # 许可证
├── scripts/
│   ├── install.sh              # 安装脚本
│   ├── list.sh                 # 列表脚本
│   ├── remove.sh               # 卸载脚本
│   ├── update.sh               # 更新脚本
│   ├── check.sh                # 更新检查脚本
│   ├── init.sh                 # 项目 Agent 初始化脚本
│   ├── auto-check.sh           # 定期自动检查触发器
│   ├── target.sh               # Agent 配置目录识别模块
│   ├── record.py               # 记录管理模块
│   └── security.py             # 安全检查模块
└── assets/                     # 资源文件
    ├── skill-registry.json     # Skill 安装记录（运行时生成）
    └── skill-registry.example.json  # 注册表示例