Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

sweep

/sweep

Wyszukuje w kodzie ślady debugowania i problemy jakości, np. console.log, debugger lub TODO, i może poprawić bezpieczne wzorce.

Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wyszukuje w kodzie ślady debugowania i problemy jakości, np. console.log, debugger lub TODO, i może poprawić bezpieczne wzorce.

Argumenty

/sweep [--fix] [--report] [--path <dir>] [--exclude <pattern>]
Oryginalny opis (EN)

扫描代码库中的调试残留与代码质量问题;可选择自动修正安全的模式。 Use when: 提交前、PR 审查期间,或定期清理代码库。 Not for: 结构性的代码改善——请用 /refactor;针对安全的专门扫描——请用 /scan。 Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 扫描, 清理, 调试残留.

Jak działa

  1. 扫描模式
  2. 使用方式
  3. 执行工作流程
  4. 设置
  5. 下一步引导
  6. 相关标准
  7. 版本历程
  8. 授权
Sekcje z nagłówków SKILL.md, w oryginale · 136 linii, 338 słów
Podgląd SKILL.md
---
name: sweep
source: ../../../../skills/sweep/SKILL.md
source_version: 1.0.0
translation_version: 1.1.0
last_synced: 2026-08-17
source_hash: 85af5ee0d1f4
status: current
scope: universal
description: |
  扫描代码库中的调试残留与代码质量问题;可选择自动修正安全的模式。
  Use when: 提交前、PR 审查期间,或定期清理代码库。
  Not for: 结构性的代码改善——请用 /refactor;针对安全的专门扫描——请用 /scan。
  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](../../../../skills/sweep/SKILL.md) | 简体中文

扫描代码库的调试残留、代码质量问题与技术债标记。
可选择性自动修正安全模式(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` 类型 | ❌ 仅报告 | 类型安全违规 |

---

## 使用方式

```bash
/sweep                        # 扫描当前目录,报告发现
/sweep --fix                  # 扫描并自动修正可修复项
/sweep --report               # 扫描并将报告写入 .uds/sweep-report.json
/sweep --path src/            # 扫描指定目录
/sweep --exclude "**/*.test.ts"  # 排除模式(glob)
```

---

## 执行工作流程

### Step 1:搜索文件
使用 Glob tool 找出目标路径下所有源代码文件。
默认排除:`node_modules/`、`dist/`、`.git/`、`*.min.js`、`coverage/`。

### Step 2:逐 Pattern 扫描
对每个 pattern 使用 Grep 在所有文件中查找匹配结果。
汇总发现:`{ file, line, column, pattern_id, label, fixable, content }`。

### Step 3:报告发现
输出结构化摘要:
```
📊 扫描结果
─────────────────────────────────────
console-log:   12 条  (可自动修正)
debugger:       2 条  (可自动修正)
todo-fixme:    28 条  (仅报告)
ts-any:         5 条  (仅报告)
─────────────────────────────────────
合计:47 条  |  可修正:14 条
```

### Step 4:HITL 闸门(--fix 且发现数 > 20)
若设置 `--fix` **且**可修正发现总数超过 20:
**暂停并要求用户明确确认**后才应用修正。
显示将被修改的文件清单。

### Step 5:应用修正(确认 --fix 后)
对每条可修正发现:
- `console-log`:若该行仅含 console 语句则删除该行
- `debugger`:若该行仅含 debugger 语句则删除该行

使用 Edit tool 逐文件应用变更。
报告:「已修正 N 条,影响 M 个文件。」

### Step 6:保存报告(--report)
将发现写入 `.uds/sweep-report.json`:
```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` 设置:

```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` 提交修正

---

## 相关标准

- [Checkin Standards](../../../../.standards/checkin-standards.ai.yaml) — Pre-commit 质量闸门
- [Code Review](../code-review-assistant/SKILL.md) — 代码审查助手
- [Testing Guide](../testing-guide/SKILL.md) — 测试标准

---

## 版本历程

| 版本 | 日期 | 变更 |
|------|------|------|
| 1.0.0 | 2026-04-28 | 初始版本 — XSPEC-097 Phase 1(从上游迁移) |

---

## 授权

本 Skill 采用 [MIT License](https://opensource.org/licenses/MIT) 与 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 双重授权发布。

Wersje

RepozytoriumWynikLicencja
Ta strona · AsiaOstrich/universal-dev-standards100MIT
tony/skills100MIT
AsiaOstrich/universal-dev-standards100MIT
AsiaOstrich/universal-dev-standards100MIT
andryorelabs/jobship100MIT
chrs-myrs/livespec100MIT
jisuzzzz/haechi100MIT
JunLin615/os-optics-kit100MIT
AsiaOstrich/universal-dev-standards100MIT

Migawka bazy z 13.11.2026 · wersja paczki 92e1d6a0bda9 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100debugger
    Diagnozuje i rozwiązuje problemy w kodzie jako specjalista od debugowania, gdy użytkownik napotyka błędy, nieoczekiwane zachowanie lub prosi o debugowanie.
  • 100todo-sweep
    Przegląda komentarze TODO i FIXME w kodzie w lokalnym panelu i zapisuje raport bez zmiany plików źródłowych.
  • 100frappe-agent-debugger
    Pomaga debugować błędy Frappe: bench console, analiza tracebacków, logi, DocType Error Log, pdb, VS Code DAP, profilowanie i Frappe Recorder.
  • 84scan-todos
    Przeszukuje komentarze w kodzie źródłowym pod kątem znaczników TODO, FIXME, HACK i XXX i dla każdego rozwiązuje problem lub zakłada zgłoszenie.
  • 100bun-debug
    Uruchamia debugger Bun przez --inspect do interaktywnego debugowania pliku TS lub JS: zatrzymanie na pierwszej linii, oczekiwanie na podłączenie i debugowanie testów przez --inspect-brk.
  • 100argent-metro-debugger
    Debuguje środowisko uruchomieniowe JS przez CDP za pomocą narzędzi debuggera argent: React Native przez Metro (iOS, Android, Vega) oraz renderer aplikacji Chromium; łączy się, sprawdza komponenty React i czyta logi konsoli.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.