自动化与脚本
需要把单个或集合 Skill 安装到多个本机 Agent…
把包含 `SKILL.md` 的 Skill 或 Skill 集合安装/同步/查看/卸载到本机已存在的多个 Agent,并自动处理公共入口、专属入口、Grok 适配层与冗余链接。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
需要把单个或集合 Skill 安装到多个特定
解决思路
- 用户始终使用同一条命令;脚本自动选择公共入口或专属入口,用户无需判断宿主类型,也无需添加模式参数。
- 公共入口:脚本始终把 Skill 链接写入 `~/.agents/skills/<skill-name>`。
- 以下客户端读取公共入口,因此不再写入各自专属目录:Codex、GitHub Copilot、Gemini CLI、Cursor、Augment、Roo Code、OpenCode、OpenHands。
- 同一个 Skill 不会同时出现在 `~/.agents/skills` 和上述客户端的专属目录中,以避免 Codex 等客户端重复显示。
- 专属入口:Claude Code 写入 `~/.claude/skills/<skill-name>`。
- 专属入口:WorkBuddy 写入 `~/.workbuddy/skills/<skill-name>`。
- 专属入口:Hermes Agent 写入 `~/.hermes/skills/<skill-name>`。
- 专属入口:Kiro 写入 `~/.kiro/skills/<skill-name>`。
- 专属入口:Qwen Code 写入 `~/.qwen/skills/<skill-name>`。
- 专属入口:Cline 写入 `~/.cline/skills/<skill-name>`。
- 仅当对应 Agent 主目录已经存在时,才创建专属入口链接。
- Unix-like 系统使用符号链接;Windows 的 Bash/MSYS 环境使用目录 Junction,避免 `ln -s` 在部分配置下生成实体目录副本。
- Grok 薄适配层:本机存在 `~/.grok` 时,生成 `~/.grok/skills/<skill-name>/SKILL.md`;该文件必须包含 `user_invocable: true`,并指向真源 `SKILL.md`。
- 每次执行 `link` 时,删除公共入口兼容客户端专属目录中指向同一真源的冗余链接。
- 每次执行 `link` 时,删除旧版脚本曾写入、当前已停止维护的宿主链接。
- 每次执行 `link` 时,删除同一宿主中指向同一真源、且规范名称已经存在的旧别名。
- 集合安装时删除指向集合内已失效源目录的断裂链接和 Grok 适配层。
- 清理时保留真实目录、真实文件以及指向其他来源的链接,并报告冲突。
- 清理时不删除源 Skill。
- 核心原则:一个公共入口,支持通用 Agents 目录的客户端统一读取 `~/.agents/skills`。
- 核心原则:必要时补专属入口,仅给当前仍依赖原生目录的客户端创建链接。
- 核心原则:用户无需选择模式,脚本不要求用户提供路由参数。
- 核心原则:公共兼容客户端只保留一份,Codex 等客户端不能同时存在公共入口和专属入口。
- 核心原则:各宿主只使用链接;Windows 使用目录 Junction,Unix-like 系统使用符号链接;Grok 是唯一使用薄适配层的宿主。
- 核心原则:不创建不存在的 Agent 主目录;`~/.agents` 是公共安装入口,可以由脚本创建;其他 Agent 主目录不存在时直接跳过。
- 核心原则:不覆盖真实目录;目标位置已有真实目录或文件时,保留并报告;Windows 上提示它可能是旧版 MSYS 生成的实体副本。
- 核心原则:卸载只删派生产物;`unlink` 只删除指向指定真源的符号链接或 Junction,以及本工具生成的 Grok 适配层。
- 核心原则:优先使用脚本;使用本 Skill 自带的 `scripts/install-skill.sh`,不要临场重写安装命令。
- 识别用户提供的源 Skill 形式:Skill 名称、相对路径、绝对路径、外部 Skill、Skill 集合目录、当前上下文刚创建或修改的 Skill。
- 确定源 Skill 优先级 1:用户给了绝对路径,直接使用。
- 确定源 Skill 优先级 2:用户给了相对路径,先按当前工作目录解析,再按 dbskill 仓库根目录解析。
- 确定源 Skill 优先级 3:用户只给 Skill 名称,先查当前工作目录,再查 dbskill 仓库 `skills/<name>`。
- 确定源 Skill 优先级 4:用户只说“这个 Skill”,使用当前对话刚创建、改名或讨论的 Skill。
- 确定源 Skill 优先级 5:仍不确定时,查看当前工作目录和仓库 `skills/` 下最近修改的 Skill。
- 确定源 Skill 优先级 6:仍无法确定时,只问一句:`安装哪个 Skill?给我 Skill 名称或路径。`
- 源目录必须满足任一条件:目录本身包含 `SKILL.md`,或目录的一级子目录中包含一个或多个 `SKILL.md`。
- 入口名优先读取真源 `SKILL.md` frontmatter 中的 `name`;只有 `name` 缺失时才退回源目录名。
- 这样源目录可以使用分类前缀,各 Agent 仍保持稳定的历史触发名。
- 在 dbskill 仓库根目录运行:`skills/dbs-install-skill/scripts/install-skill.sh link <skill-name-or-path>`。
- 安装示例:`skills/dbs-install-skill/scripts/install-skill.sh link dbs-hook`。
- 安装示例:`skills/dbs-install-skill/scripts/install-skill.sh link skills/my-custom-skill`。
- 安装示例:`skills/dbs-install-skill/scripts/install-skill.sh link skills`。
- 安装示例:`skills/dbs-install-skill/scripts/install-skill.sh link "/absolute/path/to/skill"`。
- 安装示例:`skills/dbs-install-skill/scripts/install-skill.sh link "/Users/me/external-skills"`。
- 执行完成后,根据脚本输出回报公共入口、专属入口、Grok 适配层和冗余清理结果。
- 查看状态:用户问“装好了吗”“有没有重复”“查看安装状态”时运行 `skills/dbs-install-skill/scripts/install-skill.sh status <skill-name-or-path>`。
- 状态正常时,脚本必须输出 `✓ 未发现冗余入口`。
- 公共兼容客户端的专属目录中仍有同源链接时,状态返回失败并报告 `✗ 发现冗余入口:<target> -> <source>`。
- 卸载 Skill:用户说“卸载 Skill”“取消安装”“unlink”时运行 `skills/dbs-install-skill/scripts/install-skill.sh unlink <skill-name-or-path>`。
- 卸载完成后告诉用户:源 Skill 没有被删除,只移除了公共入口、专属入口和 Grok 适配层等派生产物。
- 安装完成后简短回报格式:已安装 `<skill-name>`:公共入口 `~/.agents/skills/<skill-name>`;专属入口仅写入本机已安装且仍需要专属目录的 Agent;Grok `~/.grok/skills/<skill-name>/SKILL.md`(本机存在时);去重已清理指向同一真源的历史冗余链接。
- 遇到真实目录或其他来源时输出:已保留 `<target-path>`,因为它是一个真实目录、真实文件或指向其他来源。需要你手动确认后再处理。
- 自检:每次执行前后确认源目录存在。
- 自检:源目录包含 `SKILL.md`,或其一级子目录包含 `SKILL.md`。
- 自检:入口名与真源 frontmatter `name` 一致;缺失 `name` 时才使用源目录名。
- 自检:外部路径使用绝对路径,或能从当前工作目录解析。
- 自检:`~/.agents/skills/<name>` 是公共规范入口。
- 自检:Codex 等公共兼容客户端的专属目录中没有同源链接。
- 自检:专属宿主目标位置若存在,必须是指向当前真源的符号链接或 Junction。
- 自检:Grok 目标位置若存在,必须是本工具生成的 Grok 适配层才允许更新。
- 自检:真实目录、真实文件和其他来源链接没有被删除。
- 自检:源目录没有被删除。
- 自检:`private/` 与 `.private/` 没有被读取、复制、暂存或安装。
- 完成当前任务后直接结束;只有用户明确询问下一步,且当前环境已经安装 `/dbs` 时,简短提示:「下一步不确定时,可以输入 `/dbs`。」
适用边界 · 注意事项
- 源目录不存在,或源目录及其一级子目录都没有 `SKILL.md` 时,不要安装。
- 目标 Agent 主目录不存在(且不是可由脚本创建的 `~/.agents`)时,不要创建该 Agent 的入口。
- 不要用 `unlink` 删除源 Skill、真实目录、真实文件或其他来源链接;遇到这些应保留并让人手动确认。