企业官网建设流程全解析

不止于Skills：用skillshare extras同步rules、commands与任意文件资源

【免费下载链接】skillshare📚 Sync skills across all AI CLI tools with one command and simplify team sharing. Supporting Codex, Claude Code, OpenClaw & more项目地址: https://gitcode.com/gh_mirrors/skill/skillshare

skillshare是一款帮助你把 AI 编程助手的 Skills 在多个工具间一条命令同步的开源工具，支持 Codex、Claude Code、OpenClaw 等。但它的extras 功能常被忽略——它可以把rules、commands、prompts 甚至任意单个文件统一维护一份源头，自动分发到各个 AI CLI 工具的目录里，彻底告别手工复制粘贴。📚

什么是 extras？

对 skillshare 来说，extras 就是"非 Skills 内容的同步器"。每个 extra 由三部分组成：

• 名字：如rules、commands、prompts
• 源目录：默认在~/.config/skillshare/extras/<名字>/（项目模式下为.skillshare/extras/<名字>/）
• 目标列表：文件要分发到的各个工具目录

你可以在 Web 仪表盘左侧的Extras面板里管理所有 extra，左侧列出各资源与目标，右侧显示同步状态：

相关文档：extras 命令参考

三步上手：init → 写文件 → sync

整个过程只需三步，非常适合新手：

第 1 步：创建 extra

# 把 rules 同步到 Claude 和 Cursor 两个目标 skillshare extras init rules --target ~/.claude/rules --target ~/.cursor/rules # 也可以指定自定义源目录 skillshare extras init rules --target ~/.claude/rules --source ~/my-rules

不带参数运行skillshare extras init会进入交互式向导，询问你想同步文件夹还是单个文件，对新手更友好。

第 2 步：往源目录里放文件

把coding.md、testing.md等规则文件丢进解析出的源目录（用skillshare extras list查看具体路径）。注意：extras init只写配置，不会替你创建文件，也不会自动同步。

第 3 步：一键同步

skillshare sync extras # 只同步 extras skillshare sync --all # Skills + extras 一起同步

同步完成后，用skillshare extras list打开交互式 TUI：左侧列表用颜色标识状态（青色=已同步、黄色=有漂移、红色=未同步），按S可直接同步、按C可以回收。

常用选项速查表

新手最常问的几个点，这里一次说清：

同步模式的选择逻辑与 Skills 一致，详见 同步模式说明：merge（默认，逐文件软链、保留本地文件）、copy（真实拷贝，便携性好）、symlink（整目录一个链接）。

任意单文件同步：single-file extra

有些工具只在固定路径读固定文件，整个目录同步反而不方便。这时用单文件 extra：

# 源文件是 dotfiles 里的 system.md，目标端改名为 APPEND_SYSTEM.md skillshare extras init pi-prompt --file system.md --as APPEND_SYSTEM.md \ --source ~/dotfiles/prompts --target ~/.pi/agent skillshare sync extras

它的灵活之处在于：同一个源文件可以在不同目标用不同名字，还能混合使用merge（链接）、copy（拷贝）、import（在目标文件顶部写入一行@源文件引用，不动其余内容）。比如把一份AGENTS.md同时分发给 Codex、Claude、Gemini、opencode 四个工具，Web 界面里可以直观看到每个目标的同步开关和模式：

该方案的完整配置见 共享 AGENTS.md 指南

进阶：用 extension 转换格式

部分工具不吃 Markdown：Gemini CLI 的 commands 要 TOML，Codex 的 agents 也要 TOML。extras 的extension字段可以在同步时自动转换——源文件以 stdin 喂给转换脚本，stdout 写入目标文件，还能指定输出扩展名（如.md→.toml）：

extras: - name: commands targets: - path: .claude/commands # 原样同步 - path: .gemini/commands extension: gemini-commands # 同步时自动转成 TOML

skillshare 仓库自带三个参考扩展（gemini-commands、codex-agents、opencode-agents），拷进自己的扩展目录改改字段映射即可，机制完全跨平台，细节见 extensions/ 目录说明。

常见问题小贴士 💡

• 改了模式不生效？修改--mode、--flatten或新增目标后，记得再跑一次skillshare sync extras才会应用。
• 想回收某处直接编辑的文件？用skillshare extras collect rules --from ~/.claude/rules，加--dry-run可先预览。
• 想整体更换源目录？skillshare extras source <路径>一条命令设置全局 extras 源（仅全局模式支持）。
• Windows 用户？未开开发者模式时merge会自动退化为逐文件拷贝，功能不受影响。

总结

skillshare extras 把"每个工具各抄一份 rules"变成了"写一份、同步到所有地方"：文件夹和单文件都支持，命名、模式、格式转换全部可配。如果你已经在用 skillshare 管理 Skills，强烈建议把 rules、commands 也交给 extras 管理——多花五分钟配置，省掉以后每一次复制粘贴。✨

延伸阅读：

• extras 命令完整参考
• sync 命令说明
• extras 源码入口
• 扩展机制 README

【免费下载链接】skillshare📚 Sync skills across all AI CLI tools with one command and simplify team sharing. Supporting Codex, Claude Code, OpenClaw & more项目地址: https://gitcode.com/gh_mirrors/skill/skillshare