Claude Skill Code Cleanup — Communication skill for Claude Code

Code Cleanup + Benchmark-Driven R&D

兩個可安裝到 Codex 或 Claude Code 的工程 Skills：

• code-cleanup-helper：read-only repository／Skill／release evaluator。
• run-benchmark-driven-rd：定義可證偽目標、保存 baseline、執行實驗、控制 promotion 與外部變更。

目前版本：**v0.21.0**。

`main` 另含 2026-09-04 尚未標記版本的安全強化：Cleanup 新增可驗證、fail-closed 的 security-assessment receipt；R&D 新增六項安全控制的 routing／completion obligations，並把 public／parity 完工證據綁到同一專案的 delivery、build 與 release artifact。這仍是由使用者授權觸發的開發／稽核流程，不會在安裝後自行常駐掃描或改寫專案。詳見 [Changelog](CHANGELOG.md)。

v0.21.0 重點

• Cleanup 每次 audit 都輸出下游目標的 D11 更新覆蓋：managed、check-only、safe-auto-update、manual-only 或 no-origin。檔案或 GitHub URL 存在不等於更新安全通過。
• R&D 對已授權、可分發的 Skill／軟體／遊戲／安裝器／release 開發，在 implementation／promotion／completion 階段預設納入安全更新能力與發布通道義務。
• 更新設計涵蓋來源驗證、staging、健康檢查、切換、回滾與安全淘汰 inactive 舊版；由套件／商店／部署平台管理的目標沿用原生更新機制。
• Task-aware Router v2、精簡 topic cards、精確 context budget 與 typed learning records，讓常用流程只載入必要規則，保留可重播證據。
• 完工 gate 不允許漏掉必要 capability，並保留 Cleanup 的 REVIEW／NOT_CHECKED，不把 route 選擇冒充功能驗證。

這兩個 Skill 是**開發與稽核流程**，不是背景 updater。安裝後不會自行掃描所有專案、執行排程或改寫程式；它們參與下游專案開發時，才會檢查與規劃該專案的更新功能，並在原始授權內實作。Audit-only／source-only 不因此取得修改、發布、簽章、背景常駐或刪除權限。

安裝

git clone https://github.com/Hao0321/claude-skill-code-cleanup.git
cd claude-skill-code-cleanup
python -m pip install -r requirements.txt

需要 Python **3.10+**。基本 Cleanup audit 使用標準函式庫；完整 self-test、learning gate 和精確 Token／topic-index 檢查需要 `requirements.txt` 中的 `tiktoken`。第一次使用 `o200k_base` 可能需要下載 tokenizer 資料；離線且沒有 cache 時會明確阻擋相關量測。

Codex 首次安裝（Windows PowerShell，在 clone 目錄內執行）：

$skillRoot = Join-Path $env:USERPROFILE '.codex\skills'
foreach ($name in @('code-cleanup-helper', 'run-benchmark-driven-rd')) {
    if (Test-Path -LiteralPath (Join-Path $skillRoot $name)) {
        throw "$name 已存在；請先依下方升級流程比對，不要直接覆蓋。"
    }
}
New-Item -ItemType Directory -Force -Path $skillRoot | Out-Null
Copy-Item -Recurse -LiteralPath '.\code-cleanup-helper' -Destination $skillRoot
Copy-Item -Re