skills-search

Skills 搜索 — Agent 行为指令

优先搜索本地仓库

如需发现能力或复用经验，请阅读 本地仓库搜索并执行其 辅助程序。从已加载的此捆绑包解析 Skill 目录，不要凭记忆猜测已安装的路径。

uv run --script <skill-dir>/scripts/local_sources.py list
uv run --script <skill-dir>/scripts/local_sources.py search '<capability>' --tier owned

在选择候选项之前，搜索自有层级中的每个已启用仓库。 阅读返回的 coverage、已检查数量和确切提交。缺少源、 配置错误或扫描中断都表示覆盖不完整，而非“没有 Skill”。 默认安装目录只是清单，并非用户的完整来源目录。配置用户指定的所有仓库；不要在第一个仓库找到结果后就停止，也不要默默推断另一台机器上的路径。

逐步展开：目录名称／描述 → 所选提交中的 SKILL.md → 仅查看相关的链接参考资料／脚本。元数据评分用于排列候选项；决定是否适用前，请阅读其能力、输入、归属和验证方式。更新合适的现有 Skill；若没有合适的 Skill，则创建新的 Skill，而不是把工作流塞进无关的归属项中。

如果此层无法解决剩余任务，则搜索已配置的 trusted 仓库，然后使用下方现有的 CCPM 搜索。记录扩展搜索的原因；不要向注册表发送私有路径、仓库名称或内容。不要用外部搜索结果掩盖失败的本地扫描。

CCPM 准备（仅在需要时）

如需搜索外部注册表，或用户明确要求安装／更新／管理操作，请检查 command -v ccpm。如果不可用，npx @daymade/ccpm 是现有 CLI 后备方案。本地查找既不需要 CCPM，也不需要注册表凭据。仅当用户要求设置生态系统时，才使用 npx @daymade/ccpm setup：它还会配置集成，并非离线搜索的前提条件。

核心行为

通过 shell 自行执行选定的本地辅助程序或 ccpm 命令。 不要要求用户复制粘贴你有权在任务中运行的命令。

如果未全局安装 ccpm，则将 npx @daymade/ccpm 作为下方所有命令的直接替代方案。

意图映射

将用户意图匹配到正确的操作：

用户意图	操作
“查找 X 的技能”／“搜索 X 技能”／编写 Skill 前先复用	自有仓库 → 已配置的可信仓库 → 如仍有需要，则执行 ccpm search <query>
“哪些技能受欢迎”／“热门技能”	ccpm popular
“有什么新内容”／“最新技能”	ccpm recent
“安装 X”／“添加 X 技能”	ccpm install <skill-name>
“X 是做什么的”／“介绍一下 X”	先阅读本地候选项；对于注册表候选项，执行 ccpm info <skill-name>
“我有哪些技能”／“列出技能”	ccpm list
“移除 X”／“卸载 X”	ccpm uninstall <skill-name>
“更新 X”／“更新所有技能”	ccpm update [name] [--all]
“我需要处理 PDF／Excel／……”	先在本地发现；如有需要，再扩展到 ccpm search <topic>，然后检查是否适用再建议安装

执行规则

1. 始终直接执行 — 运行选定的本地辅助程序或 ccpm 命令，绝不要求用户手动运行。
2. 总结结果 — 执行后，以清晰易读的格式呈现输出。
3. 根据结果选择 — 本地 Skill 可能已经安装。请另行验证；不要仅因找到它就重新安装。如需安装，请保留现有的选择加入安装流程。安装后提醒用户重启 Claude Code。
4. 妥善处理错误 — 如果找不到 ccpm，则改用 npx @daymade/ccpm。如果无法连接注册表，请明确说明。
5. 命名空间 Skill — 支持 @org/skill-name 格式（例如 ccpm install @daymade/skill-creator）。

命令参考

搜索

ccpm search <query> [--limit <n>] [--tags <t1,t2>] [--author <name>] [--smart]

发现

ccpm popular [--limit <n>]       # Most downloaded
ccpm recent [--limit <n>]        # Recently published/updated

安装与管理

ccpm install <skill-name>        # Install (user-level, default)
ccpm install <name> --project    # Install to current project only
ccpm install <name> --force      # Force reinstall
ccpm list                        # List installed skills
ccpm info <skill-name>           # Detailed skill information
ccpm update [name]               # Update a skill
ccpm update --all                # Update all skills
ccpm uninstall <skill-name>      # Remove a skill

安装后提醒

每次成功安装后，始终告知用户：

Skill 已成功安装。请重启 Claude Code（或开始新对话），以启用该 Skill。

MCP 服务替代方案

对于希望使用原生工具集成（无需 Bash）的 Claude Desktop 用户，可通过 MCP 服务使用相同功能：

{
  "mcpServers": {
    "skill-search": {
      "command": "npx",
      "args": ["-y", "skills-search-mcp"]
    }
  }
}

MCP 服务封装了外部 ccpm CLI。它不会搜索此 Skill 配置的本地仓库；本地发现仍由捆绑的辅助工具负责。

故障排除

“ccpm: command not found”

请改用 npx @daymade/ccpm，或全局安装：npm install -g @daymade/ccpm。

安装后 Skill 不可用

重启 Claude Code——Skill 会在启动时加载。

权限错误

检查对 ~/.claude/skills/ 的写入权限。尝试使用 --project 进行项目级安装。