开发与测试
Claude Skill Code Cleanup
A read-only audit skill for Claude Code/Codex that scans SKILL.md, prompts, and codebases for duplicates, drift, oversized files, and modularization opportunities.
Hao0321 · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Hao0321/claude-skill-code-cleanup技能说明
code-cleanup-helper
一個可安裝到 Codex 或 Claude Code 的 read-only code/skill/repository audit skill。
目前版本:v0.5.0。它把兩種互補能力放在同一套工作流:
- deterministic audit:重複段落、永久 ID、長檔、private/public sync、release、broken links、版本/事實漂移、skill metadata 與 privacy token。
- semantic scan:規則內容漂移、SoT 孤島、gate 自我認證與「文件裁決沒有機械落地」。
v0.5.0 新增什麼
scripts/audit.py與可重用的audit_core.py。- PASS/FAIL/NOT_CHECKED 三態,不再把「沒辦法查」算成通過。
- Human/JSON report、
--strictCI mode、跨平台 UTF-8。 audit.config.json的 exclude、threshold、sync、drift assertion、privacy allowlist。- 從 repo root 遞迴檢查 nested skills、各自的
agents/openai.yaml與 reference 導航。 - Privacy literal token 與 regex pattern 分流;錯誤 regex 變成可讀 FAIL,不會炸掉 audit。
- link、drift、sync 專用 CLI 與 dependency-free self-test。
- 保留 v0.4.1 的
cleanup_scan.py,不讓新 deterministic engine 取代既有語意掃描能力。
安裝
git clone https://github.com/Hao0321/claude-skill-code-cleanup.git
Codex(Windows PowerShell):
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills" | Out-Null
Copy-Item -Recurse ".\claude-skill-code-cleanup\code-cleanup-helper" "$env:USERPROFILE\.codex\skills\code-cleanup-helper"
Claude Code:把 .codex\skills 改成 .claude\skills。macOS/Linux 可複製到 ~/.codex/skills/ 或 ~/.claude/skills/。
快速開始
cd code-cleanup-helper
$env:PYTHONUTF8='1'
# deterministic A+B audit
python scripts/audit.py C:\path\to\repo --mode all
# machine-readable report
python scripts/audit.py C:\path\to\repo --mode all --format json
# semantic deep scan
python cleanup_scan.py C:\path\to\repo
CI 要在有 FAIL 時回傳非零 exit code,才加 --strict:
python scripts/audit.py C:\path\to\repo --mode all --strict
兩個引擎怎麼選
| 問題 | 工具 |
|---|---|
| Broken link、版本宣告、ID range、sync、隱私 token | scripts/audit.py |
| Exact paragraph duplication、長檔、skill metadata | scripts/audit.py |
| 同一規則 ID 在不同文件講不同話 | cleanup_scan.py |
| 姊妹模組互不引用、gate 只有自建 fixture | cleanup_scan.py |
| Release 前完整健檢 | 兩個都跑 |
設定
把 [`audit.config.examp