similarity-check
mizchi/similarity による重複検出。差分の言語に応じた並列検査、リファクタ前の洗い出し、レビュー・pre-review-check の DRY 検査、新規実装前のコピー元探しに使う。「重複コード検出」「similarity」「似たコード探して」で起動。
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- similarity-check
- description
- mizchi/similarity による重複検出。差分の言語に応じた並列検査、リファクタ前の洗い出し、レビュー・pre-review-check の DRY 検査、新規実装前のコピー元探しに使う。「重複コード検出」「similarity」「似たコード探して」で起動。
- argument-hint
- [path] [--threshold 0.85]
- user-invocable
- true
03 SKILL.md 正文
similarity-check
mizchi/similarity の言語別 CLI でコードベースの構造的な重複を検出する。
ツール選択
| 対象言語 | コマンド | 成熟度 |
|---|---|---|
TypeScript / JavaScript(.ts, .tsx, .js, .jsx, .mts, .cts, .mjs, .cjs) |
similarity-ts |
Production Ready |
Python(.py) |
similarity-py |
Beta |
Rust(.rs) |
similarity-rs |
Beta |
CSS(.css) |
similarity-css |
Experimental |
SCSS(.scss) |
similarity-css --scss |
Experimental |
Markdown(.md, .markdown) |
similarity-md |
Experimental |
Elixir(.ex, .exs) |
similarity-elixir |
Experimental |
対象と実行
- 明示されたファイル・ディレクトリ、またはレビュー元が選んだ差分を使う。指定がないローカル作業では
git diff --name-only --diff-filter=ACMR -z HEADとgit ls-files --others --exclude-standard -zから変更ファイルを集める。差分がなければ対象ディレクトリ内のファイルから選ぶ。 - 拡張子を上表のコマンドに対応付け、同じコマンドとオプションの組は 1 回だけ起動する。CSS と SCSS は別ジョブにする。対応拡張子がなければ検査対象なしと報告する。
- 差分起点でも変更ファイルだけを CLI に渡さず、比較相手を含む関連ディレクトリ(通常は同じ package / リポジトリ)をスキャンする。明示的なファイル間比較なら、そのファイルを渡す。
- 言語ごとの独立した CLI を並列実行して全結果を回収する。未インストールの実行ファイルはその言語だけ保留し、
cargo install <実行ファイル名>(SCSS もsimilarity-css)を案内して他の検査を続ける。 - 差分レビューでは、少なくとも片側が変更ファイルにあるペアを優先し、該当箇所が変更されたか確認して報告する。
基本コマンド
similarity-ts . # 対象ディレクトリの TS / JS をスキャン
similarity-rs . # Rust の変更がある場合
similarity-css . # CSS の変更がある場合
similarity-css --scss . # SCSS の変更がある場合
similarity-md . # Markdown の変更がある場合
similarity-elixir . # Elixir の変更がある場合
similarity-ts src/a.ts src/b.ts # 明示的なファイル間比較
出力例: src/utils.ts:10-20 calculateTotal <-> src/helpers.ts:5-15 computeSum / Similarity: 92.50%
使いどころ
- リファクタ前の重複洗い出し: スキャン → 重複ペアを影響度順に整理 → 統合プランを提示。統合先の妥当性判定は
rules/review-policy.mdの DRY 基準に委譲する - レビュー / pre-review-check の補助: 変更ファイルと関連実装の類似を確認し、
rules/core-standards.md「実装の梯子」2 段目(既存コードの再利用)の機械的裏付けにする - 新規実装前: Copy-from-existing 原則のコピー元探しに、書こうとしている処理と似た既存実装を探す
解釈の規律
- しきい値は CLI ごとのデフォルトを使う。調整時の
--thresholdは0.0〜1.0(例:0.9)で指定する。90%+ は統合候補、80〜90% は要文脈判断、それ未満は基本ノイズ - 検出結果は leads であって facts ではない。統合提案の前に必ず両方のコードを開いて意図的な分離でないか確認する
- Beta / Experimental の結果は誤検出を前提に原文で確認し、未検出を「重複なし」の証拠にしない
- テストコードの類似の扱いは
rules/review-policy.md「テストファイルのサイズと重複の扱い」節に委譲する
04 同仓库更多 Skills
writing-for-agents
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
wrangler
Run or troubleshoot Wrangler CLI commands in projects that have a wrangler.jsonc, wrangler.json, or wrangler.toml file, including local development, Previews, deployment, and resource management. For new projects and projects without a Wrangler configuration file, use the cf CLI instead.
workflow-modernize
パッケージ/CLI更新時や定期見直し時に、自作スキル・ワークフロー・設定を監査し、不要なworkaroundの撤廃・新機能の適用・プロンプトの簡素化をGrill(壁打ち)と多角比較で提案・修正する。「workflow-modernize」「スキル監査」「ワークフロー改善」「パッケージ更新後の見直し」「モダナイズ」で起動。
workers-best-practices
Cloudflare Workers best practices for production applications. Use when writing, reviewing, or configuring Workers.
web-perf
Audit, diagnose, or optimize website loading and interaction performance, Core Web Vitals, and Lighthouse performance scores.
wayfinder
Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.