適用於 Openclaw 的 Code Inspector

一款基於 AST 靜態分析的命令列工具，用於檢測 AI 生成的 Python 程式碼中的錯誤、安全漏洞並評估其生產就緒程度。

minirr890112-byte

v1.0.0

Jun 18, 2026

安裝

基本資訊

Skill.md

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。


                  npx clawhub@latest install code-inspector

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式

~/.openclaw/skills/

工作區

<project>/skills/

優先級：工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。


                  請幫我使用 Clawhub 安裝 code-inspector。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。

想要直接下載？

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 Code Inspector？

AI 程式碼生成器可能會輸出語法看起來正確，但隱藏了關鍵安全漏洞、邏輯錯誤或嚴重反模式的程式碼。code-inspector 工具透過根據八個關鍵靜態分析檢查點（從硬編碼憑據到可變預設值）掃描您的 Python 檔案來解決此問題。透過引入結構化的安全網，開發人員可以放心地利用 LLM 代理。

作為 Openclaw Skills 生態系統的一部分，該工具可以無縫整合到開發人員的工作流程中，以直接從終端檢查管道輸入或檔案。它會評估每個腳本並輸出 0 到 100 的生產就緒分數，確保高風險程式碼永遠不會進入生產環境。

Code Inspector 應用場景

對 AI 編碼助手或 LLM 工作流程生成的 Python 程式碼進行部署前掃描。
自動化的 CI/CD 管道檢查，以便在生產前捕獲關鍵安全漏洞。
直接從 LLM 輸出封裝器串流傳輸程式碼的互動式終端審查。

Code Inspector 運作原理

使用者安裝該工具並將其指向 Python 檔案或透過 stdin 串流傳輸程式碼。
引擎解析程式碼庫並跨 8 個不同的規則類別執行基於 AST 的靜態分析檢查。
根據規則嚴重性（發現嚴重、高、中、低漏洞）扣分。
腳本計算出 0 到 100 的最終生產就緒分數。
它會輸出一份顏色編碼的狀態報告，突出顯示特定的問題行和警告。

Code Inspector 設定指南

# 直接從 GitHub 儲存庫安裝
pip install git+https://github.com/minirr890112-byte/code-inspector.git

# 掃描單一 Python 檔案
code-inspector app.py

# 透過 stdin 從其他行程直接串流傳輸程式碼
cat app.py | code-inspector

Code Inspector 資料結構與分類體系

該工具在記憶體中處理 Python 抽象語法樹 (AST) 以執行檢查。評分嚴重性對映和生產就緒分類結構如下：

檢查類別	嚴重性	範例 / 目標行為
硬編碼密鑰	關鍵	查找分配給 'api_key' 等關鍵變數的純文字字串。
不安全的 eval/exec	關鍵	識別不安全地使用動態執行方法的情況。
無限迴圈	關鍵	標記在 while 迴圈內修改迭代器的行為。
空的 except/pass	關鍵	檢查靜默吞沒異常的行為 ('except: pass')。
可變預設值	高	標記函式中用作預設參數值的列表、字典或集合。
遮蔽內建函式	高	捕捉內建術語的重定義，例如 'list = [1,2,3]'。
深層巢狀	中	精確定位具有五級或更高級別巢狀迴圈的程式碼區塊。
未使用的導入	低	標記從未被引用的導入模組。