slopmop

Slop-mop スキル

Slop-mop の不具合を報告しますか？ /slopmop:sm-barnacle または sm barnacle file を使ってください。gh issue create を直接実行しないでください。barnacle CLI は、どこで操作していても適切なラベルを自動で付け、正しいリポジトリを対象にします。

Slop-mop（sm）には、主に 2 つのモードがあります。refit（初回のオンボーディング）とmaintenance（通常の開発）です。refit では既存の slop をすべて修正し、恒久的なガードを導入します。その後、swab/scour/buff のループによって、作業中もリポジトリをクリーンに保ちます。

使用するタイミング

• 通常の操作：次に何をすればよいか分からない場合は、sm sail を実行してください。ワークフローの状態を読み取り、適切に処理します。
• Refit（ステップ 0）：sm refit --start を実行して修正計画を作成し、完了するまで sm refit --iterate を繰り返した後、sm refit --finish を実行して maintenance に移行します。
• 実装中：意味のあるコード変更を行うたびに sm swab を実行してください。クリーンになるまで続けます。
• PR の前：包括的なチェックとして sm scour を実行してください。
• CI／レビュー後：sm buff <PR_NUMBER> を実行して、フィードバックを次のアクションに変換します。

メンテナンスループ

Fastest path:  sm sail → fix what it finds → sm sail → repeat until PR lands
Manual path:   write code → sm swab → fix → repeat → sm scour → sm buff <PR#>

sm sail は動詞の選択を自動化します。個別の動詞（sm swab -g <gate>、sm buff resolve など）は、対象を絞った作業に使用してください。

Refit（ループに入る前）

Refit はメンテナンスループの一部ではありません。これはステップ 0、つまりループに入る資格を得るための手順です。

sm refit --start → fix one gate → sm refit --iterate → ... → sm refit --finish

前提条件

ユーザーの環境に sm CLI がインストールされている必要があります。実行時に「command not found」と表示された場合は、次の方法を案内してください。

pipx install slopmop[all]

その後、コマンドを再実行してください。

安全性

• 失敗したチェックを回避したり、無効にしたりしないでください。そうすると、リポジトリの劣化が進みます。
• ゲートが不適切に思える場合は、調整するかバグを報告してください。回避策として無効にしないでください。
• 不適切なガイダンス、壊れた状態、進行を妨げるレールなどの問題は、回避するのではなく /slopmop:sm-barnacle から報告してください。

参考資料

プロジェクトのドキュメント全体：https://github.com/ScienceIsNeato/slop-mop ワークフローのステートマシン：https://github.com/ScienceIsNeato/slop-mop/blob/main/DOCS/WORKFLOW.md ゲートの判断基準：https://github.com/ScienceIsNeato/slop-mop/blob/main/DOCS/GATE_REASONING.md