菜单
コードレビュー結果、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: 責務が伝わるように一時変数名を変更した。
検証:
...