Przejdź do treści
Biblioteka skilli
AI i agenci · Przegląd i audyt

rulemason

/rulemason

Uzupełnia w projekcie z rulemason init opis, czerwone linie i polecenia, interpretuje wyniki rulemason check i porządkuje stare naruszenia.

Repozytorium
rulemason ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
2
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (2). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Uzupełnia w projekcie z rulemason init opis, czerwone linie i polecenia, interpretuje wyniki rulemason check i porządkuje stare naruszenia.

Oryginalny opis (EN)

在已运行 rulemason init 的项目里补齐需要理解项目的部分(项目简介、红线、命令表确认),解读 rulemason check 的结果,或在用户要求时启用判断、做存量清理。用户要接入、补全、巡检 rulemason、启用判断或批量清理既有违规时使用。

Jak działa

  1. 不可违反
  2. 1. 识别
  3. 2. 补项目信息
  4. 3. 日常巡检
  5. 4. 启用判断(可选,用户提出时才做)
  6. 5. 建立 ruff 基线
  7. 6. 建立 ESLint 基线
  8. 7. 存量清理(可选,用户提出时才做)
  9. 8. 汇报
Sekcje z nagłówków SKILL.md, w oryginale · 165 linii, 1 044 słów
Podgląd SKILL.md
---
name: rulemason
description: 在已运行 rulemason init 的项目里补齐需要理解项目的部分(项目简介、红线、命令表确认),解读 rulemason check 的结果,或在用户要求时启用判断、做存量清理。用户要接入、补全、巡检 rulemason、启用判断或批量清理既有违规时使用。
---

# /rulemason:补项目信息、巡检、启用判断与存量清理

rulemason 管三件事:**规则**(写法规矩)、**检查点**(方案与代码前后的自动检查)、**判断**(用 Jev 判断方案是否违反规矩,可选)。共享规则只在 rulemason 仓库编辑;接入(生成规则副本、工具入口、基础配置)由 `rulemason init` 完成,升级与补齐由 `rulemason update` 完成。本 skill 只做需要理解项目的事。

## 不可违反

- **先识别后动手**:第 1 步 `rulemason check --json` 的 `next.code` 决定做什么,不凭印象判断阶段,也不按文字措辞匹配。
- **一次只做一件事**:做之前列出要新增、修改的文件,用户同意后才写。
- **红线与判断规则由用户确认**:候选要注明出处(README、`openspec/config.yaml` 的 context、某个已归档方案,或「rulemason 常见红线」及触发它的文件);没确认的不写。
- **不改 rulemason 标记块**:`<!-- rulemason:… -->` 与 `<!-- /rulemason:… -->` 之间的内容、`.rulemason/` 与各工具的 skill 副本都是生成的,由 `rulemason update` 刷新,本 skill 不改。
- **不提交、不推送**:工作区里用户已有的改动一律不碰;汇报末尾列出本次改了哪些文件。
- **巡检只报告**:日常巡检不改任何文件;唯一的例外是用户确认的 ruff 基线计划与 ESLint 基线计划(见「5. 建立 ruff 基线」「6. 建立 ESLint 基线」)。

## 1. 识别

1. 先确认本机有 `rulemason` 命令,且 `rulemason --version` 不低于项目 `.rulemason.yaml` 里 `rulemason:` 记录的版本;没有命令或版本更低时,给出安装命令 `uv tool install rulemason`(已装旧版本时用 `uv tool upgrade rulemason`;需要与清单记录的版本一致时用 `uv tool install --force rulemason==<版本>`),然后停下。
2. 在项目根目录(或任意子目录)运行 `rulemason check --json`。除存量清理外,把 `text`(报告全文)原样放进汇报;存量清理的展示见本段末尾。`next.action` 是给人看的下一步,`next.code` 决定这次做什么。命令以非 0 退出且输出不是 JSON 时(例如「rulemason check 失败:openspec/config.yaml 不是合法的 YAML…」),原样转述这条提示,请用户修正对应文件,然后停下:

