sc-improve

コード改善とクリーンアップのスキル

複数のペルソナの専門知識と安全性の検証を活用した、体系的な改善です。

クイックスタート

# Quality improvement
/sc:improve src/ --type quality --safe

# Performance optimization
/sc:improve api-endpoints --type performance

# Dead code cleanup
/sc:improve src/ --cleanup --type code --safe

# Import optimization
/sc:improve --cleanup --type imports

動作の流れ

1. 分析 - コードベースを調べ、改善の機会を見つけます
2. 計画 - アプローチを選択し、関連するペルソナを有効にします
3. 実行 - 体系的な改善を適用します
4. 検証 - 機能が維持されていることを確認します
5. 記録 - 改善の概要を生成します

フラグ

フラグ	型	デフォルト	説明
--type	string	quality	quality、performance、maintainability、style、principles、code、imports、files、all
--cleanup	bool	false	クリーンアップモードを有効にします
--safe	bool	true	安全性を検証しながら慎重に実行します
--aggressive	bool	false	徹底的なクリーンアップを行います（注意して使用してください）
--preview	bool	false	適用せずに変更内容を表示します
--interactive	bool	false	ガイド付きの意思決定モードです

有効化されるペルソナ

• architect - 構造と設計の改善
• performance - 最適化の専門知識
• quality - コード品質と保守性
• security - セキュリティパターンの適用
• code-warden - KISS と純粋性の徹底（--type principles の場合）

MCP 統合

PAL MCP（検証と分析）

ツール	使用する場面	目的
mcp__pal__consensus	複雑なリファクタリング	大規模な変更を行う前に、複数モデルで検証します
mcp__pal__codereview	品質評価	改善の品質と安全性をレビューします
mcp__pal__thinkdeep	アーキテクチャの変更	構造改善を詳細に分析します
mcp__pal__precommit	コミット前	すべての変更で機能が維持されていることを検証します
mcp__pal__debug	リグレッションの問題	改善によって問題が発生した場合に根本原因を分析します
mcp__pal__challenge	積極的なモード	積極的なクリーンアップの判断を批判的に評価します

PAL の使用パターン

# Consensus for major refactor
mcp__pal__consensus(
    models=[
        {"model": "gpt-5.2", "stance": "for"},
        {"model": "gemini-3-pro", "stance": "against"}
    ],
    step="Evaluate: Should we extract this into a separate module?"
)

# Review after improvements
mcp__pal__codereview(
    review_type="full",
    step="Reviewing code improvements",
    findings="Quality, maintainability, backwards compatibility",
    relevant_files=["/src/refactored/module.py"]
)

# Pre-commit validation
mcp__pal__precommit(
    path="/path/to/repo",
    step="Validating refactoring changes",
    confidence="high"
)

Rube MCP（自動化と追跡）

ツール	使用する場面	目的
mcp__rube__RUBE_SEARCH_TOOLS	外部ツール	リンター、フォーマッター、アナライザーを探します
mcp__rube__RUBE_MULTI_EXECUTE_TOOL	通知	チケットを更新し、チームに通知します
mcp__rube__RUBE_CREATE_UPDATE_RECIPE	再利用可能なワークフロー	改善パターンを保存します

Rube の使用パターン

# Notify team of improvements
mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
    {"tool_slug": "SLACK_SEND_MESSAGE", "arguments": {
        "channel": "#refactoring",
        "text": "Completed: Dead code cleanup removed 500 lines"
    }},
    {"tool_slug": "JIRA_UPDATE_ISSUE", "arguments": {
        "issue_key": "TECH-456",
        "status": "Done"
    }}
])

# Create improvement report in Notion
mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
    {"tool_slug": "NOTION_CREATE_PAGE", "arguments": {
        "title": "Refactoring Report - Q4 2025",
        "content": "## Summary\n- Lines removed: 500\n- Complexity reduced: 25%"
    }}
])

エビデンス要件

このスキルではエビデンスが必要です。必ず次のことを行ってください。

• 変更前と変更後のコードを比較して示す
• 機能が維持されていることを確認するためにテストを実行する
• 指標を報告する（削除した行数、複雑度の削減量）

改善の種類

品質（--type quality）

• 技術的負債の削減
• コード構造の改善
• 可読性の向上

パフォーマンス（--type performance）

• ボトルネックの解消
• アルゴリズムの最適化
• リソース効率の向上

保守性（--type maintainability）

• 複雑度の削減
• ドキュメントの改善
• モジュール構成の再編成

スタイル（--type style）

• フォーマットの一貫性
• 命名規則
• パターンの統一

原則（--type principles）

• KISS 準拠の改善（複雑さを減らし、メソッドを抽出する）
• 純粋性の徹底（I/O とロジックを分離する）
• ガード節へのリファクタリング（ネストを減らす）
• 関数型コアの抽出（I/O をシェル層に移す）

バリデーター：

# Run KISS validation
python .claude/skills/sc-principles/scripts/validate_kiss.py --scope-root . --json

# Run Purity validation
python .claude/skills/sc-principles/scripts/validate_purity.py --scope-root . --json

クリーンアップモード（--cleanup）

コードのクリーンアップ（--type code）

• デッドコードを検出して削除します
• 未使用の変数を削除します
• 到達不能なコードを削除します

インポートのクリーンアップ（--type imports）

• 未使用のインポートを削除します
• インポートを整理します
• 依存関係を最適化します

ファイルのクリーンアップ（--type files）

• 空のファイルを削除します
• 孤立したファイルを検出します
• 構成を最適化します

全体のクリーンアップ（--type all）

• 包括的なクリーンアップ
• すべてのカテゴリを統合
• 複数のペルソナが連携

安全モード

セーフモード（--safe）

• 慎重な変更のみを行います
• 自動的に安全性を検証します
• すべての機能を維持します

Aggressive Mode (--aggressive)

• Thorough cleanup
• Framework-aware patterns
• Requires careful review

Examples

Safe Quality Improvement

/sc:improve src/ --type quality --safe
# Technical debt reduction with safety validation

Performance Optimization

/sc:improve api-endpoints --type performance --interactive
# Guided optimization with profiling analysis

Dead Code Cleanup

/sc:improve src/ --cleanup --type code --safe
# Remove unused code with dependency validation

Preview Changes

/sc:improve --cleanup --type imports --preview
# Show what would be removed without executing

Tool Coordination

• Read/Grep/Glob - Code analysis
• Edit/MultiEdit - Safe modifications
• TodoWrite - Progress tracking
• Task - Large-scale improvement delegation