theclaymethod/unslop

unslop

Remove AI writing patterns from prose using either audit-only detection or a two-pass rewrite flow (diagnosis then reconstruction).

ソースを見る
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

Unslop

Humanize AI-generated prose. Audit first. Rewrite only when the user asks for a rewrite.

For every audit or rewrite, read references/core-contract.md. It is the single behavior contract. Command files define routing and mechanics; presets supply optional voice, but neither can override the core contract.

Routing

When the user invokes a sub-command (`/unslop teach ...`, `/unslop cleanup ...`), you MUST read `references/commands/<command>.md` before acting. Non-optional — the command file defines the flow, and skipping it drops steps the user expects. A bare /unslop <text> with no leading command word defaults to rewrite. If the first word does not match a command but the intent clearly maps to one (e.g. "flag the AI tells, don't change anything" → cleanup report-only), load that command file and proceed as if invoked.

CommandPurposeFile
rewriteDefault two-pass de-slop: diagnose, reconstruct under the guards, validate.references/commands/rewrite.md
cleanupCo-writer: cheap detection, reviewable suggestions with contract gates; includes report-only "flag, change nothing".references/commands/cleanup.md
teachAgent-driven voice building: harvest, approve, profile, layered card, scored demo.references/commands/teach.md
mimicVoiced drafting or rewriting under the full gates; refine loop when one pass falls short.references/commands/mimic.md
maintenanceTurn a wild AI-ism into an eval row and a PR (not a top-level verb).references/commands/contribute.md

Routing by phrase

Sub-flows are reachable by their natural names without being top-level verbs. When the user says any of these, load the named file and jump to the flow:

The user saysGo to
audit / "just flag it" / "don't change anything"references/commands/cleanup.md
review / "review this before I publish"references/commands/cleanup.md
harvest / "what writing of mine do you have?"references/commands/teach.md
calibrate / "the A/B game" / "quiz me on my voice"references/commands/teach.md
refine / "keep pushing until it sounds like me"references/commands/mimic.md
voice check / "does this sound like me?"references/commands/mimic.md
"found a new AI-ism" / "add this tell"references/commands/contribute.md

Interface

ArgumentDescriptionDefault
--presetVoice style: crisp, warm, expert, storycrisp
--strictFail if rubric score < 32/40false
--reportFlag AI patterns without changing the text (cleanup)false
InputText to transform (argument, file path, or stdin)required

Read one preset from presets/ before writing.

PresetStyleBest For
crispShort, direct, no fluffTechnical writing, documentation
warmFriendly, conversationalEmails, blog posts
expertAuthoritative, confidentThought leadership, articles
storyNarrative flow, show don't tellCase studies, personal posts

Rewrite, preservation, register, and validation behavior lives only in references/core-contract.md; do not recreate or override those rules here.

Output Format

For a quick rewrite, return the cleaned text only. For audit-only (cleanup --report):

markdown
## Issues Found

- [Quoted issue, category, severity, why it reads as AI]

## Assessment

- [Which issues are clear problems]
- [Which issues are judgment calls or context-dependent]

For strict or requested analysis:

markdown
## Transformed Text

[The humanized version]

## Validation

- Constraints: [X]/[Y] preserved
- AI patterns: [N] remaining (was [M])
- Structure: [pass/fail]
- Readability: Grade [X], sentence variance [Y]
- Change: [X]% from original
- Score: [X]/40

Reference Files

FileWhen to Read
references/commands/*.mdThe routed command flows (rewrite, cleanup, teach, mimic, contribute).
references/pipeline.mdOrchestrated tiered execution for multi-agent harnesses.
references/taboo-phrases.mdAuthoritative phrase catalog and scanner categories.
references/fact-preservation.mdConstraint preservation rules.
references/rewrite-examples.mdExecutable before/after examples.
references/{mimic,harvest,calibrate}.mdVoice-tool internals loaded by their routed command.
references/{rubric,edit-library,maintenance}.mdStrict scoring, examples, and contribution procedures.
presets/*.mdVoice-specific deltas.

Maintenance

The eval contracts define the product. Add scanner examples eval-first in evals/fixtures/contracts/scanner-examples.json; use evals/adversarial-evals.json for agent behavior and routing. Do not edit legacy evals/evals.json. New patterns need a false-negative example and a false-positive protection example. Agent behavior changes need a skill row and a regenerated shared benchmark. For the concrete procedures (add a phrase or structure, list current patterns, sync with Wikipedia's signs-of-AI-writing page), read references/maintenance.md. Found a new AI-ism in the wild? references/commands/contribute.md turns the exact snippet into a contract example and a structured PR, keeping both user-confirmation gates.