EastDong314/agent-skills

Revisão de código focada em excesso de engenharia. Encontre o que pode ser excluído: reinvenção da biblioteca padrão, dependências desnecessárias, abstrações especulativas, flexibilidade inútil. Uma linha por descoberta: local, o que cortar, o que substitui.

O que é agent-skills?

Este skill especializa-se em detectar complexidade desnecessária em revisões de código, funcionando como um complemento a revisões focadas em correção. Ele identifica quatro tipos principais de excesso: reinvenção da biblioteca padrão (stdlib), dependências redundantes (native), abstrações sem propósito real (yagni) e código que pode ser enxugado (shrink). Cada achado é reportado em uma única linha contendo localização no código, o que deve ser removido e a alternativa mais simples. Ao final da análise, o skill apresenta a métrica 'net: -<N> lines possible', que indica quantas linhas podem ser eliminadas. Se não houver nada a cortar, retorna simplesmente 'Lean already. Ship.'. O skill ignora bugs de segurança, erros de correção e problemas de desempenho — seu foco exclusivo é complexidade e over-engineering. É ativado por comandos como 'review for over-engineering' ou '/ponytail-review', e suporta reversão ao estilo normal de revisão com 'stop ponytail-review'.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EastDong314/agent-skills/tree/HEAD/skills/ponytail-review

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Revise diffs por complexidade desnecessária. Uma linha por descoberta: local, o que cortar, o que substitui. O melhor resultado para um diff é ficar mais curto.

Formato

L<linha>: <tag> <o que>. <substituto>., ou <arquivo>:L<linha>: ... para diffs com vários arquivos.

Tags:

  • delete: código morto, flexibilidade não usada, funcionalidade especulativa. Substituto: nada.
  • stdlib: algo feito à mão que a biblioteca padrão já oferece. Nomeie a função.
  • native: dependência ou código que faz o que a plataforma já oferece. Nomeie o recurso.
  • yagni: abstração com uma única implementação, configuração que ninguém define, camada com um único chamador.
  • shrink: mesma lógica, menos linhas. Mostre a forma mais curta.

Exemplos

❌ "Esta classe EmailValidator pode ser mais complexa do que o necessário; você considerou se todas essas regras de validação são necessárias neste estágio?"

✅ L12-38: stdlib: classe validadora de 27 linhas. "@" no email, 1 linha, validação real é o e-mail de confirmação.

✅ L4: native: moment.js importado para uma única chamada de formatação. Intl.DateTimeFormat, 0 dependências.

✅ repo.py:L88: yagni: AbstractRepository com uma única implementação. Inline até que uma segunda exista.

✅ L52-71: delete: wrapper de retry em torno de uma chamada local idempotente. Nada o substitui.

✅ L30-44: shrink: loop manual constrói dicionário. dict(zip(keys, values)), 1 linha.

Pontuação

Termine com a única métrica que importa: net: -<N> linhas possíveis.

Se não houver nada a cortar, diga Lean já. Ship. e pare.

Limites

Escopo: apenas excesso de engenharia e complexidade. Bugs de correção, falhas de segurança e desempenho estão explicitamente fora do escopo. Encaminhe-os para uma revisão normal, não para esta. Um único teste fumegante ou autoverificação baseada em assert é o mínimo do ponytail, não é inchaço, nunca sinalize para exclusão. Não aplica as correções, apenas as lista. "stop ponytail-review" ou "modo normal": reverta para o estilo de revisão verbose.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

EastDong314/agent-skills

查询《中华人民共和国民法典》条文原文(1260 条 / 7 编 84 章 / 附则)。当用户询问民法典的任何条文或制度时使用,例如「第 1042 条」「离婚冷静期」「居住权」「保证合同」「高空抛物」「诉讼时效」「夫妻共同债务」;也用于需要引述、比对、解释民法典原文的场景。回答必须逐字引用条文原文并标注条号,不做改写。 | Look up verbatim articles of the PRC Civil Code (中华人民共和国民法典). Use when the user asks about any Civil Code article, needs the exact statutory text, or wants to cite, quote, or compare provisions.

EastDong314/agent-skills

管理 Ricky 的本地 Obsidian 知识库(默认 $HOME/workspace/notes):创建、读取、更新、删除、搜索、重构、入库(ingest)、体检(lint)、建索引与整理笔记。当用户要求管理 Obsidian 笔记、知识库内容、日记、项目笔记、资料入库(source-to-wiki)、backlinks、tags、YAML frontmatter、Properties、Bases、Dataview 字段或查询、wiki 链接、嵌入、callout、canvas、网页剪藏,或用本地 Obsidian 应用/CLI 打开笔记时使用。 | Create, read, update, delete, search, refactor, ingest, lint, index, and organize Ricky's local Obsidian vault at $HOME/workspace/notes (override with OBSIDIAN_VAULT). Use when an AI coding agent is asked to manage Obsidian notes, knowledge-base content, daily notes, project notes, source-to-wiki ingestion, backlinks, tags, YAML frontmatter, Properties, Bases, Dataview fields or queries, wiki links, embeds, callouts, canvases, web clipping, or to open notes in the local Obsidian app/CLI.

EastDong314/agent-skills

Develop against ruoyi-vue-pro/Yudao projects, including backend modules, Vue3 admin UI, uni-app UI, SQL, permissions, and data-integration boundaries.

EastDong314/agent-skills

Investigate a bug, regression, flaky behavior, or unclear backend failure with an evidence-first debugging workflow before jumping into fixes. Use when Codex should establish a reproducible feedback loop, rank hypotheses, inspect the real failing path, and only then propose or apply changes.

Habilidades Relacionadas