메뉴
コードレビュー結果、code quality report、git diff、PR 差分、指定ファイルをもとに、挙動を変えずにコードを簡略化・リファクタリングするためのスキル。可読性、保守性、テスト容易性、複雑度、効率性、技術的負債の指摘を実装に反映し、変更範囲と検証結果を簡潔に報告するときに使う。ユーザーが quality report や code-quality-review の結果をもとに改善してほしいと言った場合も使う。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/version-1/agents-docs --skill code-refactor명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
Git リポジトリで新しい作業を始める前に、最新のデフォルトブランチへ追従し、タスク内容に合う作業ブランチを作成して、不要なローカルブランチ整理を非同期に依頼するときに使う。ユーザーが「ブランチ切って」「作業を始める準備して」「新しいタスク用ブランチを作って」「最新 main から始めたい」などを依頼した場合はこの skill を使い、ブランチ名を報告してからタスク詳細の入力を待つ。
Issue Finder agent がコードベースを変更せず、指定された finder 分野の課題を根拠付きで調査し、優先順位付けした Markdown を指定ディレクトリへ出力するときの共通手順、安全制約、品質基準、出力 contract を定義する。
コード、設定、依存関係、権限境界にある悪用可能な脆弱性を安全に調査し、コードを変更せず課題レポートへ整理するため issue-finder agent に委譲するときに使う。一般的なコードレビュー、侵入や攻撃の実行、脆弱性修正には使わない。
SOC 직업 분류 기준
SKILL.md 표시 중
| name | code-refactor |
| description | コードレビュー結果、code quality report、git diff、PR 差分、指定ファイルをもとに、挙動を変えずにコードを簡略化・リファクタリングするためのスキル。可読性、保守性、テスト容易性、複雑度、効率性、技術的負債の指摘を実装に反映し、変更範囲と検証結果を簡潔に報告するときに使う。ユーザーが quality report や code-quality-review の結果をもとに改善してほしいと言った場合も使う。 |
レビュー指摘や既存差分を起点に、挙動を維持したままコードを簡略化する。 読みやすさ、変更しやすさ、テストしやすさを上げることを優先し、必要以上に大きな設計変更は避ける。 code quality report がある場合は、品質上の findings と quality gate をリファクタリング対象の優先順位として扱う。 レビュー指摘がない場合は、可読性、保守性、テスト容易性、複雑度、効率性の観点で指摘を抽出し、反映する。
次のいずれかを受け取る。
git diff、gh pr diff、コミットハッシュなどの差分入力が曖昧で変更範囲を安全に決められない場合だけ、最小限の質問をする。
code-next-developer-review , code-quality-review のスキルごとにサブエージェントを起動して、レビューを集めるリファクタでは、次の分類のいずれかを必ず使う。1 つの変更に複数カテゴリが当てはまる場合は、主目的のカテゴリを 1 つ選び、補助的なカテゴリを必要に応じて併記する。
| カテゴリ | 内容 | 詳細 |
|---|---|---|
Simplify | 複雑さを減らす | references/simplify.md |
Split | 責務を分割する | references/split.md |
Extract | 共通化・切り出し | references/extract.md |
Inline | 過剰な抽象化を戻す | references/inline.md |
Rename | 名前を改善する | references/rename.md |
Move | 適切な場所へ移動する | references/move.md |
Encapsulate | 隠蔽する | references/encapsulate.md |
Generalize | 共通化・抽象化する | references/generalize.md |
Specialize | 抽象化をやめる | references/specialize.md |
Replace | より良い実装へ置き換える | references/replace.md |
Remove | 不要なものを削除する | references/remove.md |
Reorganize | 構造を整理する | references/reorganize.md |
最終報告は次の順で簡潔に書く。実施したリファクタは分類ごとにまとめ、未使用カテゴリは書かない。
変更した内容:
...
リファクタ分類:
- Simplify: 早期 return に変更し、ネストを 1 段減らした。
- Extract: 重複していた日付変換を小さな関数に切り出した。
- Rename: 責務が伝わるように一時変数名を変更した。
検証:
...