collect
将本地 skills 或 agents 从 targets 收集回 source。
skillshare collect claude # 从指定 target 收集
skillshare collect --all # 从所有 targets 收集
skillshare collect claude --dry-run # 预览
skillshare collect agents claude # 收集 agents 而不是 skills
何时使用
当你直接在 target 目录中创建或编辑了资源，并希望将它们拉回 source of truth 时，使用 collect：
- 将它们添加到你的 source 以便共享
- 将它们同步到其他 AI CLI
- 用 git 备份它们
示例：
- Skills：
~/.claude/skills/my-skill/ - Agents：
~/.claude/agents/tutor.md
会发生什么
提示
在收集过程中会自动排除 .git/ 目录。如果你直接把某个 skill 仓库 git clone 到了 target 目录中，只有 skill 内容会被复制——仓库元数据会被保留在原处。
备注
Web 仪表盘的 Collect 页面目前仅支持 skills。如需 collect agents，请使用 CLI。
选项
| 标志 | 描述 |
|---|---|
--all, -a | 从所有 targets 收集 |
--force, -f | 覆盖 source 中已存在的项目并跳过确认 |
--dry-run, -n | 预览而不做任何更改 |
--json | 输出 JSON 并跳过确认；source 中已存在的项目仍需 --force 才能覆盖 |
JSON 输出
skillshare collect claude --json
{
"pulled": ["new-skill", "another-skill"],
"skipped": [],
"failed": {},
"dry_run": false,
"duration": "0.123s"
}
结合 --dry-run 预览而不做更改：
skillshare collect claude --json --dry-run
skillshare collect -p --json
skillshare collect -p agents --json
示例输出
$ skillshare collect claude
Local skills in targets
another-skill claude · ~/.claude/skills/another-skill
new-skill claude · ~/.claude/skills/new-skill
? Collect these skills to source? [y/N] y
✓ another-skill copied to source
✓ new-skill copied to source
✓ Collected 2 skills · 0.1s
Next
skillshare sync link them into every target
skillshare commit save them in git
处理冲突
如果某个项目已经存在于 source 中，默认情况下收集会跳过它：
$ skillshare collect claude
Local skills in targets
my-skill claude · ~/.claude/skills/my-skill
? Collect these skills to source? [y/N] y
! my-skill already exists in source · use --force to overwrite
! Collected 0 skills, 1 skipped · 0.0s
# 要覆盖：
$ skillshare collect claude --force
$ skillshare collect agents claude
Local agents in targets
tutor.md claude · ~/.claude/agents/tutor.md
? Collect these agents to source? [y/N] y
! tutor.md already exists in source · use --force to overwrite
! Collected 0 agents, 1 skipped · 0.0s
工作流
在 target 中创建 skill 后的典型工作流：
# 1. 在 Claude 中创建 skill
# （编辑 ~/.claude/skills/my-new-skill/SKILL.md）
# 2. 收集到 source
skillshare collect claude
# 3. 同步到所有其他 targets
skillshare sync
# 4. 提交到 git（可选）
skillshare push -m "Add my-new-skill"
对于 agents，使用专门的 collect/sync 组合：
skillshare collect agents claude
skillshare sync agents