anti-pattern-czar

TotalClaw 作者 totalclaw

通过状态持久性和批准工作流程检测并修复 TypeScript 错误处理反模式。在扫描代码库以查找无提示错误失败、空捕获、承诺吞噬或未记录错误时使用。支持五种模式 - 扫描（检测所有问题）、审查（交互式修复会话）、自动（带护栏的批量修复）、恢复（从上一个会话继续）、报告（显示进度）。在“扫描反模式”、“修复错误处理”、“查找空捕获”、“反模式沙皇”或“检查错误处理”等短语上触发。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~glucksberg-anti-pattern-czar

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~glucksberg-anti-pattern-czar/file -o glucksberg-anti-pattern-czar.md

## 概述（中文）

通过状态持久性和批准工作流程检测并修复 TypeScript 错误处理反模式。在扫描代码库以查找无提示错误失败、空捕获、承诺吞噬或未记录错误时使用。支持五种模式 - 扫描（检测所有问题）、审查（交互式修复会话）、自动（带护栏的批量修复）、恢复（从上一个会话继续）、报告（显示进度）。在“扫描反模式”、“修复错误处理”、“查找空捕获”、“反模式沙皇”或“检查错误处理”等短语上触发。

## 原文

# Anti-Pattern Czar

Autonomous agent that systematically identifies and fixes TypeScript error handling anti-patterns.

## Detector

Run with Bun (no install required):

```bash
bunx antipattern-czar
bunx antipattern-czar --src lib
bunx antipattern-czar --config my-config.json
```

Config via `.antipatternrc.json`:
```json
{
  "srcDir": "src",
  "criticalPaths": ["DatabaseService.ts", "AuthHandler.ts"],
  "skipDirectories": ["node_modules", "dist", ".git"]
}
```

## Mode Selection

Parse user intent to pick mode:

| User Says | Mode | Action |
|-----------|------|--------|
| "scan", "detect", "find" | SCAN | Run detector, save state |
| "review", "fix", "help me fix" | REVIEW | Interactive fix session |
| "auto", "fix all", "autonomous" | AUTO | Batch fix with guardrails |
| "resume", "continue" | RESUME | Load state, continue |
| "report", "status", "progress" | REPORT | Show current state |

## State File

Always check `.anti-pattern-state.json` at the project root. On first SCAN, ask if resuming when it exists.

```json
{
  "session_id": "<uuid>",
  "started_at": "<ISO>",
  "target_path": "<path>",
  "issues": [],
  "history": []
}
```

Issue schema: `id`, `file`, `line`, `pattern`, `severity` (critical/high/medium), `is_critical_path`, `status` (pending/fixed/approved_override/skipped), `code_snippet`.

## Workflow by Mode

See [workflows.md](references/workflows.md) for full per-mode workflows. Summary:

- **SCAN**: Run detector → parse issues → classify severity → save state → show summary
- **REVIEW**: Load state → sort by critical-path + severity → read code context → explain issue → propose fix options → apply approved fix → update state
- **AUTO**: Confirm with user → auto-fix non-critical-path issues using templates → switch to REVIEW for critical-path hits → show summary
- **RESUME**: Load `.anti-pattern-state.json` → continue from first `pending` issue
- **REPORT**: Display session stats, severity table, recent fixes, next actions

## Approved Overrides

Only suggest `APPROVED_OVERRIDE` when ALL are true:
1. Error is **expected and frequent**
2. Logging would create **excessive noise**
3. There is **explicit recovery/fallback logic**
4. Reason is **specific and technical**

**NEVER** approve overrides on critical paths without exceptional user confirmation.

Format:
```typescript
} catch {
  // [APPROVED_OVERRIDE] <specific technical reason>
  // Fallback: <what happens instead>
}
```

## Fix Templates

See [patterns.md](references/patterns.md) for the full pattern list with severity, auto-fix eligibility, and code templates.

## Progress Output Format

After each fix:
```
✅ Fixed: src/services/example.ts:42
   Pattern: NO_LOGGING_IN_CATCH
   Solution: Added logger.error() with context

Progress: 4/28 issues remaining ━━━━━━━ 14%
```