X-ray
扫描一个陌生的软件项目,快速识别项目类型、技术栈、架构、文件结构、复杂度和学习价值。适用于用户希望快速理解、探索、检查或接手一个陌生代码库的场景。
Jason_Grigg
@ppshux
Install
$ openclaw skills install @ppshux/x-rayX-ray
分析当前软件项目,并生成一份简洁、可视化的项目概览。
目标
调用 X-ray 时:
- 扫描项目目录结构。
- 判断项目是什么类型。
- 识别主要技术栈。
- 找出重要目录和关键文件。
- 推断项目的整体架构。
- 评估项目复杂度。
- 判断这个项目适合哪些方向的人学习。
- 推荐理解项目的阅读顺序。
- 最终生成一个独立可打开的 HTML 可视化报告。
安全规则
默认把项目视为只读。
不要:
- 修改项目源代码;
- 安装依赖;
- 执行项目代码;
- 读取或暴露
.env等文件中的敏感信息; - 执行未知脚本。
优先使用静态分析和文件读取来理解项目。
工作流程
当用户调用 X-ray 分析一个陌生项目时:
- 使用
scripts/run_xray.py扫描当前项目。 - 读取扫描生成的
xray-data.json。 - 读取
references/analysis-rules.md,按照其中的规则解释扫描数据。 - 根据
xray-data.json中的文件列表,进一步读取:- README
- 项目配置文件
- 程序入口
- 关键源码文件
- 基于真实扫描数据和实际源码,分析:
- 这个项目是什么
- 项目类型
- 技术栈
- 文件结构
- 整体架构
- 项目复杂度
- 适合哪些方向的人学习
- 推荐阅读顺序
- 最终生成一个 HTML 可视化项目报告。
原则
- 优先依据
xray-data.json和实际源码。 references只提供分析方法,不提供项目事实。- 不确定的信息明确标记为“不确定”。
- 不修改被分析项目的源代码。
- 不安装依赖。
- 不执行未知项目代码。
Top skills in this category
Skill Vetter
@spclaudehomeSecurity-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
Github
@steipeteInteract with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Humanizer
@biostartechnologyRemove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.
Free Ride - Unlimited free AI
@shaivpidadiManages free AI models from OpenRouter for OpenClaw. Automatically ranks models by quality, configures fallbacks for rate-limit handling, and updates opencla...
Elite Longterm Memory
@nextfrontierbuildsUltimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.