← 返回 Skills 市场
114
总下载
1
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install perf-prof
功能描述
Linux system performance analysis using perf-prof for real-time event processing and profiling CPU, memory, IO, scheduling, virtualization, and custom scripts.
安全使用建议
This skill is a documentation-driven workflow for a low-level Linux profiler and is internally coherent with that purpose. Before using it, verify the upstream source (the SKILL.md references https://github.com/OpenCloudOS/perf-prof.git) and inspect the repository you will clone. Understand that most useful profiling commands require root: the skill instructs writing to /sys/kernel/debug/tracing, adding kprobes/uprobes, reading other processes' maps, and (in some workflows) reading kernel memory (/proc/kcore). These are powerful operations that can affect system behavior and expose sensitive memory. Also note the documented expression builtin system(...) can execute arbitrary shell commands if expressions are accepted from untrusted inputs — avoid feeding untrusted expressions or run profiling in an isolated/test environment. If you plan to proceed on production hosts: (1) review the GitHub source code and commits, (2) build from a verified release or checksum, (3) run initially on a non-production machine or in a VM/container, and (4) explicitly confirm any root actions with an administrator before executing them.
功能分析
Type: OpenClaw Skill
Name: perf-prof
Version: 1.0.0
The skill bundle provides a comprehensive Linux performance analysis suite (perf-prof) that includes several high-risk capabilities. Most notably, the expression engine documented in 'references/expr.md' includes a 'system()' function for executing shell commands, and 'references/profilers/python.md' describes a profiler that executes arbitrary Python scripts for event processing. While the instructions in 'SKILL.md' are strictly focused on legitimate system diagnostics (CPU, IO, and memory analysis) and no explicit malicious payloads or exfiltration commands were found, the inclusion of a shell-execution helper within a performance tool's expression evaluator represents a significant security risk and a potential vector for exploitation.
能力评估
Purpose & Capability
The name/description (perf-prof Linux performance analysis) matches the SKILL.md and the many profiler reference documents. There are no unrelated environment variables or surprising external services requested. One small metadata inconsistency: registry metadata lists Source: unknown / Homepage: none, while SKILL.md points to a GitHub repo (https://github.com/OpenCloudOS/perf-prof.git). The GitHub URL in the instructions aligns with the stated purpose, but the registry record not listing the source is a minor discrepancy to verify.
Instruction Scope
The instructions correctly cover installing (git clone, build) and running perf-prof and reference many operations expected for a low-level profiler: reading /proc, writing to /sys/kernel/debug/tracing (kprobe/uprobe events), adding probes, using perf-prof to sample events, and reading symbol maps. These actions inherently require elevated privileges and can modify kernel tracing state. The expression language documented (expr.md) exposes a built-in system(...) function which permits executing formatted shell commands from expressions — this is a powerful capability and, if combined with untrusted inputs, can execute arbitrary commands. All of these behaviours are consistent with the tool's purpose but are high-impact and must be run with caution and user consent.
Install Mechanism
This is an instruction-only skill (no automated install spec). The SKILL.md suggests cloning and building from a GitHub repo (https://github.com/OpenCloudOS/perf-prof.git) and installing system packages via yum. That is proportionate to compiling a system profiler, but the skill will instruct the user to fetch and run code from a remote repository and install OS packages—verify the repository and its integrity before building. There is no package checksum or release host verification provided.
Credentials
The skill requests no environment variables, which is expected. However, the runtime instructions routinely require root privileges (installing packages, writing to /sys/kernel/debug/tracing, reading /proc/kcore, adding kprobes/uprobes, and reading other processes' maps). Those privileges are appropriate for a system profiler but are sensitive. Additionally, the documented expression builtin system(...) allows executing shell commands from inside perf-prof expressions — this can run arbitrary commands if expressions come from untrusted sources. Treat these privilege needs as intentional but high-risk and verify you trust both the user inputs and the perf-prof binary/source before granting them.
Persistence & Privilege
The skill is not always-enabled, has no install-time persistence spec, and is instruction-only. It does not request system configuration changes beyond the actions the user would perform at runtime. The skill can be invoked autonomously by the agent by default (disable-model-invocation is false) which is platform normal; combine that with the high‑privilege operations above only if you trust the skill and the agent's autonomy.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install perf-prof - 安装完成后，直接呼叫该 Skill 的名称或使用
/perf-prof触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of perf-prof skill
- Provides a comprehensive workflow to use perf-prof for Linux system performance diagnosis.
- Details installation, including dependency handling and user confirmation for source builds.
- Includes a full decision tree for selecting the right profiler based on system symptoms (CPU, memory, IO, virtualization, etc.).
- Categorizes and explains available profilers; links to documentation when available, and outlines core analysis techniques.
- Adds step-by-step instructions for both kernel-space and user-space diagnostics.
- Features both Chinese and English descriptions for broader accessibility.
元数据
常见问题
Perf Profiler 是什么？
Linux system performance analysis using perf-prof for real-time event processing and profiling CPU, memory, IO, scheduling, virtualization, and custom scripts. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 114 次。
如何安装 Perf Profiler？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install perf-prof」即可一键安装，无需额外配置。
Perf Profiler 是免费的吗？
是的，Perf Profiler 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Perf Profiler 支持哪些平台？
Perf Profiler 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Perf Profiler？
由 duanery（@duanery）开发并维护，当前版本 v1.0.0。
推荐 Skills