| `next.code` | 这次做什么 |
|---|---|
| `init` | 提示用户在项目根运行 `rulemason init`(没有 `openspec/` 时它会先询问)。停下,项目已归档再多 change 也一样。用户要你代为接入时,先运行 `rulemason init --plan` 把计划给用户看(不写任何文件),用户同意并选定工具后再运行 `rulemason init --tools <所选> --yes` |
| `fix_manifest` | 说明清单读不出来的原因(见 `layers` 的「接入 工具入口」),请用户修正,或删掉后重新 `rulemason init`。停下 |
| `fix_gitignore` | 列出要改的 `.gitignore` 规则(只放行 `skills/rulemason/`,说明单独写一行),用户确认后修改,再运行 `rulemason check --json` |
| `update` | 提示用户运行 `rulemason update`;可先用 `rulemason update --dry-run` 给用户看计划。它列出「补齐计划」时,在终端里运行会询问是否补齐,由用户答 y;非交互环境(包括你代为运行)才加 `--yes`。补齐写进项目文件的内容属于这次升级,提交时与副本一起带上。停下 |
| `manual_lint` | 接入只剩 `rulemason update` 改不了的 lint 项:`next.action` 写了要改的文件与摘要,把 `layers` 的「接入 lint 继承」里各项的行号、原文与做法列给用户;有几种做法时由用户选,用户同意后照改,再运行 `rulemason check --json`。不要让用户重跑 update |
| `fill_project_info` | 第 2 步 |
| `upgrade_machine` | 本机 rulemason 比项目记录的旧:按上面第 1 条给出安装命令。停下 |
| `none` | 第 3 步;用户说要启用判断时做第 4 步。`next.action` 附有「版本号落后」时,提一句可运行 `rulemason update` 更新记录 |

用户要做存量清理时(输入里带 `cleanup`,或自然语言说要做存量清理),`next.code` 只作第 7 节的入口闸门,不按上表进入后面的阶段。`next.code` 为 `init`、`fix_manifest`、`upgrade_machine`、`update` 时仍把 `text` 原样放进汇报并停下,不诊断也不改文件。可以继续时不贴识别表,不列写着「齐全」的行,也不列值为「一致」的巡检项。这次对话的第一次清理写一行 `next.code`,列出不是「一致」的项及其子行、不是「齐全」的行;汇报第一行不是「日常巡检:一切一致」时带上该行。同一对话里再次清理,这些行没变就写「巡检与这次清理开始时相同」,有变只列变了的行。不把上次巡检写入文件。对话中断后不记得上次的行时,按这次对话的第一次清理处理。

## 2. 补项目信息

先列文件计划(要新增、修改的文件,修改写明改哪一段;「其余 N 个未提交改动不变」),用户同意后再写。

1. **项目简介**:`rulemason init` 已从 README 第一段预填了简介;把它念给用户核对,用户要改才改。仍是「待 /rulemason 补充」时按 README 与代码写一两句话替换。
2. **红线候选**:init 把红线一节写成「暂无」,这里仍要问一次:从 README、`openspec/config.yaml` 的 `context` 里找出「绝对不能做的事」,每条注明出处;再按项目里实际存在的东西提常见红线,出处写「rulemason 常见红线(触发文件)」,没有对应的东西就不提:
   - 有数据库访问(ORM、迁移目录、数据库连接配置):「线上数据库只读,迁移与改数据由人执行」
   - 有部署脚本或 CI 发布流程:「不代为发布到生产,发布由人触发」
   - 有区分生产环境的配置(如 `.env.production`、`settings/prod.*`、`config/production.*`):「生产凭据只给人用,AI 会话不使用生产写权限」

   所有候选逐条请用户确认、改写或删除;没有找到也要问用户一句。确认的替换「暂无」写进「## 红线(不可违反)」;用户说没有就保留「暂无」。`context` 本身不改。

   **先走 OpenSpec 的区域**:再按项目里实际存在的东西提候选,每条注明触发它的文件或目录:有迁移目录或数据库连接配置提「数据库迁移与改数据」,有部署脚本或发布流程提「部署」,有鉴权、登录或权限代码提「鉴权」,有表单或数据存储提「表单与数据存储」。改到这些区域的直接改动,检查点会让 AI 先起一个最小 OpenSpec change,而不是直接改。逐条请用户确认、改写或删除,确认的写在「红线」一节下的一行「先走 OpenSpec 的区域:…」;用户说没有就写「先走 OpenSpec 的区域:暂无」。
