一個基於 Python 的 CLI 驗證器，用於檢查 devcontainer.json 檔案的結構錯誤、安全風險和配置最佳實踐。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install devcontainer-validator
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 devcontainer-validator。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 DevContainer Validator？
DevContainer Validator 是一款強大的技術工具，旨在簡化開發環境的建立與維護。它專門針對 VS Code Dev Containers、GitHub Codespaces 和 DevPod 配置，透過解析 JSONC 檔案來識別常見問題。作為 Openclaw Skills 生態系統中的重要組成部分，它透過在多個配置領域實施 24+ 條驗證規則，幫助開發人員維護高品質的基礎設施即代碼 (infrastructure-as-code)。
透過提供從 OCI feature 格式到危險特權模式設置的細粒度回饋，該工具確保了開發容器既功能完備又安全。其零依賴的 Python 架構使其在任何本地或雲端環境中都具有極佳的便攜性。
DevContainer Validator 應用場景
- 驗證新專案的 devcontainer.json 語法和結構完整性。
- 審計安全設置，防止容器逃逸或 shell 注入風險。
- 在 CI/CD 流水線中自動化配置檢查，防止損壞的 Codespaces。
- 調試複雜容器設置中的連接埠轉發和網路不一致問題。
- 確保符合非 root 用戶執行等容器最佳實踐。
DevContainer Validator 運作原理
- 驗證器載入 devcontainer.json 檔案，支援 JSONC 以處理註釋和尾隨逗號。
- 它執行一套全面的檢查，分為結構、features、網路、生命週期指令碼、自定義項和安全六大類。
- 該工具分析源類型之間的潛在衝突，例如同時聲明 image 和 dockerFile。
- 它評估 OCI feature 引用和生命週期命令模式的語法及安全問題。
- 它根據選擇的輸出格式生成報告，按嚴重程度（Error, Warning, Info）識別問題。
- 該工具返回特定的結束代碼以發出成功或失敗信號，從而在開發工作流中實現自動化准入控制。
DevContainer Validator 設定指南
要開始在 Openclaw Skills 中使用此工具，請確保已安裝 Python 3.8+。該指令碼使用 Python 標準庫，因此不需要額外的 pip 安裝。
# 對本地檔案進行基礎驗證
python3 scripts/devcontainer_validator.py validate .devcontainer/devcontainer.json
# 在嚴格模式下執行專注於安全的審計
python3 scripts/devcontainer_validator.py security --strict devcontainer.json
DevContainer Validator 資料結構與分類體系
該工具分析標準的 devcontainer.json schema 並輸出結構化數據。以下是驗證類別及其重點領域的映射：
| 驗證領域 | 邏輯範圍 | 檢查示例 |
|---|---|---|
| Structure | 檔案完整性 | 缺失鏡像源，未知頂級 key，JSONC 語法 |
| Features | 擴充邏輯 | 無效的 feature 格式，OCI 引用驗證，重複項 |
| Ports & Net | 連通性 | 連接埠範圍驗證 (0-65535)，forwardPorts 陣列格式 |
| Lifecycle | 鉤子安全 | Shell 注入模式，空命令，指令碼類型檢查 |
| Security | 加固 | remoteUser 存在性，特權模式檢測，capAdd 項目 |
| Customization | 編輯器邏輯 | VS Code 擴充功能 ID 格式，settings 物件結構 |
DevContainer Validator 進階特性
- 支援多種輸出格式，包括原始文字、結構化 JSON 和單行摘要。
- 嚴格模式實現，在高度合規的環境中將 warning 和 info 訊息視為致命錯誤。
- 透過 --min-severity 標記進行嚴重程度過濾，以便在初始開發階段專注於關鍵錯誤。
- 專門的子命令（如 security 或 features），無需執行完整套件即可執行針對性審計。
- 符合 Openclaw Skills 輕量級、便攜和高度可整合 CLI 工具的理念。
SKILL.md
加載中
Openclaw 相關技能
ArgoCD Deployment Analyzer
一個全面的診斷工具，用於識別同步差異、診斷部署故障並為 ArgoCD 管理的應用提供安全審計。
Pre-Commit Config Validator
一個專門用於 .pre-commit-config.yaml 檔案的驗證工具，涵蓋結構、hook 與最佳實務等 23 條不同規則。
Commit Message Linter
一個無依賴的 Python 工具，用於根據 Conventional Commits 規範和自定義專案規則驗證 git 提交訊息。
精選*
