技能介绍

解决的问题

当你同时在 Cursor、Claude、Windsurf、Cline、Continue、Roo Code、Copilot、Codex、Aider 和 Augment 之间切换时，技能和规则并不存放在统一位置。Cursor、Claude 使用 SKILL.md 目录结构，Windsurf、Cline 等使用 .md 规则文件，而 Copilot、Codex 等则是单文件配置。手动管理很容易出现路径记错、命名不统一、启用禁用不方便、项目级和全局级规则冲突等问题。manageskills 的核心目标，是把不同工具的目录布局、文件格式和常见操作收敛到一套终端流程里。

技能如何工作

这个技能首先定义了每类工具应使用的全局路径和项目路径。对于 Agents、Cursor、Claude 这类目录型工具，每个技能位于独立子目录，并包含带 YAML frontmatter 的 SKILL.md。Windsurf、Cline、Continue、Roo Code 的规则文件是普通 .md，frontmatter 可选。Copilot、Codex、Aider、Augment 则分别对应单文件配置，例如 ~/.github/copilot-instructions.md、~/.codex/AGENTS.md 或 ~/.aider.conf.yml。

在操作层，技能覆盖常见管理动作：

列出全部技能；
读取单个技能；
创建新技能；
启用或禁用技能；
在工具之间复制技能；
移动、删除技能；
将全局技能复制到项目范围；
跨所有技能搜索；
查找已禁用技能。

禁用不是直接删除文件，而是将文件重命名为 .disabled 后缀。这样工具会忽略该技能，但内容仍保留，方便回滚。跨工具复制时，如果源工具使用 SKILL.md，目标工具使用普通 .md，需要调整文件命名和格式，而不是直接覆盖。

适用边界与注意点

目录型技能遵循“项目级覆盖全局级”的规则。同名技能下，项目路径中的版本优先于全局路径中的版本。对于 Copilot、Codex、Aider、Augment 这类单文件工具，编辑意味着替换整个文件内容，不能像目录技能一样只修改单个 SKILL.md。

删除操作需要谨慎，技能要求在删除前始终确认。Cursor 插件缓存中的技能属于只读内容，不应直接编辑。跨工具复制时，如果源与目标格式不同，例如从 Cursor 的 SKILL.md 复制到 Windsurf 的普通 .md，需要适配 frontmatter 和文件名。创建新技能时，目录名应使用 kebab-case，例如 my-new-skill。

这个技能不负责安装命令、市场分发或自动同步，它的价值在于给出一套统一、可执行的技能管理约定，让终端用户能够用相近的方式维护不同 AI 编码工具的技能与规则。