3. **样板与豁免**:在 Code style 标记块之后写本项目样板文件路径、语言落法位置与 ruff 豁免文件。
4. **命令表**:向用户展示「本项目命令表(自动识别,请确认)」中的命令,按用户确认或修改后的内容写入,并去掉「自动识别,请确认」。判断与文案检查保持「可选,未启用」。
5. **项目工作流规格**:init 或 update 汇报 `openspec/specs/workflow-gates/spec.md` 需要合并时,检查是否已有「Apply 后自动精简并审查」或语义等价的 requirement;缺失则按 rulemason 的 workflow-gates 规格模板合并该 requirement,已有但漏了关键行为只补缺失内容,完整时不重复添加。保留项目的 Purpose、其他 requirements 与 scenarios,规格只引用 `.rulemason/rules/workflow-gates.md`,MUST NOT 复制共享检查点正文。结构异常无法安全合并时停下并报告。
6. **验证**(结果写进汇报):运行命令表里的 ruff 与测试;ruff 报出问题时转到「5. 建立 ruff 基线」;有前端时也运行命令表的前端 lint,报出基础规则的问题时转到「6. 建立 ESLint 基线」;没经用户确认**不改代码**;再运行一次 `rulemason check --json`,确认 `next.code` 不再是 `fill_project_info`。
7. 提醒用户:在本项目开一次交互会话,问「九条第 9 条是什么」,确认所选工具已加载共享规则。
8. **问一次判断层**:识别表「判断」一行写着条件已满足、尚未启用时,在汇报末尾问一次「下一步要不要整理判断规则」,同时说明判断审 OpenSpec 方案、界面文案与直接改动的说明;「接入后归档 change」为 0 或「—」时照实加一句「接入后还没起过 change,方案与文案的判断暂时用不上,直接改动的判断仍会用到」。只问不做,本次不进入第 4 节。

## 3. 日常巡检

只读,不改文件(例外见「不可违反」)。按 `rulemason check` 的结果逐项解读:一致的写「一致」;有偏离的写出文件、内容和建议怎么改(由用户决定改不改)。

