deslop
Diff-scoped AI-writing cleanup pass before review. Strips narration comments, imagined-state defensive checks, type-laundering casts, and style drift from the current branch diff. Behavior-neutral by contract; feeds, never replaces, independent review.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-15
- Stars
- ★ 2
- Forks
- 1
01 前言 Front Matter
- name
- deslop
- description
- Diff-scoped AI-writing cleanup pass before review. Strips narration comments, imagined-state defensive checks, type-laundering casts, and style drift from the current branch diff. Behavior-neutral by contract; feeds, never replaces, independent review.
03 SKILL.md 正文
Deslop
Clean the current branch diff before review. Preserve behavior absolutely.
Scope
- Run against
git difffrom the merge base withorigin/main, or the branch's merge base when it differs. Never run a repo-wide pass; repo-wide cleanup belongs to its own reviewed pull request. - Stabilize work in progress first (commit or stage). The pass edits only intent the diff can see.
Checklist
Inspect every changed hunk for:
- comments a maintainer would not write: narration, syntax restatement, prose that repeats the code, or a claim about behavior the code does not have;
- defensive checks or try/catch blocks that are abnormal for the surrounding module or protect only imagined states;
- type laundering:
as any,as unknown as T, and widen-then-assert flows.scripts/type-laundering-gate.mjsblocks new textualas anyandas unknown as Tcasts in production surfaces; this pass catches the rest, including tests and widen-then-assert flows; - redundant intermediate variables or one-use helpers that add no domain meaning;
- compatibility shims, aliases, retries, or fallback branches without a named shipped contract and removal plan;
- naming, control flow, imports, or formatting that conflicts with the surrounding file.
Rules
- Make no functional edits. If a cleanup could change behavior, leave it alone and report it.
- Fix a finding inline only when it is trivially behavior-neutral. Note the rest for the author or review.
- Report in 1-3 sentences: whether anything changed, and any non-trivial item left for review.
Run deslop before review, never instead of it. Nontrivial changes still need independent review under the layered-independence protocol (docs/strategy/multi-agent-delivery-protocol.md). The standing repo conventions this pass enforces on a diff are owned by Code-health prevention.
04 同仓库更多 Skills
migrate-agent-plugin
Migrate an existing Claude, Copilot, Codex, Cursor, Kiro, VS Code, or other client-specific agent plugin to the portable Agent Plugins v1 structure while preserving platform-specific hooks, agents, commands, LSP, UI, and marketplace behavior. Use when auditing, converting, or modernizing an agent plugin.
stress-test-idea
Ask adaptive questions to clarify an idea, its constraints, and its unresolved decisions.
inspect-onboarding
Inspect a project onboarding document and report actionable gaps without changing files.
stress-test-idea
Ask adaptive questions to clarify an idea, its constraints, and its unresolved decisions.
draft-brief
Turn supplied notes into a concise brief with explicit facts, assumptions, and open questions.
wayfinder
Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.