find-agents

此技能会更改用户的 Agent 清单，必须仅由用户明确要求后执行。

不可妥协的规则：

1. 使用 agentshq 前，先确认它是否可用。
2. 明确说明范围：项目级还是全局，以及指定 IDE 还是自动检测。
3. 不要安装或移除用户未要求的 Agent。
4. 安装目标不明确时，先确认再进行更改。
5. 准确报告添加、移除或更新的内容。

查找 Agent

输入

• $request：搜索词、仓库来源，或 list、remove、update 等管理意图

目标

使用 agentshq 帮助用户：

• 查找相关 Agent
• 将 Agent 安装到一个或多个 CLI 或 IDE 中
• 列出当前清单
• 移除或更新已安装的 Agent
• 根据要求搭建新的 Agent

步骤 0：验证运行时前置条件

检查：

• Node.js 是否可用
• npx agentshq --version

如果 CLI 不可用，说明受阻原因并停止。

成功标准：可以在当前环境中调用 agentshq。

步骤 1：明确用户意图

确定用户想要：

• 搜索
• 安装
• 列出
• 移除
• 更新
• 搭建

同时明确：

• 项目级还是全局范围
• 指定的目标 IDE/CLI（如有）
• 安装时使用的来源仓库、URL 或本地路径

如果这些细节不明确，先询问，再进行任何更改。

成功标准：执行前，agentshq 要执行的具体操作已明确。

步骤 2：运行最精简的相关命令

命令参考

操作	命令	关键标志
搜索	npx agentshq find [query]	未提供查询词时显示交互式选择器
从仓库安装	npx agentshq add <owner>/<repo>	使用 @<agent-name> 指定 Agent
从 URL 安装	npx agentshq add <url>	也适用于本地路径
安装范围		-g 表示全局，--ide <name> ... 表示指定 IDE
安装选项		--all 表示将所有 Agent 安装到所有 IDE，--list 表示预览
列出已安装项	npx agentshq list	-g 表示全局，--ide <name>，--json
移除	npx agentshq remove [name]	-g 表示全局，--all 表示所有 Agent
检查更新	npx agentshq check
应用更新	npx agentshq update
搭建新 Agent	npx agentshq init [name]

安装时，请遵循以下要求：

• 用户指定 --ide ... 时，使用明确指定的选项
• 仅当用户要求全局范围时才使用 -g
• 用户希望先检查来源再安装时，使用 --list

支持的 IDE

CLI 支持 43 种以上的 IDE。常见选项：

IDE	格式
Claude Code	带 YAML frontmatter 的 .md
Cursor	AGENTS.md 章节
GitHub Copilot	.agent.md
Windsurf	AGENTS.md 章节
Codex	AGENTS.md 章节
Gemini CLI	带 YAML frontmatter 的 .md
Kiro	.json
Amp	AGENTS.md 章节
Roo Code	AGENTS.md 章节

安装时，Agent 会自动转换为各 IDE 的原生格式。

成功标准：命令与用户的意图及范围完全一致。

步骤 3：清晰报告结果

执行后，报告：

• 运行的命令
• 匹配或更改的 Agent
• 指定的客户端/IDE
• 身份验证、重新加载或重启等后续步骤

搜索时，展示最相关的结果，不要直接输出原始结果。

成功标准：用户可以立即决定下一步操作。

防护规则

• 不要主动运行此技能。
• 除非用户要求全局范围，否则不要进行全局安装。
• 没有用户明确意图时，不要移除或更新 Agent。
• 用户明确指定了特定客户端时，不要猜测目标 IDE 名称。
• 请记住，agentshq 可以将一个源 Agent 转换为多种客户端格式；务必清楚说明这一点。

输出约定

报告：

1. 已明确的操作
2. 项目级/全局范围
3. 目标 IDE 或 CLI
4. 找到或更改的 Agent
5. 用户需要了解的后续步骤