- 生成副本或标记块被手改:建议把改动搬到 rulemason 仓库,再运行 `rulemason update` 恢复。
- 升级产出要一起提交:`rulemason update` 刷新的副本、`.rulemason.yaml`,以及补齐计划写进项目文件的内容(如 `openspec/config.yaml` 的 rules、operations 里新增的条目、新建的 ruff 配置)都属于这次升级。怎么认出:`rulemason update` 输出里「补齐计划」列出的文件就是;事后再看时,把 `openspec/config.yaml` 里未提交的新增条目与安装包里的基础版逐字比对:用 `uv tool` 安装的,基础版在 `find "$(uv tool dir)/rulemason" -path "*_shared/openspec-base/*.yaml"` 找到的文件里(macOS、Linux 与 Windows 的目录层级不同,用 find 不必猜路径),能找到原文就是基础版,不是项目自己加的规则。用其他方式安装、找不到这个目录时,以 `rulemason update --dry-run` 列出的补齐计划为准。巡检的「与基础版的差异」只查基础条目有没有缺,不能用来认定新增条目是基础版。汇报把认出的升级产出列为「升级产出,提交时与副本一起带上」,本 skill 不提交。
- 版本号落后、副本内容相同:可以运行 `rulemason update` 更新记录,不急。副本内容落后时 check 会在「接入 生成副本」报出并给出 `update`,不会走到这里。
- 要增减工具:建议运行 `rulemason init --tools <id,...>`,它会先列出受影响文件并等确认;取消的工具会连同入口一起删除。
- 最近归档的检查点记录有缺:说明哪个 change 缺什么,提醒下次归档前按检查点把审查与测试跑完并写进 `verification.md`;不要补写过去的汇报。这一项只看接入日期(识别表「接入日期」)之后的归档;写着「接入后尚未归档,无记录可查」时不是问题,不用处理。识别表的接入日期标着「推算」时,提一句运行 `rulemason update` 会把它记进清单。
- 主规格写法有问题:按类型转述能力路径,说明读主规格判路时会因此漏看(增量格式标题、没有 `## Requirements` 时 OpenSpec 读出的 requirement 是 0 条);建议起一个最小 change 修正这些规格,或请用户授权直接改后运行 `openspec validate --specs --strict`。本 skill 不改规格。
- lint 脚本为占位:列出文件与原文,说明 CI 跑它等于什么都没查;建议换成真的 lint 命令并引入基础规则,之后按「6. 建立 ESLint 基线」处理既有问题。
- 运行命令表的 ruff:报出问题且 ruff 配置里还没有「接入前遗留」豁免时,按「5. 建立 ruff 基线」列出计划,用户确认后才写;已有基线、只剩少量新问题时,列出文件与规则代码即可。
- 有前端时运行命令表的前端 lint:报出基础规则的问题、或 ESLint 配置里还是旧口径的全局放宽(全局提高了复杂度上限、整条关掉基础规则)时,按「6. 建立 ESLint 基线」列出计划,用户确认后才写。
- 命令表之后仍是旧写法「红线规则:暂无。」时,提一句可改为「判断用的红线规则:暂无(判断未启用;项目红线见上文「红线」一节)」,不强制。
- 项目指令里没有「先走 OpenSpec 的区域」一行时,提一句可以补(按第 2 节第 2 步的候选),不强制。
- 识别表「判断」一行写「可选,未启用」时,说明启用条件与覆盖范围(判断审 OpenSpec 方案、界面文案与直接改动的说明);用户没有提出要启用就不做第 4 步。

## 4. 启用判断(可选,用户提出时才做)

判断用 Jev 检查方案是否违反已写下的规矩。前提:项目在 git 仓库里,已归档至少 3 个 change。项目没有 git 时,说明判断层需要 git(文案检查要与主分支比较),停下,不生成判断层文件。

**4.1 整理判断规则**

1. 读 `openspec/changes/archive/` 下各 change 的 `proposal.md` 与 `design.md`,找出反复出现、且能指回已写下规矩(`AGENTS.md` 某个二级标题、`config.yaml` 的 rules 或 context、某份规格)的问题。
2. 每条候选写:规则 id(kebab-case)、要问 Jev 的一句正向陈述、`expect`、`enforces`、出现在哪几个 change。两条通用规则(写明不做什么、不做过度设计)引擎已自带,「决策附备选」由 `lint/design` 检查,都不列。
3. 已归档不足 3 个时,写明还差几个,停下。
4. 候选只写在汇报里,不建文件;等用户逐条确认。

**4.2 启用判断**(用户确认了至少一条候选规则后)

模板随安装包提供,用 `rulemason judge --template <名称>` 取得,项目里没有模板副本。

