무료GitHub에 공개한국어 소개

ponytail-debt

코드에 남긴 간소화 구현과 미룬 개선 사항의 주석을 모아 파일별 기술 부채 대장을 만듭니다. 구현 한계와 재검토 조건을 정리하고 조건 누락을 표시하며 코드는 변경하지 않습니다.

원문원문 설명 보기

List every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.

DietrichGebert/ponytail

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

이럴 때 유용합니다

미뤄 둔 구현 개선 사항 점검
재검토 조건이 없는 항목 찾기
파일별 기술 부채 대장 작성
사용자 지정 표시로 개선 사항 수집

한국어 소개

할 수 있는 일

ponytail-debt는 코드의 shortcut: 주석과 이전 형식인 ponytail: 주석을 모아 미뤄 둔 개선 사항을 기술 부채 대장으로 만듭니다. 파일별로 파일명, 줄 번호, 간소화한 내용, 구현의 한계, 재검토 조건을 정리합니다. 개선 경로나 재검토 조건이 없는 항목에는 no-trigger를 붙이고, 마지막에 전체 건수와 조건이 없는 건수를 표시합니다.

이럴 때 유용합니다

단기 대응으로 남겨 둔 구현을 점검하거나 개선에 착수할 조건이 적혀 있는지 확인할 때 유용합니다. 사용자 지정 표시도 검색할 수 있습니다. 키보드 단축키 설명처럼 미룬 개선과 무관한 주석은 제외합니다.

사용 예시

“/ponytail-debt로 미뤄 둔 구현을 정리해 주세요.”
“/ponytail-debt TODO로 사용자 지정 표시를 찾아 주세요.”
“대장을 PONYTAIL-DEBT.md에 저장해 주세요.”

주의 사항

검색에는 git grep을 사용하며 .git과 .gitignore에서 제외한 경로는 조사하지 않습니다. 기본적으로 한 번 읽고 보고하며 코드는 변경하지 않습니다. 파일 저장은 요청이 있을 때만 수행합니다.

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

객관 평가

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

지시의 명확성언제 쓰고 무엇을 하는지 알 수 있는가: A양호shortcut: 등의 주석 표시를 모아 기술 부채 대장을 만드는 용도가 명시되어 있습니다.
절차의 구체성절차·입출력·예시가 구체적으로 적혀 있는가: A양호git grep 검색식, 항목별 출력 형식, no-trigger 표시 조건을 제시합니다.
안전성전송·삭제·명령 실행 등을 명시하고 있는가: A양호읽기와 보고로 범위를 제한하며 파일 저장은 요청할 때만 수행한다고 명시합니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: A양호주요 전제는 Git이며 실행할 git grep 명령을 제공합니다.

총점은 각 항목을 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.

리뷰

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

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

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

같은 저장소의 스킬