SuperClaude Enhancer Skill - 增强层

SuperClaude Enhancer Skill - 增强层

1. Purpose

为 AI 代码工厂的其他 Skills 提供 SuperClaude 能力增强，实现:

• 前置分析: 在代码生成前进行深度分析
• 后置审查: 在代码生成后进行质量审查
• 智能建议: 提供优化建议和最佳实践
• 问题诊断: 快速定位和解决问题
• 技术研究: 调研技术方案和模式

2. Enhancement Architecture

┌─────────────────────────────────────────────────────────────────────┐
│                    SuperClaude Enhancement Layer                     │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  ┌────────────────┐   ┌────────────────┐   ┌────────────────┐       │
│  │  Pre-Analysis  │   │  Post-Review   │   │ Smart-Suggest  │       │
│  │  (/​sc:analyze) │   │  (/​sc:analyze) │   │  (/​sc:improve) │       │
│  │  (/​sc:research)│   │  (/​sot-check)  │   │  (/​sc:design)  │       │
│  └───────┬────────┘   └───────┬────────┘   └───────┬────────┘       │
│          │                    │                    │                 │
│          ▼                    ▼                    ▼                 │
│  ┌───────────────────────────────────────────────────────────┐      │
│  │                  Enhancement Hooks API                     │      │
│  │  enhance_before() | enhance_after() | suggest() | diagnose()│     │
│  └───────────────────────────────────────────────────────────┘      │
│                              │                                       │
└──────────────────────────────┼───────────────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────────────┐
│                     Original Skills Layer                            │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐ │
│  │ ai-ad-be-gen│  │ai-ad-fe-gen │  │ai-ad-test-gen│ │ doc-auditor │ │
│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘ │
└─────────────────────────────────────────────────────────────────────┘

3. Enhancement Modes

3.1 Pre-Analysis (前置分析)

在 Skill 执行前调用，提供上下文分析。

interface PreAnalysisInput {
  mode: "pre_analysis";
  task: string;                    // 任务描述
  target_files: string[];          // 目标文件
  analysis_type: "code" | "design" | "research";
}

interface PreAnalysisOutput {
  insights: string[];              // 分析洞察
  recommendations: string[];       // 建议
  risks: string[];                 // 潜在风险
  context_enrichment: {            // 上下文增强
    patterns_found: string[];      // 发现的模式
    dependencies: string[];        // 识别的依赖
    constraints: string[];         // 约束条件
  };
}

触发 SuperClaude 命令:

• /​sc:analyze - 代码质量分析
• /​sc:research - 技术调研
• /​sc:explain - 概念解释

3.2 Post-Review (后置审查)

在 Skill 执行后调用，审查生成的代码。

interface PostReviewInput {
  mode: "post_review";
  generated_code: Record<string, string>;  // 生成的代码
  sot_refs: string[];                       // SoT 引用
  review_focus: ("quality" | "security" | "performance" | "sot_compliance")[];
}

interface PostReviewOutput {
  passed: boolean;
  issues: {
    severity: "error" | "warning" | "info";
    file: string;
    line?: number;
    message: string;
    suggestion?: string;
  }[];
  quality_score: number;           // 0-100
  sot_compliance: boolean;
  recommendations: string[];
}

触发 SuperClaude 命令:

• /​sc:analyze - 代码审查
• /​sot-check - SoT 合规检查

3.3 Smart-Suggest (智能建议)

提供优化建议和最佳实践。

interface SmartSuggestInput {
  mode: "smart_suggest";
  code: Record<string, string>;
  suggest_type: "refactor" | "optimize" | "pattern" | "test";
}

interface SmartSuggestOutput {
  suggestions: {
    type: string;
    description: string;
    before: string;
    after: string;
    benefit: string;
  }[];
  best_practices: string[];
  patterns_recommended: string[];
}

触发 SuperClaude 命令:

• /​sc:improve - 代码改进
• /​sc:design - 设计建议

3.4 Troubleshoot (问题诊断)