1. `openspec/judgments.yaml`:以 `rulemason judge --template judgments` 的输出为起点,只写用户确认的规则;每条确认的红线规则(`enforces` 指向红线一节)再问一次是否也用在不走 OpenSpec 的直接改动上,同意的另写一条 `target: direct` 的规则:id 加 `direct-` 前缀,问题改为「这次改动:<违规的那件事>」,block 阈值起始为 0,原来 `target: design` 的那条不动;红线规则 `thresholds` 的 block 起始为 0(只 review 不拦),文件里注明。
2. `openspec/judge.yaml`:以 `rulemason judge --template judge` 为起点;项目有界面文案才写 `copy` 段(嵌套 JSON 用 `json`,HTML 内 `const I18N` 用 `js-i18n` 加 `lang`),有项目禁词才写 `banned`。
3. 回归用例骨架:以 `rulemason judge --template judge_cases` 为起点,放在项目测试目录;每条确认的规则至少列出一个待人工标注的用例位置。
4. `AGENTS.md` 命令表中的判断与文案检查改为 `rulemason judge --change <name>`、`rulemason judge --copy`,并加一行「判断回归」,填运行回归用例的命令;命令表之后「判断用的红线规则」一行(旧写法「红线规则:…」一行同理)改为列出用户确认的规则 id(这些都在标记块之外)。
5. key:本机没有 key(`~/.config/rulemason/env` 与旧位置 `~/.config/jev-judge/env` 都没有)时,提示用户在自己的终端运行 `rulemason key`,交互输入;**不代填 key**,也不在会话里处理 key。没有 key 时判断以人工模式运行。
6. **验证**:`rulemason judge --change <一个已归档 change> --lint-only` 不报 enforces 指向不存在;有 key 时再跑一次不带 `--lint-only` 的,结果写进汇报。

## 5. 建立 ruff 基线

补项目信息第 6 步或日常巡检时,命令表的 ruff 报出问题才做;没有报出问题时汇报写「ruff 通过,无需建立基线」,不改 ruff 配置。豁免全部写在项目的 ruff 配置里(init 写的那份,`pyproject.toml` 时表名前加 `tool.ruff.`),之后检查点只修本次改动引入的问题。不用 `# noqa`,不改计划以外的代码。

1. **统计**:在命令表 ruff 的命令后加 `--statistics` 运行,按规则代码列出数量。
2. **分四类写计划**,只写在汇报里,先不改文件:
   - **可安全自动修复**(`I001` import 排序、`F401` 未用导入):给出命令与预计数量,用户确认后才运行:
     ```bash
     ruff check <命令表里的路径> --select I001,F401 --extend-exclude __init__.py --force-exclude --fix
     ```
     计划里先把 `--fix` 换成 `--diff` 运行一次,列出会被改到的文件,并与 `git status` 对照:有用户未提交的改动时,请用户先提交,或把这些文件排除在外。不加 `--unsafe-fixes`,不对其他规则 `--fix`;排除 `__init__.py` 是因为其中的未用导入常是有意的再导出。修复后先跑命令表的测试,建议用户单独提交这一步。
   - **框架在参数默认值里调函数**(`B008`,且 `pyproject.toml` 或 `requirements*.txt` 里有 `fastapi` 或 `typer`):在项目 ruff 配置声明,按项目实际依赖只写用得上的那组:
     ```toml
     [lint.flake8-bugbear]
     # FastAPI / Typer 约定在参数默认值里声明依赖与参数,不是可变默认值
     extend-immutable-calls = [
         "fastapi.Depends", "fastapi.Query", "fastapi.Path", "fastapi.Body", "fastapi.Header",
         "fastapi.Cookie", "fastapi.Form", "fastapi.File", "fastapi.Security",
         "typer.Option", "typer.Argument",
     ]
     ```
     计划里写明 B008 总数和这些函数各占多少;剩下的 B008 归入最后一类,用户也可以补充要声明的函数。
   - **脚本与命令行入口的 `print`**(`T201`):项目写明的脚本目录与命令行入口文件写进 `[lint.per-file-ignores]`,注明原因,例如 `"scripts/**" = ["T201"]  # 脚本的正常输出`。
   - **其余既有问题**:前三类做完后再运行一次 ruff(加 `--output-format json`),按文件汇总剩下的规则代码,写进 `[lint.per-file-ignores]`:上方一行注释 `# 接入前遗留,改到该文件时清掉`,每个文件一行,按路径排序,只列该文件实际有的代码,路径相对 ruff 配置所在目录。已有 `per-file-ignores` 表时加在表里,不另起一张同名表;init 留下的 `〈脚本目录〉` 占位注释行一并删去。
