Recon

自定义

执行前，请检查以下位置是否有用户自定义内容： ~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/Recon/

如果此目录存在，请加载并应用其中的 PREFERENCES.md、配置或资源。这些内容优先于默认行为。如果此目录不存在，则使用技能默认设置。

recon

基础设施与网络侦察

🚨 强制要求：语音通知（任何操作前都必须执行）

调用此技能时，必须先发送此通知，然后才能执行其他操作。

1. 发送语音通知：

   curl -s -X POST http://localhost:8888/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running the WORKFLOWNAME workflow in the Recon skill to ACTION"}' \
     > /dev/null 2>&1 &
   

2. 输出文本通知：

   Running the **WorkflowName** workflow in the **Recon** skill to ACTION...
   

此步骤不可省略。调用技能后，请立即执行此 curl 命令。

用途

对网络基础设施开展技术侦察，包括域名、IP 地址、网段和 ASN。结合被动情报收集与经授权的主动扫描，以绘制攻击面并识别资产。

何时使用此技能

核心触发条件——用户提出以下请求时使用此技能：

直接侦察请求

• “对 [target] 进行侦察”或“运行侦察”
• “对 [target] 开展侦察”或“进行侦察”
• “进行基础设施侦察”或“网络侦察”
• “基础侦察”、“快速侦察”、“简单侦察”
• “全面侦察”、“深度侦察”、“完整侦察”
• “侦察 [target]”（仅输入侦察 + 目标）
• “被动侦察”、“主动侦察”

基础设施与网络映射

• “映射 [domain] 的基础设施”或“映射网络”
• “枚举 [domain] 的基础设施”或“发现资产”
• “查找 [domain] 的子域名”或“枚举子域名”
• “扫描 [target]”或“端口扫描 [IP/netblock]” -“[IP] 上运行着哪些服务”
• “调查 [IP address/domain/netblock]”

IP 与域名调查

• “侦察此 IP”或“调查此 IP 地址”
• “查询 [IP]”或“IP 查询 [address]”
• “[IP] 是什么”或“[IP] 的所有者是谁”
• “域名侦察”或“域名调查”
• “DNS 侦察”、“DNS 枚举”
• “WHOIS [domain/IP]”

ASN 与网段研究

• “调查 [ASN]”或“研究 ASN”
• “扫描 [CIDR range/netblock]”
• “查找 [netblock] 中的 IP”
• “枚举网段”或“网段扫描”

被动与主动侦察

• “对 [target] 进行被动侦察”（无需授权）
• “主动扫描 [target]”（需要明确授权）
• “安全侦察”（仅被动侦察）
• “经授权的扫描”（主动技术）

使用场景提示

• 调查 IP 地址的所有权、位置和服务
• 绘制域名基础设施和 DNS 配置
• 扫描网段或 CIDR 范围，查找在线主机
• 研究 ASN 所有权和 IP 分配情况
• 枚举攻击面并映射网络
• OSINT 为实体绘制基础设施时调用

与其他安全技能的关系

OSINT → recon（常见模式）：

• OSINT 识别实体、公司和人员（侧重社交与公共记录）
• recon 绘制其技术基础设施（侧重网络与系统）
• 示例流程：OSINT 发现公司 → Recon 绘制其域名、IP 和基础设施

recon → webassessment：

• Recon 识别 Web 应用和服务
• Web 评估测试这些应用是否存在漏洞
• 示例：Recon 发现子域名 api.target.com → Web 评估对其进行模糊测试和检测

工作流集成：

// OSINT skill discovers company infrastructure
const domains = await osintFindCompanyDomains("Acme Corp");

// Calls recon skill to map technical details
const infraMap = await reconDomain(domains[0]);

// Recon identifies web apps
const webApps = infraMap.subdomains.filter(s => s.hasHTTP);

// Calls web assessment for testing
await webAssessment(webApps);

核心能力

被动侦察（无需授权）

• WHOIS 查询（域名和 IP）
• DNS 枚举（A、AAAA、MX、NS、TXT、CNAME、SOA 等）
• 证书透明度搜索（子域名、证书历史记录）
• IPInfo API（地理位置、ASN、组织、滥用举报联系人）
• 反向 DNS 查询
• BGP/ASN 信息收集
• 历史 DNS 数据
• 公共数据库搜索

主动侦察（需要明确授权）

• 端口扫描（naabu MCP）
• 服务检测和 Banner 抓取（httpx MCP）
• 技术指纹识别
• 在线主机发现
• HTTP/HTTPS 探测
• SSL/TLS 分析

关键授权要求：

主动侦察必须满足以下要求：

1. 获得用户对每次主动扫描的明确确认
2. 有记录在案的授权（渗透测试项目、漏洞赏金计划、自有资产）
3. 验证范围（确保目标在授权范围内）
4. 限制速率（以尊重目标的方式扫描，不造成拒绝服务）
5. 记录会话日志（记录所有主动侦察活动，以便审计）

默认行为仅限被动侦察。 使用主动技术前务必先确认。

可用工作流

1. PassiveRecon.md - 安全侦察

