Back to Details

sweepi

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Sweepi Skill

Sweepi 技能

The local

AGENTS.md

in this directory is authoritative for lint-fix safety workflow and reporting. If

SKILL.md

and

AGENTS.md

differ, follow

AGENTS.md

.

本目录下的本地

AGENTS.md

是lint修复安全工作流和报告的权威参考。如果

SKILL.md

与

AGENTS.md

内容不一致，请以

AGENTS.md

为准。

When to run

运行时机

Run Sweepi in either case:

The user explicitly asks to run
```
sweepi
```
.
You are about to commit or recommend committing code changes.
You are linting code, or the user asks you to lint code.

满足以下任意一种情况时运行Sweepi：

用户明确要求运行
```
sweepi
```
。
你即将提交或建议提交代码变更。
你正在对代码执行lint，或用户要求你对代码执行lint。

Required workflow

必备工作流

Run Sweepi in this order:
- First try global CLI:
```
sweepi .
```
- If
```
sweepi
```
  is not found, fallback to:
```
npx sweepi .
```
Parse all reported issues.
Follow the hard-gate pre-edit process in local
```
AGENTS.md
```
.

For each rule violation, open the rule docs in:

https://raw.githubusercontent.com/jjenzz/sweepi/main/packages/eslint-plugin-sweepit/docs/rules/<rule-id>.md

Apply fixes that match the documented intent, not only a minimal syntax pass.
Re-run
```
sweepi
```
until issues are resolved (or document blockers if resolution is impossible).

按以下顺序运行Sweepi：
- 首先尝试全局CLI：
```
sweepi .
```
- 如果找不到
```
sweepi
```
  ，回退到：
```
npx sweepi .
```
解析所有上报的问题。
遵循本地
```
AGENTS.md
```
中规定的硬门槛预编辑流程。

针对每一条规则违规，打开以下路径中的规则文档：

https://raw.githubusercontent.com/jjenzz/sweepi/main/packages/eslint-plugin-sweepit/docs/rules/<rule-id>.md

应用符合文档说明意图的修复方案，不要仅做最低限度的语法修正。
重新运行
```
sweepi
```
直到所有问题被解决（如果无法解决，请记录阻塞原因）。

Resolution guidance

修复指导

Preserve the documented architectural constraints (compound parts, event-driven APIs, explicit props, etc.).
Prefer changes that align with the rule's reasoning section.
If a fix has trade-offs, choose the option that best matches the rule docs and explain the choice.
Never trade behavior-preserving architecture for a smaller lint-only diff.
Do not suppress or ignore rules by default.
A rule may be ignored only when a human-in-the-loop (HITL) explicitly authorizes that specific exception.

保留文档中说明的架构约束（复合组件、事件驱动API、显式props等）。
优先选择与规则推理部分对齐的变更方案。
如果修复方案存在权衡，请选择最符合规则文档的选项并说明选择原因。
永远不要为了缩小仅涉及lint的diff而牺牲可保持原有行为的架构。
默认情况下不要禁用或忽略规则。
仅当人工介入（HITL）明确授权该特定例外时，才可忽略某条规则。

Response format

响应格式

After running and fixing, report:

The command you ran.
Which rules were triggered.
Rule analysis and fix mapping required by
```
AGENTS.md
```
.
The final Sweepi result (clean or remaining blockers).

运行并完成修复后，请上报以下内容：

你执行的命令。
触发了哪些规则。
```
AGENTS.md
```
要求的规则分析和修复映射。
Sweepi最终运行结果（无问题或仍存在阻塞项）。