3. **列给用户确认**:四类各自的数量、要运行的命令、会被自动修复改到的文件、要写进 ruff 配置的原文(遗留条目多时列前 20 行与总条数)。此时还没重跑,遗留条目是预估:从统计里扣掉可自动修复和已声明的部分;确认后以重跑结果为准,与预估不同的地方写进汇报。用户可以只同意一部分;不同意自动修复时,`I001`、`F401` 也按文件写进遗留豁免,代码一行不改。
4. **确认后照做**,再运行命令表的 ruff 与测试:ruff 必须通过;汇报写明修复前后的问题数、写入的豁免条目数、自动修复改了几个文件。

## 6. 建立 ESLint 基线

补项目信息第 6 步或日常巡检时,命令表的前端 lint 报出基础规则(`no-console`、`no-nested-ternary`、`no-empty`、`complexity`)的问题,或 ESLint 配置里还是旧口径的全局放宽时才做;都没有时汇报写「基础规则没有报错,无需建立 ESLint 基线」,不改 ESLint 配置。豁免全部写在引入基础规则的那份 ESLint 配置里,之后检查点只修本次改动引入的问题。不整条关规则,不提高全局复杂度上限,不另写「只查改动文件」的命令(命令行的 `--rule` 会盖过配置里按文件写的豁免),不在代码里写 `eslint-disable`,不改计划以外的代码。有几个前端目录就各做一遍。

1. **统计**:在命令表前端 lint 的命令后加 `--format json -o <临时文件>` 运行(命令是 `pnpm run lint` 这类脚本时,参数前加 `--`),按文件与规则汇总基础规则的报错;`complexity` 从消息里的「complexity of N」取每个文件的最大值。其他规则(框架规则、类型规则)的问题不在本节处理,汇报列出数量即可。
2. **分两类写计划**,只写在汇报里,先不改文件:
   - **旧口径的全局放宽**:配置里把 `complexity` 全局提高了、把某条基础规则整条设成 `"off"`,或命令表的前端 lint 用 `--rule` 重新打开规则:标着接入过渡、递减计划或没写原因的,计划删掉这些覆盖、命令表改回普通的 lint 命令,删掉后再统计一次,结果按下一类处理;项目写明了长期原因的放宽(如只对日志出口文件放开 `no-console`)不在此列,列给用户确认是否保留。
   - **按文件的遗留条目**:在配置数组里、引入基础规则的那一项之后,每个文件追加一条,只放开该文件实际违反的规则,复杂度写该文件的最大值;没超过 15 的文件不写 `complexity`。按路径排序,路径相对 ESLint 配置所在目录:
     ```javascript
     // 接入前遗留,改到该文件时清掉
     { files: ["src/pages/Detail.tsx"], rules: { "no-nested-ternary": "off", complexity: ["error", 35] } },
     { files: ["src/utils/format.ts"], rules: { "no-console": "off" } },
     ```
3. **列给用户确认**:每条规则的报错数与涉及文件数、要删掉的全局覆盖原文、要写进配置的条目原文(条目多时列前 20 行与总条数)。用户可以只同意一部分。
4. **确认后照做**,再运行命令表的前端 lint 与测试:基础规则的报错必须清零,项目自己的规则若还有报错,不在本节处理,汇报列出数量;汇报写明建基线前后的问题数、写入的条目数、删掉了哪些全局覆盖。

## 7. 存量清理(可选,用户提出时才做)

用户要清理既有代码时做:输入里带 `cleanup`,或自然语言说要做存量清理。不带模块名只诊断全仓;带模块名只修该模块。这是不改行为的重构,改完按检查点「不走 OpenSpec 改代码时」第 4 步跑 ruff、前端 lint 与测试。

**入口**:先跑 `rulemason check --json`。`next.code` 为 `init`、`fix_manifest`、`upgrade_machine`、`update` 时按第 1 节停下,不诊断也不改文件。为 `fill_project_info`、`manual_lint`、`fix_gitignore`、`none` 时继续。可以继续时的展示按第 1 节,不贴全文。

