slopmop

Slop-mop 技能

遇到 Slop-mop 操作上的阻碍？ 使用 /slopmop:sm-barnacle 或 sm barnacle file——绝不要直接使用 gh issue create。无论你身处何处，barnacle CLI 都会自动应用正确的标签，并将问题提交到正确的仓库。

Slop-mop（sm）有两种主要模式：改造（一次性入门）和维护（持续开发）。改造会处理所有现有的 slop 并安装永久防护；之后，在工作过程中通过 swab/scour/buff 循环保持仓库整洁。

何时使用

• 默认操作：不确定接下来该做什么时，运行 sm sail——它会读取工作流状态并采取正确操作。
• 改造（步骤 0）：运行 sm refit --start 生成整改计划，然后运行 sm refit --iterate 直至完成，最后运行 sm refit --finish 进入维护阶段。
• 实施过程中：每次有意义的代码更改后运行 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 等）。

改造（进入循环前）

改造不属于维护循环。它是步骤 0——进入循环的前提。

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

前提条件

用户的环境中必须已安装 sm CLI。如果调用失败并显示“command not found”，请建议：

pipx install slopmop[all]

然后重新运行该命令。

安全

• 绝不要绕过或屏蔽失败的检查——这只会让仓库问题不断累积。
• 如果某个 gate 似乎有误，请调整它或提交 bug。不要将禁用它作为临时变通方案。
• 遇到操作阻碍（错误的指导、损坏的状态、受阻的流程），请通过 /slopmop:sm-barnacle 报告，而不是绕过问题。

参考

项目完整文档：https://github.com/ScienceIsNeato/slop-mop 工作流状态机：https://github.com/ScienceIsNeato/slop-mop/blob/main/DOCS/WORKFLOW.md Gate 判定逻辑：https://github.com/ScienceIsNeato/slop-mop/blob/main/DOCS/GATE_REASONING.md