快速定位和解决问题。

interface TroubleshootInput {
  mode: "troubleshoot";
  error_message: string;
  context: {
    file: string;
    code_snippet: string;
    stack_trace?: string;
  };
}

interface TroubleshootOutput {
  root_cause: string;
  explanation: string;
  fix_steps: string[];
  prevention: string[];
}

触发 SuperClaude 命令:

• /​sc:troubleshoot - 问题诊断
• /​sc:explain - 解释错误

4. Hook Integration API

4.1 在 Skill Prompt 中集成

其他 Skills 可以在 Prompt 中调用增强 Hook：

<ENHANCEMENT_HOOKS>
<!-- 前置分析 Hook -->
<HOOK type="pre_analysis" enabled="{{ENABLE_ENHANCEMENT}}">
  <TRIGGER>开始生成代码前</​TRIGGER>
  <ACTION>
    调用 /​sc:analyze 分析现有代码
    调用 /​sc:research 调研最佳实践
  </​ACTION>
  <OUTPUT>
    将分析结果添加到 CONTEXT 中
  </​OUTPUT>
</​HOOK>

<!-- 后置审查 Hook -->
<HOOK type="post_review" enabled="{{ENABLE_ENHANCEMENT}}">
  <TRIGGER>代码生成完成后</​TRIGGER>
  <ACTION>
    调用 /​sc:analyze 审查生成的代码
    调用 /​sot-check 验证 SoT 合规
  </​ACTION>
  <OUTPUT>
    如果发现问题，返回修正建议
    如果通过，添加质量评分
  </​OUTPUT>
</​HOOK>
</​ENHANCEMENT_HOOKS>

4.2 条件启用

增强可以根据任务复杂度条件启用：

enhancement_rules:
  # 总是启用
  always_on:
    - post_review.sot_compliance

  # 复杂任务启用
  complex_tasks:
    triggers:
      - task_contains: ["重构", "架构", "设计"]
      - files_count: "> 3"
      - involves_state_machine: true
    enable:
      - pre_analysis
      - smart_suggest

  # Bug 修复启用
  bugfix:
    triggers:
      - task_contains: ["修复", "bug", "问题", "错误"]
    enable:
      - troubleshoot
      - post_review

5. Integration Examples

5.1 BE-Gen + SuperClaude Enhancement

<SKILL name="ai-ad-be-gen" enhanced="true">
<ENHANCEMENT>
  <!-- Phase 0: Pre-Analysis -->
  <PHASE id="pre" type="pre_analysis">
    <INSTRUCTION>
    在生成代码前，先执行 SuperClaude 分析：
    1. 使用 /​sc:analyze 分析目标文件的现有代码
    2. 识别现有的代码模式和约定
    3. 检查是否有可复用的组件
    4. 将分析结果添加到上下文
    </​INSTRUCTION>
  </​PHASE>

  <!-- Phase 1-4: Original BE-Gen Logic -->
  <!-- ... -->

  <!-- Phase 5: Post-Review -->
  <PHASE id="post" type="post_review">
    <INSTRUCTION>
    代码生成后，执行 SuperClaude 审查：
    1. 使用 /​sc:analyze 检查代码质量
       - 代码风格一致性
       - 潜在 Bug
       - 性能问题
       - 安全漏洞
    2. 使用 /​sot-check 验证 SoT 合规
    3. 如果发现 P0 问题，返回修正建议
    4. 添加质量评分到输出
    </​INSTRUCTION>
  </​PHASE>
</​ENHANCEMENT>
</​SKILL>

5.2 Test-Gen + SuperClaude Enhancement

