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 移至 shell 层）

验证器：

# 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