opencode-config
一个用于同步和管理AI编码工具及终端配置的链接工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：opencode-config。 它的用途是：一个用于同步和管理AI编码工具及终端配置的链接工具。 完整的 Skill 内容见：https://321skill.com/skills/opencode-config/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
当你拿到一台新电脑，想要快速复现自己熟悉的AI编码环境时，可以
对AI说：“帮我设置开发环境配置”。你可以先克隆这个仓库，运行 `npm run link`，它会自动将你预定义的Cursor、Claude Code等工具的配置文件链接到正确位置，让你立刻进入高效编码状态。
介绍
这个Skill解决的是开发者在多台机器或不同环境中，快速、一致地部署个人AI编码工具（如Cursor、Claude等）和终端工作流配置文件的难题。它通过一个中心化的配置文件（dotfiles.json）来管理所有配置文件的源位置和目标链接位置。
使用方式非常简单：克隆仓库后，运行 npm install 安装依赖，然后执行 npm run link 命令。该命令会根据 dotfiles.json 中的定义，自动在用户的 $HOME 目录下创建符号链接，将仓库中的配置文件（如 ~/.config/opencode, ~/.codex 等）链接到系统期望的位置。
它非常适合需要频繁在不同开发环境（如工作电脑、个人笔记本、远程服务器）间切换，并希望保持开发工具配置一致性的开发者，尤其是重度依赖AI编码助手和自定义终端工作流的全栈或后端开发人员。
建议将你的核心配置文件（如AI Agent配置、Shell配置、编辑器插件配置等）集中存放在此仓库的 dotfiles/ 目录下，并通过 dotfiles.json 进行管理。这样，任何配置变更只需在仓库中提交一次，即可通过 git pull 和 npm run link 在所有设备上同步生效，极大提升了环境配置的便携性和可维护性。
核心特点
与简单的dotfiles管理脚本不同，它专门针对AI编码工具（如Cursor、Claude Code、Windsurf等）的配置文件进行了优化和预置链接路径；同时，它采用TypeScript实现，提供了 `npm run check` 等命令进行类型检查、测试和OpenSpec验证，确保了配置链接过程的可靠性和规范性。
注意事项
不适合管理需要根据不同操作系统或发行版进行条件化处理的复杂配置场景。
常见问题
这个工具和直接用ln -s手动创建软链接有什么区别？
它通过一个声明式的JSON文件集中管理所有链接关系，避免了手动操作容易出错和遗漏的问题，并且支持一键链接所有配置，便于在多环境间同步和版本控制。
它支持Windows系统吗？
核心链接功能依赖于Node.js和文件系统的符号链接，在Windows上可能有限制或需要特定权限，主要设计用于Unix-like系统（如macOS, Linux）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/opencode-config/raw/index.md 读取 opencode-config 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/opencode-config/raw/index.md（查看排版版本）