Agent skill

cl-mallet-linter

malletリンターのルールと設定を適用。コードレビュー・品質チェック時に使用

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/cl-mallet-linter

SKILL.md

Mallet Linter Guide

Malletは、スタイルの強制ではなく実際の間違いを捉えることに特化したCommon Lispリンターです。

基本コマンド

bash
# ファイル/ディレクトリをリント
mallet src/

# 全ルール有効化
mallet -a src/
mallet --all src/

# 自動修正（ドライラン）
mallet --fix-dry-run src/

# 自動修正実行
mallet --fix src/

# 出力形式指定
mallet --format json src/
mallet --format line src/   # GCC形式

重大度レベル

レベル 説明 例
error 確実に間違い wrong-otherwise
warning バグの可能性 unused-variables, missing-otherwise
convention イディオム推奨 if-without-else, special-variable-naming
format フォーマット trailing-whitespace, no-tabs
info スタイル選択 line-length, constant-naming
metrics 品質測定 cyclomatic-complexity, function-length

主要ルール

Error（エラー）

ルール 説明
wrong-otherwise ecase/etypecaseでotherwise/tを使用

Warning（警告）

ルール 説明
unused-variables 未使用変数
unused-local-functions 未使用ローカル関数
missing-otherwise case/typecaseにotherwise句がない
mixed-optional-and-key &optionalと&keyの混在

Convention（慣例）

ルール 説明
if-without-else else節なしのif → when/unless推奨
bare-progn-in-if ifでprogn → cond推奨
interned-package-symbol パッケージで#:形式推奨
special-variable-naming 特殊変数はname形式
asdf-component-strings ASDFコンポーネントに文字列使用

Format（フォーマット）

ルール 説明
no-tabs タブ禁止
trailing-whitespace 行末空白
final-newline ファイル末尾改行

Info（情報）

ルール 説明 デフォルト
line-length 最大行長 100
consecutive-blank-lines 連続空行 2
unused-local-nicknames 未使用ニックネーム -
unused-imported-symbols 未使用インポート -
constant-naming 定数は+name+形式 -
needless-let* 不要なlet* -

Metrics（メトリクス）

ルール 説明 デフォルト
cyclomatic-complexity 循環複雑度 20
function-length 関数行数 50

設定ファイル (.mallet.lisp)

lisp
(:mallet-config
 ;; ベース設定
 (:extends :default)  ; :default, :all, :none

 ;; 無視パス
 (:ignore "vendor/**/*.lisp"
          "**/generated/*.lisp"
          "examples/**/*.lisp")

 ;; ルール有効化（オプション付き）
 (:enable :line-length :max 100)
 (:enable :cyclomatic-complexity :max 15)
 (:enable :function-length :max 40)
 (:enable :consecutive-blank-lines :max 2)
 (:enable :constant-naming)

 ;; ルール無効化
 (:disable :if-without-else)

 ;; パス固有設定
 (:for-paths ("tests")
   (:enable :line-length :max 120)
   (:disable :unused-variables))

 (:for-paths ("scripts" "examples")
   (:disable :line-length)
   (:disable :trailing-whitespace)))

CLIオプション

bash
# プリセット
--preset default    # 推奨ルールのみ
--preset all        # 全ルール
--preset none       # ルールなし

# ルール制御
--enable rule-name
--enable rule-name:opt=value
--disable rule-name
--enable-group metrics
--disable-group info

# 出力
--format text       # デフォルト
--format line       # GCC形式（エディタ統合用）
--format json       # プログラム処理用

# 修正
--fix               # 自動修正
--fix-dry-run       # 修正プレビュー

# その他
--config path       # 設定ファイル指定
--debug             # デバッグモード

自動修正可能なルール

以下のルールは --fix で自動修正可能:

  • trailing-whitespace - 行末空白を削除
  • final-newline - ファイル末尾に改行追加
  • consecutive-blank-lines - 過度な空行を削除
  • unused-local-nicknames - 未使用ニックネームを削除
  • unused-imported-symbols - 未使用インポートを削除

ソースコード内での抑制

lisp
;; 次のフォームを抑制
#+mallet
(declaim (mallet:suppress-next :if-without-else))
(defun foo () (if x (print "yes")))

;; 領域を抑制
#+mallet
(declaim (mallet:disable :line-length))
;; ... 長い行のコード ...
#+mallet
(declaim (mallet:enable :line-length))

;; スコープ内で抑制
(defun foo ()
  #+mallet
  (declare (mallet:suppress :unused-variables))
  (let ((unused 1))
    (do-something)))

;; 全ルール抑制
#+mallet
(declaim (mallet:suppress-next :all))
(defun generated-code () ...)

終了コード

コード 意味
0 問題なし
1 警告あり
2 エラーあり
3 実行エラー

推奨ワークフロー

開発中

bash
# デフォルトルールでチェック
mallet src/

# 問題を確認して修正
mallet --fix-dry-run src/
mallet --fix src/

PR前

bash
# 全ルールでチェック
mallet -a src/

# メトリクス確認
mallet --enable-group metrics src/

CI/CD

bash
# 厳格チェック（エラーで失敗）
mallet --format line src/ && echo "Lint passed"

Didn't find tool you were looking for?

Be as detailed as possible for better results