菜单
similarity-ts を使って TypeScript/JavaScript の重複コードを検知し、優先度付きのリファクタリング計画を作成する。ユーザーが「重複を検出したい」「類似コードを整理したい」「リファクタリング計画を作りたい」と依頼したときに使う。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
コードベース全体、特定分野、ブランチ差分の改善候補を監査し、根拠付きで優先順位を付け、改善バックログとして残すときに使う。ユーザーが「$improve」「/improve」「コードベースを監査して」「改善候補を優先順位付きで出して」「改善バックログを作って」「このブランチで増えた問題を調べて」「改善バックログを再照合して」「リポジトリの次の方向性を考えて」と依頼した場合に使う。既知のバグ修正、直接の実装、通常のコードレビュー、設計済み作業の計画書作成、実装結果の受け入れ検証には使わない。
設計済みの作業を別エージェントへ渡すため、実装計画書や handoff プロンプトの作成を求められたときに使う。未確定要件の壁打ちや自分で実装する依頼では使わない。
他エージェントへのレビュー依頼、実装結果の受け入れ検証、レビュー結果の妥当性確認を求められたときに使う。PRレビューコメント対応や通常のセルフレビューでは使わない。
別のtmux paneで動いているAIエージェント（Claude Code / Codex / opencode等）へ指示やレビュー依頼を送信する、応答の完了を待って回収する、他paneのエージェントの出力や作業ログを読む、レビュー往復ループを回すときに使う。「%Nのpaneに送って」「隣のpaneのCodexにレビューを依頼して」「あのpaneが終わったら続きをやって」「右のpaneの作業を読んでまとめて」のような依頼で発動する。送る文面の作成自体（レビュー依頼文・handoffプロンプト）では使わず、agent-review-request / agent-handoff-plan に任せる。tmuxを介さないsubagent起動や並列化にも使わない。
Claude Code の /compact 前に、セッション状態の checkpoint を手動で保存するときに使う。「/compact-state」「compact 前に状態を保存して」「checkpoint を保存して」と依頼されたときに発動する。圧縮後の復旧作業、通常の進捗報告、plan 作成では使わない。
調査・監査・技術選定比較・性能検証・実装結果について、ユーザーが「結果をHTMLで読みやすく整理して」「HTMLの説明資料・レポートとして残して」のように、後から読み返せる静的HTML成果物を求めたときに使う。説明を補助する表、限定的な図解・定量グラフ・折りたたみ・定型指摘フィルタにも対応する。内容の調査・整理を伴わないHTML断片への変換、UI案や配色の比較モック、スライド、単体の探索的グラフ、任意JavaScriptを要する対話ツールには使わない。
| name | detect-code-duplication |
| description | similarity-ts を使って TypeScript/JavaScript の重複コードを検知し、優先度付きのリファクタリング計画を作成する。ユーザーが「重複を検出したい」「類似コードを整理したい」「リファクタリング計画を作りたい」と依頼したときに使う。 |
重複コード検知を再現可能な手順で実行し、z-ai/plans/active/ に優先度付きの計画を出力する。
生ログは z-ai/tmp/duplication/runs/<run-id>/ に保存し、計画書と分離する。
z-ai/tmp/duplication/runs/<run-id>/similarity-report.txtz-ai/tmp/duplication/runs/<run-id>/scan-meta.envz-ai/plans/active/refactor-duplications-<run-id>.mdz-ai/plans/completed/z-ai/plans/cancelled/mkdir -p で出力先を作成する。active: 新規作成または進行中の計画completed: 実施完了した計画cancelled: 中止した計画状態変更はファイル内容の編集よりも、ディレクトリ移動を優先する。
similarity-ts の有無を確認する。mise がある場合: mise use -g cargo:similarity-ts@latestmise がない場合: cargo install similarity-tsscripts/run_scan.sh [target_path] を実行する。--threshold 0.60 相当（環境変数 SIMILARITY_THRESHOLD で上書き可）ts,tsx,js,jsx3node_modules, dist, build, coverage, .git, z-ai/tmptarget_path で直接指定した場合もエラー終了する。SIMILARITY_ALLOW_EXCLUDED_TARGET=1 を指定する。REPORT_PATH と PLAN_PATH を控える。REPORT_PATH を読み、重複候補を優先度分類する。references/priority-policy.md を使う。references/plan-template.md を元に PLAN_PATH へ計画を書く。active/ のまま管理する。状態: completed に更新して同名ファイルを completed/ へ移動する。状態: cancelled に更新して同名ファイルを cancelled/ へ移動する。REPORT_PATHPLAN_PATHscripts/run_scan.sh: スキャン実行、出力先作成、パス通知を行う。references/priority-policy.md: 優先度判定基準の詳細。references/plan-template.md: 計画書テンプレート。