superclaude-enhancer

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

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

```

┌─────────────────────────────────────────────────────────────────────┐

│ 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.1 Pre-Analysis (前置分析)

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

```typescript

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 执行后调用，审查生成的代码。

```typescript

interface PostReviewInput {

mode: "post_review";

generated_code: Record; // 生成的代码

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 (智能建议)

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

```typescript

interface SmartSuggestInput {

mode: "smart_suggest";

code: Record;

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 (问题诊断)

快速定位和解决问题。

```typescript

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.1 在 Skill Prompt 中集成

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

```xml

开始生成代码前

调用 /sc:analyze 分析现有代码

调用 /sc:research 调研最佳实践

将分析结果添加到 CONTEXT 中

代码生成完成后

调用 /sc:analyze 审查生成的代码

调用 /sot-check 验证 SoT 合规

如果发现问题，返回修正建议

如果通过，添加质量评分

```

4.2 条件启用

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

```yaml

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.1 BE-Gen + SuperClaude Enhancement

```xml

在生成代码前，先执行 SuperClaude 分析：

1. 使用 /sc:analyze 分析目标文件的现有代码

2. 识别现有的代码模式和约定

3. 检查是否有可复用的组件

4. 将分析结果添加到上下文

代码生成后，执行 SuperClaude 审查：

1. 使用 /sc:analyze 检查代码质量

- 代码风格一致性

- 潜在 Bug

- 性能问题

- 安全漏洞

2. 使用 /sot-check 验证 SoT 合规

3. 如果发现 P0 问题，返回修正建议

4. 添加质量评分到输出

```

5.2 Test-Gen + SuperClaude Enhancement

```xml

1. 使用 /sc:analyze 深度分析被测代码

- 识别所有分支和边界条件

- 识别隐式依赖

- 识别潜在的边缘情况

2. 使用 /sc:research 查找测试最佳实践

3. 将分析结果用于测试用例设计

1. 使用 /sc:analyze 检查测试质量

- 测试是否覆盖所有分支

- 断言是否充分

- Mock 是否正确

2. 建议补充的测试场景

```

5.3 Doc-Agent + SuperClaude Enhancement

```xml

1. 使用 /sc:analyze 分析文档结构

2. 使用 /sc:research 查找文档最佳实践

1. 使用 /sc:analyze 检查文档质量

- 完整性

- 一致性

- 可读性

2. 使用 /sc:document 生成缺失部分

```

增强后的 Skill 输出格式：

```json

{

"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.1 全局配置

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

```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 中配置：

```yaml

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.1 自动增强 (推荐)

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

```bash

# 自动包含 SuperClaude 增强

/dev-flow feature 实现充值审批功能

```

8.2 手动增强

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

```bash

# 显式启用增强 (v2.4 命令)

/gen be 实现充值审批 --enhance=pre,post

# 显式禁用增强 (v2.4 命令)

/gen be 简单修改 --no-enhance

```

8.3 增强 Hook 示例

```python

# 在 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

```

| 检查项 | 验证方法 | P0/P1 |

|--------|---------|-------|

| Enhancement Hook 正确触发 | 检查输出中 enhancement 字段 | P0 |

| SuperClaude 命令正确调用 | 检查日志 | P1 |

| 质量评分计算正确 | 对比人工审查 | P1 |

| SoT 合规检查完整 | 交叉验证 /sot-check | P0 |

| 版本 | 日期 | 变更 |

|------|------|------|

| v1.0 | 2025-12-07 | 初始版本：定义增强架构和 Hook API |

---

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