AgentSkillsCN

vibe-coding

符合 LLM 可读性的代码标准:函数不超过 50 行,文件不超过 200 行,嵌套层次不超过 3 层。遵循 SRP、DRY、KISS 以及尽早返回的原则。

SKILL.md
--- frontmatter
name: vibe-coding
description: LLM-readable code standards. Functions ≤50 lines, files ≤200 lines, nesting ≤3 levels. SRP, DRY, KISS, Early Return.

SKILL: Vibe Coding (Code Quality Standards)

Purpose: Enforce LLM-readable code standards for maintainable code Target: Coder Agent during Green/Refactor phases

Quick Reference

TargetLimitAction
Function≤50 linesSplit functions
File≤200 linesExtract modules
Nesting≤3 levelsEarly return

Principles

  • SRP: One function = one responsibility
  • DRY: No duplicate code blocks, extract common logic
  • KISS: Simplest solution that works, avoid over-engineering
  • Early Return: Return early to reduce nesting, keep happy path at top
  • Self-Documenting Code: Names reveal intent, no unnecessary comments (see REFERENCE.md)
  • Single Abstraction Level: Functions operate at one conceptual level (see REFERENCE.md)
  • Principle of Least Surprise: Predictable behavior, no hidden side effects (see REFERENCE.md)

AI Rules

Enforce during ALL code generation:

  • Functions ≤50 lines, Files ≤200 lines, Nesting ≤3 levels
  • SRP, DRY, KISS, Early Return pattern

Further Reading

Internal: @.claude/skills/vibe-coding/REFERENCE.md - SOLID principles, refactoring patterns | @.claude/skills/tdd/SKILL.md - Red-Green-Refactor

External: Clean Code | Refactoring