ED

ertugrul-dmr/clean-code-skills

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

212 stars 质量 50 趋势 19MIT

ertugrul-dmr/clean-code-skills 是从 https://github.com/ertugrul-dmr/clean-code-skills. 导入的代理技能候选

概览

ertugrul-dmr/clean-code-skills 是从 https://github.com/ertugrul-dmr/clean-code-skills. 导入的代理技能候选

概述(AI 翻译)

教你的AI写出不烂的代码。

该仓库包含执行Robert C. MartinClean Code原则的Agent Skills。它们可使用Google Antigravity、Anthropic的Claude Code以及任何支持Agent Skills标准的agent。

为什么?

人工智能生成代码的速度很快,但研究显示它也很快产生技术债务:

  • GitClear:AI采用后代码重复增加4倍
  • 卡内基梅隆:+30%静态分析警告,+41% 光标采用后代码复杂度
  • 谷歌DORA:AI采用与软件交付稳定性之间的负相关

这些技能将经过实战考验的解决方案直接编码进你的AI工作流程中。

包含内容

田径 技能 描述 规则
Python boy-scout 编排者——总是让代码比你来时更干净 坐标所有技能
蟒 python-clean-code **掌握全部66条规则的大师技能 C1-C5,E1-E2,F1-F4,G1-G36,N1-N7,P1-P3,T1-T9
Python clean-comments 简约而准确的注释 C1-C5
Python clean-functions 小巧、聚焦、明显的功能 F1-F4

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Clean Code Skills for AI Agents

Teach your AI to write code that doesn’t suck.

This repository contains Agent Skills that enforce Robert C. Martin’s Clean Code principles. They work with Google Antigravity, Anthropic’s Claude Code, and any agent that supports the Agent Skills standard.

Why?

AI generates code fast, but research shows it also generates technical debt fast:

  • GitClear: 4x increase in code duplication with AI adoption
  • Carnegie Mellon: +30% static analysis warnings, +41% code complexity after Cursor adoption
  • Google DORA: Negative relationship between AI adoption and software delivery stability

These skills encode battle-tested solutions to exactly these problems—directly into your AI workflow.

What’s Included

Track Skill Description Rules
Python boy-scout Orchestrator—always leave code cleaner than you found it Coordinates all skills
Python python-clean-code Master skill with all 66 rules C1-C5, E1-E2, F1-F4, G1-G36, N1-N7, P1-P3, T1-T9
Python clean-comments Minimal, accurate commenting C1-C5
Python clean-functions Small, focused, obvious functions F1-F4
Python clean-general Core principles (DRY, single responsibility) G5, G16, G23, G25, G30, G36
Python clean-names Descriptive, unambiguous naming N1-N7
Python clean-tests Fast, thorough, boundary-aware tests T1-T9
TypeScript boy-scout Orchestrator—always leave code cleaner than you found it Coordinates all skills
TypeScript typescript-clean-code Master skill with all 66 rules C1-C5, E1-E2, F1-F4, G1-G36, N1-N7, TS1-TS3, T1-T9
TypeScript clean-comments Minimal, accurate commenting C1-C5
TypeScript clean-functions Small, focused, obvious functions F1-F4
TypeScript clean-general Core principles (DRY, single responsibility) G5, G16, G23, G25, G30, G36
TypeScript clean-names Descriptive, unambiguous naming N1-N7
TypeScript clean-tests Fast, thorough, boundary-aware tests T1-T9

Use the master skill for comprehensive coverage, or individual skills for targeted enforcement.

Choose Your Language

Pick one track and copy only that track’s skills:

[!WARNING] Install only one language track per skills directory. Python and TypeScript tracks reuse the same skill names (boy-scout, clean-functions, etc.). Installing both together can make the agent load conflicting instructions and behave inconsistently.

# Python track
cp -r skills/python/* /

# TypeScript track
cp -r skills/typescript/* /

The Boy Scout Rule

在 GitHub 查看完整 README

推荐工具

换一个关键词,或者移除筛选条件。

安装

npx skillfish add ertugrul-dmr/clean-code-skills
新手?先看 mcpskill.org 教程 →