使用公开来源收集非侵入式情报：

• WHOIS 数据
• DNS 记录
• 证书透明度
• IPInfo 查询
• 反向 DNS
• 不进行主动扫描

输入： 域名、IP 或网段 输出： 被动情报报告 授权： 无需授权

2. IpRecon.md - IP 地址调查

全面的 IP 地址侦察：

• IPInfo 查询（位置、ASN、组织、滥用联系信息）
• 反向 DNS
• WHOIS 网段信息
• 证书搜索（如果 IP 有证书）
• 可选：端口扫描（需授权）
• 可选：服务检测（需授权）

输入： 单个 IP 地址 输出： IP 侦察报告 授权： 主动扫描需授权

3. DomainRecon.md - 域名调查

全面的域名映射和枚举：

• WHOIS 域名注册信息
• DNS 记录（所有类型）
• 子域名枚举（证书透明度）
• 邮件服务器配置（MX、SPF、DMARC、DKIM）
• 域名关联的 IP 地址
• 证书分析
• 技术栈检测
• 历史数据

输入： 域名 输出： 域名侦察报告 授权： 主动探测子域名需授权

4. NetblockRecon.md - CIDR 范围扫描

网络范围侦察：

• CIDR 解析和验证
• 范围大小计算
• WHOIS 网段所有权
• 可选：在线主机发现（需授权）
• 可选：范围端口扫描（需授权）
• ASN/组织映射
• 有趣主机识别

输入： CIDR 表示法（例如，192.168.1.0/24） 输出： 网段扫描报告 授权： 主动扫描需授权

5. ASN 调查

ASN 和 BGP 侦察（使用 WHOIS、IPInfo 和公开 BGP 数据进行内联处理）：

• ASN 到 CIDR 范围的映射
• 组织信息
• ASN 所有的所有 IP 范围
• BGP 对等关系
• 地理分布
• 主机托管服务商/ISP 识别

输入： ASN 编号（例如，AS15169） 输出： ASN 映射报告 授权： 无需授权（被动数据）

工具集成

主要工具

IPInfo API（ipinfo.io）

• API 密钥：process.env.IPINFO_API_KEY
• 功能：地理定位、ASN、组织、滥用联系信息、隐私检测
• 速率限制：请查看 API 方案
• 客户端：Tools/IpinfoClient.ts

系统工具（始终可用）

• whois - 域名和 IP 的 WHOIS 查询
• dig - DNS 查询
• nslookup - DNS 解析
• curl - HTTP 请求、API 调用

MCP 工具（需要安全配置）

• httpx - HTTP 探测和技术检测
• naabu - 端口扫描
• 注意：需要安全 MCP 配置（~/.claude/MCPs/swap-mcp security）

未来的工具集成

Shodan（添加 API 密钥后）

• 搜索暴露的服务
• 历史扫描数据
• 漏洞信息

Censys（添加 API 密钥后）

• 证书搜索
• 主机发现
• 全网扫描数据

SecurityTrails（添加 API 密钥后）

• 历史 DNS 记录
• WHOIS 历史记录
• 子域名发现

VirusTotal（添加 API 密钥后）

• 域名/IP 信誉
• 被动 DNS
• 恶意软件关联

TypeScript 工具

位于 Tools/ 目录：

IpinfoClient.ts

• 带错误处理的 IPInfo API 封装
• 支持批量查询
• 速率限制
• 响应解析

DnsUtils.ts

• DNS 枚举辅助工具
• 查询记录类型
• 尝试区域传送
• 子域名暴力枚举

WhoisParser.ts

• WHOIS 数据解析
• 将原始 WHOIS 数据转换为结构化输出
• 提取注册日期
• 解析联系信息

CidrUtils.ts

• 解析 CIDR 表示法
• 计算 IP 范围
• 验证范围
• 根据 CIDR 生成 IP 地址

输出格式

IP 侦察报告

# IP Reconnaissance: 1.2.3.4

## Summary
- IP: 1.2.3.4
- Organization: Example Corp
- ASN: AS12345
- Location: San Francisco, CA, US
- ISP: Example Hosting

## DNS
- Reverse DNS: server.example.com
- Additional PTR: ...

## Network Information
- CIDR: 1.2.3.0/24
- Netblock Owner: Example Corp
- Abuse Contact: [email protected]

## Services (Passive)
- Certificates: 3 certificates found
- Historical DNS: ...

## Services (Active - Authorized)
- Open Ports: 22, 80, 443
- Services: SSH (OpenSSH 8.2), HTTP (nginx 1.20.1), HTTPS
- Technologies: nginx, OpenSSH

## Recommendations
- Further investigation areas
- Related assets
- Security observations

域名侦察报告

# Domain Reconnaissance: example.com

## Summary
- Domain: example.com
- Registrar: Example Registrar
- Registration: 2010-01-15
- Expiry: 2026-01-15

## DNS Records
### A Records
- 1.2.3.4
- 5.6.7.8

### MX Records
- 10 mail.example.com

