dotagents

统一管理多个AI开发工具的配置与技能

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:dotagents。
它的用途是:统一管理多个AI开发工具的配置与技能
完整的 Skill 内容见:https://321skill.com/skills/dotagents/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

当你需要在 Claude、Cursor 和 Gemini 中都使用同一套代码审查指令时,只需将这些指令放在 `.agents/commands` 目录下,然后运行 `npx @iannuttall/dotagents` 并选择链接这些工具。之后,无论你在哪个工具中,都能调用相同的指令集,无需分别维护。

介绍

dotagents 解决了开发者在多个AI辅助工具(如 Claude、Cursor、Gemini 等)间切换时,配置、技能和指令分散、难以同步和维护的痛点。它通过创建一个中心化的 .agents 文件夹作为唯一事实来源,并自动为选定的工具创建符号链接,确保所有工具都使用同一套配置。

使用方式非常简单,只需运行一个命令行工具(npx @iannuttall/dotagents),通过交互式向导选择工作区范围(全局或项目级)和需要管理的客户端,工具便会自动处理链接创建、备份和修复。整个过程可随时安全地重新运行,以添加新工具或撤销更改。

它非常适合同时使用多种AI编程工具的开发者,尤其是那些希望在不同工具间保持技能、提示词和钩子脚本一致性的用户,能显著减少重复配置和同步的麻烦。

与手动为每个工具单独配置或使用其他同步脚本相比,dotagents 的核心优势在于其‘一站式’和‘安全可逆’的设计理念。它明确支持主流的AI开发工具链,并智能处理不同工具的文件命名偏好(如 CLAUDE.md 与 AGENTS.md),同时每次操作前都会自动备份,让用户无后顾之忧。

核心特点

核心区别在于其“单一事实来源”的设计理念,通过一个中心化的 `.agents` 目录统一管理所有主流AI开发工具的配置,并自动处理不同工具间的文件命名差异和符号链接,同时每次操作前必做备份,确保更改完全可逆。

注意事项

主要面向使用特定AI开发工具(如Claude、Cursor、Gemini等)的开发者,对于不使用这些工具或仅需管理单一工具配置的用户来说可能过于复杂。

常见问题

dotagents 是做什么的?

它是一个配置管理工具,帮你用一个中心文件夹统一管理多个AI开发工具(如Claude、Cursor)的技能、指令和配置。

使用 dotagents 安全吗?会覆盖我的配置吗?

安全。它在任何覆盖操作前都会自动创建备份,你可以随时运行工具来修复链接或撤销上一次的更改。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/dotagents/raw/index.md 读取 dotagents 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。