القائمة
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 を使う