菜单
Use when a TypeScript or JavaScript codebase needs duplicate-code detection, similar function or type-definition analysis, or refactoring-candidate triage based on `similarity-ts`. Do not use for Python, Go, Rust, or general multi-language clone detection.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Route work in the `~/.apm` global APM workspace: decide what owns a change, which path is the source of truth, and which APM rollout / `mise` task to run. Use for skill update and redistribution requests (`skillアップデートして再配布して`, `再配布`), `apm.yml` / `apm.lock.yaml` and managed catalog rollout, manual-skills package state, orphaned APM packages, checked-out external dependency repositories, optional repository-scoped skill packages, and `apmのバージョンあげて` / pinned `apm` source checks. For skill body, description, script, reference, or asset design itself, coordinate with `skill-creator`; for general mise usage outside the APM workspace (including `mise upgrade TOOL` and `minimum_release_age`), use `mise`.
Use when deciding whether to install, enable, or troubleshoot Headroom context compression for local AI agent workflows, especially MCP, proxy, or agent-wrap usage.
Use when adding or reviewing CI-stability hooks and gates: Lefthook/pre-commit/pre-push configuration, aligning local push gates with GitHub Actions, deciding commit-vs-push gate scope, or migrating pre-commit to Lefthook. For mise task design itself, use `mise`; for debugging failing PR checks, use `gh-fix-ci`.
Curate external agent collections into this APM workspace. Use when evaluating whether an outside agent repository can be installed through APM, importing selected agents into catalog/agents, recording provenance, or refreshing curated agents from upstream.
Use when creating, rebuilding, or updating a Google Forms survey from a Markdown survey spec such as SURVEY_QUESTIONS.md, especially when the form should stay synchronized with question text, required flags, Google Forms item types, scale labels, and removed-question notes.
Slack app management knowledge for app settings, manifests, OAuth installs, scopes, bot users, Marketplace settings, App Home, display names, sender names, mrkdwn message formatting, and safe workspace-visible changes. Use when diagnosing or changing a Slack app, installed app, bot user, app label, DM header, chat sender, message text decoration, Slack links, block quotes, app approval/install state, token impact, Slack API app settings, Slack Marketplace settings, or stale Slack app name propagation.
| name | similarity |
| description | Use when a TypeScript or JavaScript codebase needs duplicate-code detection, similar function or type-definition analysis, or refactoring-candidate triage based on `similarity-ts`. Do not use for Python, Go, Rust, or general multi-language clone detection. |
similarity-ts で TypeScript / JavaScript の類似コードを検出し、共通化候補を優先度付けする。
# ツール確認（mise 管理。見つからなければ `mise which similarity-ts` → `mise install`）
# 0.5.0 未満は interface を検出しないバグがある（下記「実測済みの落とし穴」参照）
similarity-ts -V
# 最小オプションで実行し、レポートをリポジトリ直下の tmp/ に出す
mkdir -p tmp && similarity-ts src/ > tmp/similarity-report.md
# 関数ペアが 0 件・少なすぎる場合は再実行（短い関数はスコアが割引かれるため）
similarity-ts --no-size-penalty src/ > tmp/similarity-report.md
初回からオプションを盛らない。結果を見てから閾値やフィルタを足す。
--no-size-penalty を付けて再実行する（下記「実測済みの落とし穴」参照）find_referencing_symbols、使えなければ rg で全参照を列挙）、テストを確保してから 1 ペアずつ抽出する| 類似度 | 判断 |
|---|---|
| 95%+ | ほぼコピー。即共通化候補 |
| 90-95% | 高優先。差分を精査してリファクタ |
| 87-90%（デフォルト閾値） | 候補としてメモし、計画的に対応 |
| 87% 未満 | 基本ノイズ。参考情報に留める |
複数ペアが同じ抽出テーマに収束する場合（同型の get / remove 系など）はテーマ単位でまとめ、派生ペアを個別候補として数えない。ユーザーが調査対象を明示している依頼（特定の型群・関数群、型全般の整理など）では、87% 未満でも当該対象を補完調査してよい（低閾値での再実行または手動レビュー）。依頼スコープが一部カテゴリのみの場合、スコープ外の検出結果は参考情報として分離して報告する。判断と計画は生レポートと分けて tmp/similarity-plan.md などに書く。既存の成果物ファイルがある場合は上書きせず、トピックや日付を付けた別名にする。
計画を書く場合は references/report-analysis.md を必ず読む（実出力フォーマットの読み方と計画テンプレートがある）。
関数と型定義はデフォルトで両方チェックされる。クラスのみ --classes で明示的に有効化する。
| 目的 | コマンド例 |
|---|---|
| 閾値変更（デフォルト 0.87） | similarity-ts -t 0.9 src/ |
| 短い関数の重複も拾う | similarity-ts --no-size-penalty src/ |
| 関数 / 型チェックの無効化 | --no-functions / --no-types |
| interface のみ / type alias のみ | --interfaces-only / --types-only |
| interface と type alias の相互比較 | --allow-cross-kind |
| クラスチェック（デフォルト無効） | --classes |
| 関数名 / 本体で絞り込み | --filter-function "User" / --filter-function-body "prisma" |
| 小さい関数を除外（デフォルト 3 行） | --min-lines 5 / --min-tokens 50 |
| 類似コード本体も表示 | --print |
| 拡張子指定 | --extensions ts,tsx |
| 構造 / 命名の重み変更（デフォルト 0.6 / 0.4） | --structural-weight 0.8 --naming-weight 0.2 |
実測済みの落とし穴:
--no-size-penalty を付けるany を導入しない。型パラメータか専用インターフェースで受けるrefactoring スキルが束ねる。このスキルは similarity-ts 単体の実行と判断に集中するcode-quality-improvement、デッドコード削除は tsr を使う