fixing-rule-violations

oimiragieo 的头像作者 oimiragieo

提供详细的修复指令,用于编码规则违规。使用规则索引定位违规规则并提取修复模式。当代码违反规则或用户询问如何修复合规问题时使用。

📖 中文导读:提供详细的修复指令,用于编码规则违规。使用规则索引定位违规规则并提取修复模式。当代码违反规则或用户询问如何修复合规问题时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: fixing-rule-violations description: Provides detailed fix instructions for coding rule violations. Uses the rule index to locate violated rules and extract fix patterns. Use when code violates rules or when the user asks how to fix compliance issues. version: 1.0.0 allowed-tools: read, grep, glob, search, codebase_search, edit, write

Fixing Rule Violations - Provides actionable fix instructions for rule violations by locating violated rules in the index and extracting fix patterns. - Code violates a specific rule - User reports a compliance issue - Rule auditor identifies violations - User asks "How do I fix this rule violation?" - Code review finds standards violations

Step 1: Identify the Violation

Determine what rule was violated:

  • From rule-auditor: Violation report with rule name/path
  • From user: Description of the issue
  • From code: Analyze code to identify which rule applies

Step 2: Load Rule Index

Load the rule index to locate the violated rule:

  • @.claude/context/config/rule-index.json

Step 3: Find Violated Rule

Search the index for the violated rule:

  • By name: Search rules array for matching name
  • By path: If path is known, find rule with matching path
  • By technology: Query technology_map if rule type is known

Step 4: Load Rule File

Load the full rule file to get fix instructions:

  • Read the rule file from the path in the index
  • Extract sections related to the violation
  • Find fix patterns and examples

Step 5: Extract Fix Instructions

From the rule file, extract:

  • What's wrong: The violation pattern
  • Why it's wrong: Explanation from the rule
  • How to fix: Specific fix instructions
  • Example: Before/after code examples

See reference/fix-patterns.md for common fix patterns.

Step 6: Generate Fix Instructions

Provide actionable fix with:

  • Exact code changes: Show before/after
  • Step-by-step: Break down complex fixes
  • Context: Explain why the fix works
  • Verification: How to verify the fix
  1. Be Specific: Provide exact code changes, not vague suggestions
  2. Show Examples: Always include before/after code
  3. Explain Why: Help user understand the fix
  4. Step-by-Step: Break complex fixes into clear steps
  5. Verify: Include verification steps
**Output Format**

Structure fix instructions clearly:

## Fix for [Rule Name] Violation

**Violated Rule**: [rule name]
**Rule Path**: [path from index]
**Violation Location**: [file:line]

### The Problem

[Description of what's wrong]

### Why This Violates the Rule

[Explanation from rule file]

### How to Fix

**Step 1**: [Action]
\`\`\`[language]
[Code showing fix]
\`\`\`

**Step 2**: [Action]
\`\`\`[language]
[Code showing fix]
\`\`\`

### Before and After

**Before** (violates rule):
\`\`\`[language]
[violating code]
\`\`\`

**After** (compliant):
\`\`\`[language]
[fixed code]
\`\`\`

### Verification

[How to verify the fix works]
**Common Violation Types**:

TypeScript Violations:

  • Using any instead of proper types
  • Missing type annotations
  • Incorrect interface definitions

React/Next.js Violations:

  • Missing 'use client' directive
  • Using useEffect for data fetching
  • Not using Server Components when possible

Python Violations:

  • Missing type hints
  • Not using async/await properly
  • Incorrect error handling

Code Quality Violations:

  • Magic numbers
  • Unclear variable names
  • Missing error handling

For each type, see fix-patterns.md for standard fixes.