Skip to content
cccskills
FreePublished on GitHub

refactor-advisor

ローカルの差分・ファイルから、機能要件とは別のリファクタリング案を提示する。変更を適用する依頼は実装Skillを使い、レビューの完了阻害判定はreviewerを使う。

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md4.3 KB
  • references/refactor-guidance.md5.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Refactor Advisor:リファクタリング提案

対象の差分を読み、機能要件や受入条件を変えない改善候補を提示します。委任する場合は、親がreferences/refactor-guidance.mdの実体絶対pathを実行者へ渡し、実行者が自身で専門基準をReadします。親が直接確認する場合は、親自身がそのreferenceをReadします。必要なら現在のランタイムの委譲primitiveを使いますが、担当数や起動方式を固定しません。

対象範囲: $ARGUMENTS

提案は任意の補助情報であり、レビューのVERDICT、実装、テストの完了条件に自動で混ぜません。重大度は code-review-guidance/references/result-contract.md の P0–P3 を使い、提案は P2・P3 に限ります。P0/P1 相当を提案へ紛れ込ませず、見つけた場合は担当外の重要事項として親へ重大度を保持して返します。適用する場合は、ユーザーまたは親が候補を選び、対象リスクに応じて別の実装・レビュー・テストを計画します。


ステップ 0: 実行コンテキストの確認

対象repoと現在のstatus/diffを確認する。成果物を保存する場合だけ、親またはruntimeが提示した実在のRUN_DIR/REPORT_PATHを使う。特定runtimeのhome、memory配置、パス正規化を推測しない。


ステップ 1: 対象範囲の特定

$ARGUMENTS に応じて対象を決定する:

  • 指定なし: git status --porcelain からstaged・unstaged・untrackedを含む未コミット変更を取得
  • ファイルパス: 指定されたファイルをそのまま対象とする
  • ブランチ名: repoとremote/refを確認してから、明示したbase/headの差分を取得
  • コミット範囲(例: HEAD~3..HEAD): git diff --name-only <range> で差分を取得

対象ファイルが 0 件の場合はユーザーに「対象がないため refactor-advisor は起動しません」と報告して終了する(提案ゼロ件の起動は無駄なので)。


ステップ 2: 提案の作成

親が対象差分、要件、既存パターンを照合し、必要なら現在のruntimeの委譲primitiveへ、目的、対象、禁止範囲、根拠、返却事項、references/refactor-guidance.mdの実体pathを渡す。委譲できない場合は親が同じ観点で確認する。担当数、model、再実行回数、専用のplan/reportを固定しない。

提案には、対象箇所、改善内容、期待する利点、機能退行・移行リスク、既存実装との根拠を含める。3箇所以上の重複、既存helper・標準library、既存pattern、今回追加された抽象、説明文との整合、構造投資領域の対称性を必要に応じて確認する。存在しない計画、path、判定を補完しない。


ステップ 3: 結果の提示

実際に作成した提案と、保存した場合だけ実在する成果物をユーザーに提示する。提案が不要、対象がない、または利用可能な情報が不足する場合は、その事実と理由を示す。

ユーザーへの提示フォーマット

## リファクタリング提案

### PROPOSALS
[N]件(P2: M件 / P3: L件)。ここではVERDICTを返さない。

### 書き出し先
[保存した場合だけ実在するパス]

### 提案一覧(要約)
- [P2|P3] `ファイル:行`:[タイトル](根拠:既存先例または制約を満たす要点を1行)
...

### 除外した候補
[実際に除外した候補と理由。なければ none]

提案がない場合はPROPOSALS: 0件とし、対象と確認範囲を示す。未生成のレポートや提案数を作らない。

適用はユーザーまたは親が候補を選んで明示した場合だけ行う。適用する場合は、変更された挙動に必要な review/test を別途選び、機能要件を広げない。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

別AIのCLI呼び出しを支援する。Codex以外のCLIを使う依頼で使う。 Codexへの相談・実装委譲は codex Skill を使う。Skill運用の移行は agent-skill-migrate、配置監査は overlay-audit を使う。

The English summary is being prepared. Showing the original description.

coil398/dotfiles8Updated Oct 21, 2026

明示されたCodex・CursorのSkill運用移行を、指定設計と既存点検に基づき適用する。一般的な指示ファイルの整理は instruction-refactor を使う。通常の実装依頼では起動しない。

The English summary is being prepared. Showing the original description.

coil398/dotfiles8Updated Oct 21, 2026

明示されたリポジトリのSkill・Agent・呼出し・生成配布を点検または移行する。通常の実装・レビュー・調査では起動しない。一般的な指示ファイルの整理は instruction-refactor を使う。

The English summary is being prepared. Showing the original description.

coil398/dotfiles8Updated Oct 21, 2026

プロジェクトのデザインシステムを SSOT として作成・監査・更新する。トークン、デザインシステムに関わるアクセシビリティ、Typography、Motion、aesthetic direction の作業に使う。デザインシステムに紐づかない単発UI実装や個別デザインレビューには使わない。

The English summary is being prepared. Showing the original description.

coil398/dotfiles8Updated Oct 21, 2026

デザインシステムの作成・監査・保守、デザイントークンやUIの一貫性・個性・アクセシビリティの改善に使う。

The English summary is being prepared. Showing the original description.

coil398/dotfiles8Updated Oct 21, 2026

AIに日記を書かせるスキル。会話を振り返り、AI視点の自由な日記風テキストを生成して保存する。「日記書いて」「AI日記」「日記風に振り返って」「感想を日記にして」「diary」「write a diary」といった日記・感想の依頼に使う。作業改善の振り返りは /retro、知見の記録や要約は /ai-ltm を使う。

The English summary is being prepared. Showing the original description.

coil398/dotfiles8Updated Oct 21, 2026

See all skills by coil398

Report a problem with this skill