Communityコーディング&開発github.com

EastDong314/agent-skills

過度な設計に焦点を当てたコードレビュースキル。車輪の再発明、不要な依存関係、投機的抽象化、無駄な柔軟性を見つけて削除します。各発見は1行で報告されます。

agent-skills とは?

このスキルは、コードレビューにおいて過度な設計(オーバーエンジニアリング)と複雑性のみを追跡・報告するためのエージェント向けツールです。標準ライブラリで代替可能な自前実装、不要な依存関係、投機的抽象化、未使用の柔軟性、そして冗長なコードを1行ずつ明確に指摘します。各発見はファイルの行番号、タグ(delete/stdlib/native/yagni/shrink)、削除対象、代替案で構成され、最終的には削除可能な行数を「net: -<N> lines possible」としてスコアリングします。このスキルはClaude CodeやCodexなどのAIエージェント上で動作し、ユーザーが「review for over-engineering」「what can we delete」「simplify review」などのフレーズや「/ponytail-review」コマンドを呼び出すと起動します。バグやセキュリティ、パフォーマンスのレビューは対象外で、通常のレビューパスに委ねます。

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

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

不要な複雑性を持つ差分をレビューします。各発見は1行で報告: 場所、何を削除するか、代替案。差分の最良の結果は短くなることです。

フォーマット

L<行番号>: <タグ> <何を>. <代替案>.、または複数ファイルの差分の場合は <ファイル>:L<行番号>: ...。

タグ:

  • delete: デッドコード、未使用の柔軟性、投機的機能。代替案: なし。
  • stdlib: 標準ライブラリに既にある機能を自前実装しているもの。関数名を明記。
  • native: プラットフォームが既に提供していることを実現する依存関係やコード。機能名を明記。
  • yagni: 実装が1つしかない抽象化、誰も設定しない設定値、呼び出し元が1つしかないレイヤー。
  • shrink: 同じロジックをより少ない行数で実現できるもの。短い形式を示す。

例

❌ 「このEmailValidatorクラスは必要以上に複雑かもしれませんね。これらのバリデーションルールが本当に全て必要なのか、検討されましたか?」

✅ L12-38: stdlib: 27行のバリデータクラス。メールアドレスの「@」チェックは1行、実際の検証は確認メールで行う。

✅ L4: native: moment.jsが1回のフォーマット呼び出しのためにインポートされている。Intl.DateTimeFormatで、依存関係0。

✅ repo.py:L88: yagni: 実装が1つしかないAbstractRepository。2つ目ができるまでインライン化する。

✅ L52-71: delete: 冪等なローカル呼び出しをラップするリトライラッパー。何も置き換えない。

✅ L30-44: shrink: 手動ループで辞書を構築中。dict(zip(keys, values))、1行。

スコアリング

唯一の指標で終了します: net: -<N> lines possible.

削除するものが何もない場合は、Lean already. Ship. と表示して停止します。

範囲

対象: 過度な設計と複雑性のみ。正確性のバグ、セキュリティホール、パフォーマンスは明示的に対象外です。それらは通常のレビューパスに回してください。1回のスモークテストや assert ベースのセルフチェックはポニーテールの最低限であり、肥大化ではありません。絶対に削除対象としてフラグを立てないでください。修正は適用せず、リストアップのみを行います。 "stop ponytail-review" または "normal mode": 通常の詳細なレビュースタイルに戻します。

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.

関連スキル