## Subdomains
- www.example.com (1.2.3.4)
- api.example.com (1.2.3.5)
- admin.example.com (1.2.3.6)

## Email Security
- SPF: Configured
- DMARC: Configured
- DKIM: Configured

## Technologies
- Web Server: nginx
- Framework: React
- CDN: Cloudflare

## Recommendations
- Interesting subdomains: admin.example.com, api.example.com
- Attack surface: 15 web applications identified

报告保存至：

• 工作目录（~/.claude/MEMORY/WORK/{current_work}/）——用于调查期间的迭代产物
• MEMORY/RESEARCH/（~/.claude/MEMORY/RESEARCH/YYYY-MM/）——用于渗透测试项目和正式评估

MCP 配置要求

被动侦察： 无需特殊 MCP 配置

主动侦察： 需要安全 MCP 配置

# Switch to security profile
~/.claude/MCPs/swap-mcp security

# Restart Claude Code to apply
# Then run active reconnaissance

安全配置包含：

• httpx（HTTP 探测）
• naabu（端口扫描）
• 其他安全工具

道德与法律注意事项

重要规则：

1. 先获得授权——未经明确授权，绝不进行主动扫描
2. 验证范围——确保目标属于测试范围
3. 速率限制——以审慎的方式扫描，不进行 DoS 或激进操作
4. 记录文档——记录所有侦察活动、时间戳和授权信息
5. 负责任地披露——如发现漏洞，请遵循负责任的披露流程
6. 不得进行破坏性测试——仅限侦察，不得利用漏洞

授权类型：

• 渗透测试项目（书面 SOW/合同）
• 漏洞赏金计划（仅限范围内的目标）
• 自有资产（你自己的基础设施）
• 研究实验室/CTF 环境

绝不扫描：

• 未经许可的系统
• 范围外的目标
• 关键基础设施
• 政府系统（未经特定授权）

如有疑问： 请求明确确认并取得书面授权。

使用示例

示例 1：被动域名侦察

User: "Do passive recon on example.com"

Assistant: Activating recon skill with passive-recon workflow.
     Target: example.com
     Mode: Passive only (no active scanning)

     [Performs WHOIS, DNS, cert transparency, IPInfo]
     [Generates report in scratchpad]

     Report: ~/.claude/MEMORY/WORK/{current_work}/recon-example-com/

示例 2：使用主动扫描调查 IP

User: "Investigate IP 1.2.3.4 - I own this server"

Assistant: Activating recon skill with ip-recon workflow.
     Target: 1.2.3.4

     Authorization check: You confirmed this is an owned asset.
     Proceeding with passive + active reconnaissance.

     [Performs IPInfo, reverse DNS, WHOIS, port scan, service detection]
     [Generates comprehensive report]

     Report: Open ports found (22, 80, 443)
             Services: SSH, HTTP, HTTPS
             Technologies: nginx 1.20.1, OpenSSH 8.2

示例 3：与 OSINT 集成

User: "Do OSINT on Acme Corp and map their infrastructure"

Assistant: Activating OSINT skill...
     Found domains: acme.com, acmecorp.com, acme.io

     Now calling recon for infrastructure mapping...

     [Recon skill maps each domain]
     [Discovers subdomains, IPs, netblocks]
     [Creates comprehensive infrastructure map]

     Report: Complete OSINT + Infrastructure report
             15 domains, 47 subdomains, 3 netblocks identified

工作流选择逻辑

根据输入自动选择工作流：

• 输入匹配 IP 模式（x.x.x.x）→ IpRecon.md
• 输入匹配域名模式 → DomainRecon.md
• 输入匹配 CIDR 模式（x.x.x.x/y）→ NetblockRecon.md
• 输入匹配 ASN 模式（AS####）→ ASN 调查（使用 WHOIS/IPInfo/BGP 数据内联执行）
• 用户指定“仅被动侦察” → PassiveRecon.md

用户可以覆盖：

"Use passive-recon workflow on 1.2.3.4"
"Run domain-recon on example.com with active scanning"

成功标准

被动侦察成功：

• 已获取 WHOIS 数据
• 已枚举 DNS 记录
• 已搜索证书透明度数据
• 已收集 IPInfo 数据
• 已生成结构化报告

主动侦察成功：

• 已确认并记录授权
• 已先完成被动侦察
• 已获取端口扫描结果（开放/关闭/过滤）
• 已执行服务检测
• 已收集横幅信息
• 已识别技术
• 无错误或失败
• 扫描时间安排合理（无 DoS）

相关文档

安全技能：

• ~/.claude/skills/Investigation/ - 实体与人员侦察（OSINT）
• ~/.claude/skills/Security/WebAssessment/ - Web 应用测试

工具文档：

• IPInfo API：https://ipinfo.io/developers
• 证书透明度：https://crt.sh
• WHOIS 协议：RFC 3912

最佳实践：

• OWASP 测试指南：https://owasp.org/www-project-web-security-testing-guide/
• NIST SP 800-115：信息安全测试技术指南

---

请记住： 从被动侦察开始，主动侦察前确认授权，记录所有事项，并尊重目标系统。