<SKILL name="ai-ad-test-gen" enhanced="true">
<ENHANCEMENT>
  <!-- Pre: 分析被测代码 -->
  <PHASE id="pre" type="pre_analysis">
    <INSTRUCTION>
    1. 使用 /​sc:analyze 深度分析被测代码
       - 识别所有分支和边界条件
       - 识别隐式依赖
       - 识别潜在的边缘情况
    2. 使用 /​sc:research 查找测试最佳实践
    3. 将分析结果用于测试用例设计
    </​INSTRUCTION>
  </​PHASE>

  <!-- Post: 验证测试覆盖 -->
  <PHASE id="post" type="post_review">
    <INSTRUCTION>
    1. 使用 /​sc:analyze 检查测试质量
       - 测试是否覆盖所有分支
       - 断言是否充分
       - Mock 是否正确
    2. 建议补充的测试场景
    </​INSTRUCTION>
  </​PHASE>
</​ENHANCEMENT>
</​SKILL>

5.3 Doc-Agent + SuperClaude Enhancement

<SKILL name="doc-agent" enhanced="true">
<ENHANCEMENT>
  <!-- Pre: 文档分析 -->
  <PHASE id="pre" type="pre_analysis">
    <INSTRUCTION>
    1. 使用 /​sc:analyze 分析文档结构
    2. 使用 /​sc:research 查找文档最佳实践
    </​INSTRUCTION>
  </​PHASE>

  <!-- Post: 文档质量检查 -->
  <PHASE id="post" type="post_review">
    <INSTRUCTION>
    1. 使用 /​sc:analyze 检查文档质量
       - 完整性
       - 一致性
       - 可读性
    2. 使用 /​sc:document 生成缺失部分
    </​INSTRUCTION>
  </​PHASE>
</​ENHANCEMENT>
</​SKILL>

6. Output Format

增强后的 Skill 输出格式：

{
  "success": true,
  "data": {
    "changes": [...],
    "notes": [...],
    "sot_refs": [...]
  },
  "enhancement": {
    "pre_analysis": {
      "executed": true,
      "insights": ["发现现有代码使用了 Repository 模式", "..."],
      "recommendations": ["建议复用 BaseRepository", "..."]
    },
    "post_review": {
      "executed": true,
      "passed": true,
      "quality_score": 85,
      "issues": [],
      "sot_compliance": true
    }
  }
}

7. Configuration

7.1 全局配置

在 .claude/​WORKFLOW_TEMPLATES.md 或 settings.local.json 中配置：

{
  "superclaude_enhancement": {
    "enabled": true,
    "default_modes": ["post_review"],
    "complex_task_modes": ["pre_analysis", "post_review", "smart_suggest"],
    "quality_threshold": 70,
    "auto_fix": false
  }
}

7.2 Skill 级配置

在各 Skill 的 front matter 中配置：

enhancement:
  enabled: true
  modes:
    - pre_analysis
    - post_review
  config:
    pre_analysis:
      commands: ["/​sc:analyze", "/​sc:research"]
    post_review:
      commands: ["/​sc:analyze", "/​sot-check"]
      quality_threshold: 80

8. Usage Guide

8.1 自动增强 (推荐)

使用 /​dev-flow 命令自动启用增强：

# 自动包含 SuperClaude 增强
/​dev-flow feature 实现充值审批功能

8.2 手动增强

在任务描述中指定增强模式：

# 显式启用增强 (v2.4 命令)
/​gen be 实现充值审批 --enhance=pre,post

# 显式禁用增强 (v2.4 命令)
/​gen be 简单修改 --no-enhance

8.3 增强 Hook 示例

# 在 Agent 执行流程中
class EnhancedBEAgent:
    def execute(self, task: str, files: list):
        # Phase 0: SuperClaude Pre-Analysis
        if self.enhancement_enabled("pre_analysis"):
            analysis = self.enhance_before(task, files)
            self.context.update(analysis)

        # Phase 1-4: Original Generation
        result = self.generate_code(task, files)

        # Phase 5: SuperClaude Post-Review
        if self.enhancement_enabled("post_review"):
            review = self.enhance_after(result)
            if not review.passed:
                result = self.apply_fixes(result, review.issues)

        return result

9. Self-Check

10. Version History

---

文档控制: Owner: wade | Baseline: SUPERCLAUDE_INTEGRATION_GUIDE v1.0