**只诊断**:不带模块名时只输出诊断,不改任何文件。最后一行之前列出队列,不把队列写入文件。已有 `refactor(cleanup): <模块>` 提交的模块跳过。工作区干净的排在有未提交改动的前面;再按软指标条数从多到少,相同按行数从多到少,仍相同按模块路径字典序。高、中、低只标在行旁,不决定先后。潜力为低的合成一行,写明这次不做。还有工作区干净、且不是低的模块时,汇报最后一行写排序后第一条的 `/rulemason cleanup <模块>`。这条命令之前写一句这次要做的事,只用该模块已经抽到的 1 到 2 个例子,写明要动的位置、要做的事,以及哪一类软指标不算这次要清的内容。这句只给这一条命令点名的模块,不写入文件,也不代替进入后的计划,也不是用户确认。没有这种模块时,不写这句;在有未提交文件的模块里按同一顺序取第一条,最后一行写它的要先提交的路径,不进入该模块。这种模块也没有时,写明这次没有要做的模块。

模块算完成只认 `refactor(cleanup): <该模块>` 这种提交。清理改动还在工作区时仍算未完成。本 skill 不提交。

**诊断**分三层,每个模块都要有。只读代理同时最多 5 个;没有子代理就串行。不把诊断或进度写入 `.rulemason/` 或新的状态文件。

- 硬指标:读 ruff 与 ESLint 的「接入前遗留」条目和复杂度。
- 机械软指标:在项目根跑一次 `ruff check --select ARG,ERA,BLE,S110,T201 --output-format json`,按文件归到模块后再按模块拆开计数(`--statistics` 没有路径,拆不开)。只加临时参数,不改项目的 lint 配置。查重复:有 Node 时 `npx --yes jscpd@5.4.2 <路径> --reporters json --output <仓库外临时目录>`,用完删掉;没有 Node 且有 Python 时 `uvx pylint@4.1.3 --disable=all --enable=duplicate-code <路径>`;没有可运行的工具、离线、下载失败或命令失败时,空出这一列并写明原因。再统计缺少文件首行注释的文件数。
- 抽样:每个模块抽 2 到 3 个最大或最复杂的文件,读完给高、中、低三档精简潜力,并举 1 到 2 个例子。

进度不另存。硬指标看「接入前遗留」条目是否还在;软指标看 `git log --grep '^refactor(cleanup):'`。没有这种提交的模块,诊断里标明还没有清理提交。

**修一个模块**:模块名只划定范围,其他模块不改。先通读该模块的文件,列出软建议;再列出下面第 1、2 步的计划(分组、共用模块、要存的指标、准备落地的建议)。用户确认后再做,可以只同意其中几条;未确认不改任何文件。改文件的代理同时最多 3 个;没有子代理就串行。

