berelevant-ai/slopless

Deterministic textlint rules and CLI for catching prose slop in English Markdown.

그것이 무엇인가

Slopless는 README에서 "슬롭"이라고 부르는 것, 즉 AI 생성 및 인간 산문 모두에서 흔히 볼 수 있는 모호하고, 진부하며, 지나치게 자신감 있는 글쓰기를 위해 영어 Markdown 파일을 스캔하는 명령줄 도구입니다. 이는 텍스트용 인기 린팅 프레임워크인 textlint를 기반으로 구축되었지만 모든 것을 번들로 제공하므로 별도의 textlint 설정이 필요하지 않습니다.

작동 방식

파일이나 폴더에 대해 실행하면 발견된 모든 문제를 나열하는 JSON을 반환합니다. README는 5가지 규칙에 걸쳐 6가지 발견 사항을 트리거하는 샘플 문단을 보여줍니다. 예를 들어 "let me be honest"(판에 박힌 프레임), "in a world where"(금지된 문구), "We do not sell software. We sell outcomes."(부정 재구성), "everyone knows"(보편화 주장), "at the end of the day"(진부한 표현) 등이 있습니다. 따라서 금지된 단어 목록이 아니라 구조와 수사학을 살펴봅니다.

종료 코드

0 — 문제 없음
1 — 문제 발견됨
2 — 무언가 실패함(예: 입력 없음)

파일 경로, glob 또는 stdin 없이 실행되는 npx slopless는 코드 2로 종료됩니다. 이 도구는 영어 전용입니다.

두 가지 검사 계층

결정적 규칙 — 로컬에서 실행되며 항상 켜져 있습니다. 이는 구문 및 구조 검사입니다.
Jev 검사 — 선택 사항이며 JEV_API_KEY 환경 변수에 TypeSafe API 키가 필요합니다. 이는 작성을 TypeSafe에 보내 의미적 판단(예: "빈 결론" 또는 "반복 설명")을 수행합니다. 11개 패밀리에 걸쳐 54개의 Jev 검사가 있습니다. 이는 실험적이며 README에 따르면 품질이 검사마다 다르며 --check 플래그로 명시적으로 선택할 때만 실행됩니다.

내러티브 슬롭 규칙 — 소설 및 회고록을 위한 별도의 규칙 세트(명명된 감정, 빈 비트, 행동 케이던스, 지각 밀도, 내러티브 진부함). 기본적으로 꺼져 있습니다. --narrative로 켭니다.

세 가지 사용 방법

CLI — npx slopless "docs/**/*.md". 출력은 항상 JSON입니다. 직접 파일로 리디렉션할 수 있습니다.
라이브러리 — JavaScript/TypeScript에서 createSlopless 및 createJevClient를 가져오고 lintText() 또는 lintFiles()를 호출합니다. 중단 신호, 동시성 제한, 시간 초과 및 재시도를 지원합니다.
textlint 프리셋 — 이미 textlint를 사용하는 경우 .textlintrc.json에 preset-slopless를 추가하면 다른 규칙과 함께 실행되어 textlint의 출력 포맷터를 지원합니다.

에이전트 통합

npx slopless install-skill codex(또는 claude)를 사용하여 Codex 또는 Claude Code용 "스킬"을 설치할 수 있습니다. 둘 다 동일한 스킬 본문을 설치합니다. 의도된 워크플로: 스킬을 설치하고, 새 에이전트 세션을 시작하고, 에이전트에게 Slopless 스킬을 사용하여 JSON 출력에 발견 사항이 없을 때까지 확인, 다시 쓰기, 다시 실행하도록 지시합니다.

특정 규칙 무시

의도적인 예외를 HTML 주석으로 감쌀 수 있습니다:

<!-- textlint-disable slopless/semantic-thinness -->

Something shifted in the room.

<!-- textlint-enable slopless/semantic-thinness -->

ID로 억제 — npx slopless --list-checks는 각 검사의 reportId를 표시하며, 이를 비활성화 주석에서 사용할 수 있습니다. 결정적 ID는 안정적입니다. Jev 모델 ID에는 패밀리 이름이 포함됩니다.

보안/출처

0.2.13 이후의 모든 릴리스는 OIDC를 통해 GitHub Actions에서 게시되며 Sigstore 투명성 로그에 기록된 SLSA v1 출처 증명을 보유합니다. npm audit signatures slopless로 확인할 수 있습니다.

크레딧

flat-action-cadence 규칙은 영어 단어 분류에 Compromise 라이브러리를 사용합니다. 물리적 동작 및 행위자 어휘는 Open English WordNet 2025(CC BY 4.0)에서 가져왔습니다. README는 또한 Graham Rowe에게 감사를 표하며 그의 antislop 라이브러리가 "완전히 통합"되었다고 언급합니다.

결론

Slopless는 영어 Markdown용 작성 품질 린터로, AI 모델과 서두르는 인간이 생성하는 자신감 있어 보이지만 내용이 없는 산문을 잡아내는 것을 목표로 합니다. 기본적으로 결정적이며 선택적으로 AI 기반 의미 검사로 강화되며, 인간과 검사가 통과할 때까지 반복할 수 있는 작성 에이전트 모두가 사용할 수 있도록 설계되었습니다.

berelevant-ai/slopless

관련