日常工作流程
日常管理 Skill 的编辑 → sync → commit/push/pull 循环。
概览
编辑 Skill
方式一：在 Source 中编辑（推荐）
$EDITOR ~/.config/skillshare/skills/my-skill/SKILL.md
由于符号链接的存在，改动会立即体现在所有 Target 中。
方式二：在 Target 中编辑
$EDITOR ~/.claude/skills/my-skill/SKILL.md
因为 Target 是符号链接，这实际上就是在直接编辑 Source 文件。
Sync
编辑之后，由于符号链接的存在，通常不需要 sync。但以下情况需要运行 sync：
- 你安装或移除了 Skill
- 你更改了 sync mode
- 你新增或移除了 Target
- 你在 status 中看到 "out of sync"
skillshare sync
为什么 sync 是独立的一步？
Sync 被有意设计为与 install/update/uninstall 解耦。这样你可以批量处理多个变更（例如：先安装 3 个 Skill → 再统一 sync 一次），也可以在同步前用 --dry-run 预览，并完全掌控 Target 更新的时机。详见 Source & Targets: Why Sync is a Separate Step。
先预览
skillshare sync --dry-run
只 sync agents
如果你只改动了 agents（或只想把 agents 推送到支持 agent 的 Target），可以缩小 sync 范围：
skillshare sync agents
skillshare sync 会一次性同时运行 skills 和 agents 的同步。agent 文件格式与支持的 Target 参见 Agents。
Git 检查点与跨机器同步
本地提交
想要一个不推送到 remote 的本地还原点时，使用 commit：
skillshare commit -m "Update draft skill"
它会执行：
git add .git commit -m "Update draft skill"
即使 Source 仓库没有配置 remote，commit 也能正常工作。
推送变更（从这台机器）
如果你使用 git remote，push 会一步完成提交并共享变更：
skillshare push -m "Add new skill"
它会执行：
git add .git commit -m "Add new skill"git push
拉取变更（到这台机器）
skillshare pull
它会执行：
git pullskillshare sync
常见日常任务
创建新 Skill
skillshare new code-review
$EDITOR ~/.config/skillshare/skills/code-review/SKILL.md
skillshare sync
编辑或新增 agent
Agent 是位于 ~/.config/skillshare/agents/ 下的单个 .md 文件。可以直接用编辑器创建或编辑它们：
$EDITOR ~/.config/skillshare/agents/reviewer.md
skillshare sync agents
disable / enable 可以通过 .agentignore 切换单个 agent 的启用状态，而无需删除它们：
skillshare disable reviewer --kind agent # Excludes from sync
skillshare enable reviewer --kind agent # Re-enables
更新一个 tracked repo
skillshare update _team-skills
skillshare sync
更新所有 tracked repo
skillshare update --all
skillshare sync
检查状态
skillshare status
显示内容：
- Source 目录状态
- Git 状态（领先/落后的提交数）
- Target 同步状态
小技巧
让流程自动化
添加到你的 shell 启动脚本：
# ~/.bashrc or ~/.zshrc
alias ss="skillshare"
alias sss="skillshare sync"
alias ssc="skillshare commit"
alias ssp="skillshare push"
alias ssl="skillshare pull"
重要工作前先检查
# Start of day
skillshare pull
skillshare status
# Before committing
skillshare diff
保持整洁
# Weekly maintenance
skillshare audit # Scan for security threats
skillshare backup --cleanup # Remove old backups
skillshare doctor # Check for issues