1. **规划**:从 lint 的 JSON 输出或基线条目列出要清的文件,按模块分组,同一文件只属一组;清单里的文件有未提交改动时先剔除,或请用户先提交,否则改前提交对不上起点,`git diff` 核对也会混进用户的改动。每组建议 3–6 个文件。多组都要用的辅助函数先规划成共用模块、在一处建好,计划里写明各组复用它;不要为了缩小改动面要求「不新建文件」,那会让同一个函数在每组各复制一份。
2. **先存证据**:动手前在改前的提交上建一个临时 worktree(`git worktree add --detach <临时目录> <改前提交>`,临时目录放在仓库外,免得 lint 把它一起扫进去),在那里跑命令表的 ruff 或前端 lint(加 JSON 输出),统计要盯的指标(如超过 15 的函数个数与最大值),结果存成一份放在 worktree 外的文件,写明提交号。前端依赖先用本机缓存离线安装,缺的才下载;装不上时停下说明,由用户决定怎么取改前数字。不要把改前代码经 stdin 交给 lint:带类型检查的配置会按路径读磁盘上的当前文件,得到的是改后的数字。
3. **代理指令**:每组同一份,按项目语言改写。只改本组清单里的文件;不动 git 状态(不提交、不暂存、不切分支、不 stash);行为等价是硬要求,React 按 react.md「重构等价性」逐条对照;碰到读源码断言原文的测试,按检查点「改既有测试时」处理;拆函数拆到下一档以内,不刚好卡在上限;汇报写改了哪些文件、每个文件的指标改前改后,并附一处有代表性的改前改后代码。
4. **恢复**:有组中途停下(用量上限、出错)时,先用 `git diff --stat` 与清单核对哪些文件已经改完,只把没改完的交出去继续,不重做已完成的部分;证据文件不重跑。
5. **主会话复核**:在当前工作区重跑同样的指标,与证据文件对比,要盯的指标都不应变差(如超过 15 的函数个数不应变多);React 改动按「重构等价性」抽查;本次新增的函数按名字在仓库里检索,有重复就合并进共用模块。
6. **收尾**:清干净的文件从 ruff 或 ESLint 的「接入前遗留」条目里删掉,上限降一档的同步改配置;用 `git worktree remove --force <临时目录>` 删掉临时 worktree(里面装过依赖,不加 `--force` 删不掉),再 `git worktree prune`;汇报按第 8 节写,附改前改后的指标对比。本 skill 不提交。要让下次诊断认出这个模块,由用户提交,提交说明写成 `refactor(cleanup): <模块>`。收尾先要求这次提交。这一轮先排除当前模块,即使提交还没落地;之后不带模块名的诊断仍只认该提交。然后把该模块视为已完成,按同一顺序重算下一个:工作区干净的在前,再按软指标条数、行数从多到少、模块路径字典序。不再抽样,也不看高、中、低。还有工作区干净的未完成模块时,最后一行给出排序后第一条的 `/rulemason cleanup <模块>`,不改下一个模块的文件。同一次诊断的抽样里已有该模块的 1 到 2 个例子时,用那些例子在命令前再写一句这次要做的事,写明要动的位置、要做的事,以及哪一类软指标不算这次要清的内容。同一次诊断里没有这些例子时,不写这句,并写明具体改哪些等进入该模块后的计划。没有工作区干净的未完成模块时,在有未提交文件的模块里按软指标条数、行数、模块路径字典序取第一条,最后一行写它的要先提交的路径,不进入该模块;同一次诊断里没有该模块的例子时,写明具体改哪些等进入该模块后的计划。这种模块也没有时,只写明这次没有要做的模块,不写具体改哪些。这两种都不写这次要做的事。用户输入该命令后仍先列计划,用户确认后再做。

## 8. 汇报

按顺序:`rulemason check --json` 的 `text` → 本次做了什么 → 每项验证命令与结果 → 本次新增、修改的文件清单 → 没碰的东西(未提交改动数)→ 下一步(以 `next.action` 为准)。存量清理可以继续时,收尾不以全文开头,展示与第 1 节可以继续时相同。要停下时仍贴全文并停下。

Wersje

W bazie nie ma innych skilli o nazwie rulemason.

Migawka bazy z 13.11.2026 · wersja paczki c869e2b1c807 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100init
    Inicjalizuje Agent Skills w projekcie, sprawdzając wymagania wstępne i konfigurację walidatora.
  • 100init
    Skanuje projekt i generuje dopasowany CLAUDE.md, wykrywając stos, polecenia testów i konwencje przy wejściu do nowego projektu.
  • 100init-pipeline
    Konfiguruje potok subagent-system w projekcie: tworzy PIPELINE_CONFIG.md i szkielet punktów kontrolnych.
  • 100pm-init
    Inicjalizuje lub odświeża Project Memory repozytorium: przegląda bazę kodu, tworzy startowe jednostki PM i uzupełnia indeks pm-index.md.
  • 100memory-init
    Inicjalizuje system pamięci w bieżącym katalogu: tworzy CLAUDE.md, opcjonalnie AGENT.md dla Cursora, MEMORY.md i katalog memory.
  • 100init-deep
    Generuje pliki AGENTS.md w poszczególnych katalogach z instrukcjami zależnymi od kontekstu w całym projekcie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.