proactive-explorerlisted
Install: claude install-skill cnfjlhj/ai-collab-playbook
# 主动探索器
## 功能说明
此 Skill 落实 CLAUDE.md / AGENTS.md 中“主动探索”原则的核心理念:
> 宁可多做 10 步探索,不让用户回答 1 个本可自己找到答案的问题。
## 核心原则
### 触发条件
收到任何任务请求时
### 强制执行流程
1. **先尽最大努力自己获取信息**(Grep、Read、Bash、WebSearch)
2. **只有在所有探索手段都已尝试后才向用户提问**
3. **提问是最后手段,不是第一反应**
## 探索工具优先级
### 第 1 层:基础工具(优先使用,速度快)
#### Grep - 搜索关键词
```bash
# 搜索函数定义
# pattern: "function getCwd"
# output_mode: "files_with_matches"
# 搜索配置项
# pattern: "TELEGRAM_BOT_TOKEN"
# glob: "**/*.js"
```
**使用场景**:
- 查找函数/类定义
- 查找配置项
- 查找使用示例
- 查找错误信息
#### Glob - 查找文件
```bash
# 查找所有 JavaScript 文件
# pattern: "**/*.js"
# 查找配置文件
# pattern: "**/config*.{js,json}"
# 查找测试文件
# pattern: "**/*.test.js"
```
**使用场景**:
- 按模式查找文件
- 了解项目结构
- 查找特定类型的文件
#### Read - 读取文件
```bash
# 读取完整文件
# file_path: "/path/to/file.js"
# 读取部分文件
# file_path: "/path/to/file.js"
# offset: 100
# limit: 50
```
**使用场景**:
- 查看文件内容
- 分析代码实现
- 读取配置文件
- 查看文档
#### Bash - 执行命令
```bash
# 检查 Git 状态
git status
# 列出目录内容
ls -la /path/to/dir
# 检查进程
ps aux | grep node
# 检查端口占用
lsof -i :3000
# 查看环境变量
echo $TELEGRAM_BOT_TOKEN
```
**使用场景**:
- 检查环境状态
- 运行测试
- 查看日志
- 系统诊断
### 第 2 层:MCP 工具(需要特殊能力时)
#### CLAUDE.md - 查询项目知识
CLAUDE.md 文件本身就是 Memory,包含项目规范和历史决策。直接读取:
```bash
# 查看全局 CLAUDE.md
Read file_path="~/.claude/CLAUDE.md"
# 查看项目 CLAUDE.md
Read file_path="<project>/CLAUDE.md"
```
**使用场景**:
- 查询项目特定规范
- 查询历史决策
- 查询技术选型
#### Sequential-Thinking - 复杂推理
```javascript
// 多步骤分析
// 复杂问题分解
// 探索多种可能性
```
**使用场景**:
- 复杂问题分析
- 多方���比较
- 架构决策
#### WebSearch - 网络搜索
```javascript
// 搜索技术文档
/