무료GitHub에 공개한국어 소개

ponytail-debt

코드에서 미뤄 둔 개선을 표시한 주석을 모아 파일별 대장으로 정리합니다. 단순화한 내용, 적용 한계, 재검토 조건을 기록하고 조건이 없는 항목도 표시합니다.

원문원문 설명 보기

Harvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.

DietrichGebert/ponytail

AI 평가90점/ 100 설치 방법 보기

이럴 때 유용합니다

저장소 전체의 미룬 작업을 집계합니다
재검토 조건이 없는 임시 처리를 확인합니다
사용자 지정 표식으로 TODO를 모읍니다
요청에 따라 대장을 파일로 저장합니다

한국어 소개

할 수 있는 일

ponytail-debt는 코드에서 의도적으로 미뤄 둔 개선을 모아 대장으로 정리합니다. shortcut:과 이전 형식인 ponytail: 주석을 찾아 파일명과 줄 번호, 단순화한 내용, 적용 가능한 한계, 재검토 조건을 파일별로 정리합니다. 재검토 조건이 없는 항목에는 no-trigger를 붙이고, 마지막에 전체 항목 수와 조건이 없는 항목 수를 보여 줍니다.

이럴 때 유용합니다

임시 처리가 코드 곳곳에 흩어져 나중에 개선하기로 한 내용을 추적하기 어려울 때 유용합니다. 제약을 알고 채택한 구현을 정리하고 언제 개선해야 하는지 확인할 때도 활용합니다. 사용자 지정 표식을 지정하면 TODO 같은 주석도 모을 수 있습니다.

사용 예시

“/ponytail-debt로 미뤄 둔 개선을 파일별로 정리해 주세요.”
“/ponytail-debt TODO로 TODO 주석을 모아 주세요.”
“정리한 대장을 PONYTAIL-DEBT.md에 저장해 주세요.”

주의 사항

보통은 읽기와 일회성 보고만 수행하며, 저장을 요청하면 파일로 작성합니다. 검색에는 git grep을 사용하고 .git과 .gitignore의 제외 대상을 건너뜁니다. 한계와 재검토 조건은 주석에서 추출하므로 적혀 있지 않은 정보는 보충하지 않습니다. 라이선스는 MIT입니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

객관 평가

AI가 SKILL.md의 내용만을 근거로 4가지 관점에서 판정했습니다. 스타 수나 인기도는 판정에 넣지 않았습니다.

지시의 명확성언제 쓰고 무엇을 하는지 알 수 있는가: A양호대상 주석, 사용자 지정 표식과 일회성 대장 보고 용도가 명시되어 있습니다.
절차의 구체성절차·입출력·예시가 구체적으로 적혀 있는가: A양호git grep 명령, 대장 행 형식, no-trigger 표시와 최종 집계가 구체적입니다.
안전성전송·삭제·명령 실행 등을 명시하고 있는가: A양호평소에는 읽기와 보고만 수행하며 요청받은 경우에만 파일을 저장합니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: B일부 부족git grep을 사용하지만 Git 설치 절차는 안내하지 않습니다.

총점은 각 항목을 A=25점, B=15점, C=5점으로 더한 값입니다. 2026년 10월 20일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(1)

SKILL.md1.7 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Every deliberate ponytail shortcut is marked with a shortcut: comment naming its ceiling and upgrade path (older code may say ponytail:). This collects them into one ledger so a deferral can't quietly become permanent.

Scan

Grep the repo for comment markers, skipping .git and everything the .gitignore files ignore (dependencies, build output, caches, in any stack):

git grep --no-index --exclude-standard -nE '(#|//|/[*]) ?(shortcut|ponytail):' (add other comment prefixes if your stack uses them)

If the user names their own marker word (/ponytail-debt TODO), grep for that word instead.

Each hit is one ledger row. The comment prefix keeps prose that merely mentions the convention out of the ledger. Skip hits that are not a deferral, like a note about a keyboard shortcut.

Output

One row per marker, grouped by file:

<file>:<line>, <what was simplified>. ceiling: <the limit named>. upgrade: <the trigger to revisit>.

The convention is shortcut: <ceiling>, <upgrade path>, so pull the ceiling and the trigger straight from the comment. Want an owner per row too? add git blame -L<line>,<line>.

Flag the rot risk: any marker comment that names no upgrade path or trigger gets a no-trigger tag, those are the ones that silently rot.

End with <N> markers, <M> with no trigger. Nothing found: No shortcut debt. Clean ledger.

Boundaries

Reads and reports only, changes nothing. To persist it, ask and it writes the ledger to a file (e.g. PONYTAIL-DEBT.md). One-shot.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