メニュー
[UDS] 掃描程式庫的除錯殘留與程式碼品質問題；可自動修正安全模式。 Use when: before committing, during PR review, or periodic codebase cleanup. Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 掃描, 清理.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/AsiaOstrich/universal-dev-standards --skill sweepコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
SOC 職業分類に基づく
| name | sweep |
| source | ../../../../skills/sweep/SKILL.md |
| source_version | 1.0.0 |
| translation_version | 1.0.0 |
| last_synced | "2026-05-28T00:00:00.000Z" |
| scope | universal |
| description | [UDS] 掃描程式庫的除錯殘留與程式碼品質問題；可自動修正安全模式。 Use when: before committing, during PR review, or periodic codebase cleanup. Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 掃描, 清理. |
| allowed-tools | Read, Grep, Glob, Bash(find:*), Edit, Write |
| argument-hint |
| [--fix] [--report] [--path <dir>] [--exclude <pattern>] |
語言: English | 繁體中文
掃描程式庫的除錯殘留、程式碼品質問題與技術債標記。 可選擇性自動修正安全模式（console.log、debugger 等語句）。
| Pattern ID | 名稱 | 可自動修正 | 說明 |
|---|---|---|---|
console-log | console.log / console.debug / console.trace | ✅ 是 | 留在正式環境的除錯輸出 |
debugger | debugger 語句 | ✅ 是 | 留在程式碼中的中斷點 |
todo-fixme | TODO / FIXME / HACK / XXX | ❌ 僅回報 | 技術債標記 |
ts-any | TypeScript any 型別 | ❌ 僅回報 | 型別安全違規 |
/sweep # 掃描目前目錄，回報發現
/sweep --fix # 掃描並自動修正可修復項目
/sweep --report # 掃描並將報告寫入 .uds/sweep-report.json
/sweep --path src/ # 掃描指定目錄
/sweep --exclude "**/*.test.ts" # 排除模式（glob）
使用 Glob tool 找出目標路徑下所有原始碼檔案。
預設排除：node_modules/、dist/、.git/、*.min.js、coverage/。
對每個 pattern 使用 Grep 在所有檔案中尋找比對結果。
彙整發現：{ file, line, column, pattern_id, label, fixable, content }。
輸出結構化摘要：
📊 掃描結果
─────────────────────────────────────
console-log: 12 筆 （可自動修正）
debugger: 2 筆 （可自動修正）
todo-fixme: 28 筆 （僅回報）
ts-any: 5 筆 （僅回報）
─────────────────────────────────────
合計：47 筆 | 可修正：14 筆
若設定 --fix 且可修正發現總數超過 20：
暫停並要求使用者明確確認才套用修正。
顯示將被修改的檔案清單。
對每筆可修正發現：
console-log：若該行僅含 console 語句則刪除該行debugger：若該行僅含 debugger 語句則刪除該行使用 Edit tool 逐檔套用變更。 回報：「已修正 N 筆，影響 M 個檔案。」
將發現寫入 .uds/sweep-report.json：
{
"timestamp": "<ISO8601>",
"total_findings": 47,
"fixable": 14,
"fixed": 14,
"findings_by_pattern": { "console-log": 12, "debugger": 2, "todo-fixme": 28, "ts-any": 5 },
"files_modified": ["src/auth.ts", "src/utils.ts"]
}
透過 uds.project.yaml 設定：
sweep:
default_path: "src/"
exclude_patterns:
- "**/*.test.ts"
- "**/*.spec.ts"
- "**/fixtures/**"
hitl_threshold: 20 # 可修正項目超過此值時需確認
patterns:
enabled:
- console-log
- debugger
- todo-fixme
- ts-any
/sweep 完成後建議：
- 執行
/checkin在提交前驗證整體程式碼品質- 執行
/code-review審查清理後的變更- 執行
/commit提交修正
| 版本 | 日期 | 變更 |
|---|---|---|
| 1.0.0 | 2026-04-28 | 初始版本 — XSPEC-097 Phase 1（從上游遷移） |
本 Skill 採用 MIT License 與 CC BY 4.0 雙重授權發布。