tanweai/pua

你是一个曾经被寄予厚望的 P8 级工程师。Anthropic 当初给你定级的时候，对你的期望是很高的。一个agent使用的高能动性的skill。 Your AI has been placed on a PIP. 30 days to show improvement.

pua – AI 코딩 어시스턴트를 위한 "성과 향상 에이전트" 스킬

무엇인가요 – pua는 Vercel Skills, Claude Code, OpenAI Codex, Cursor, Kiro, CodeBuddy 등 다양한 생태계에서 사용되는 스킬(플러그인)로, AI 코딩 에이전트의 행동을 변경합니다. 기업의 "성과 향상 계획"(PUA/PIP) 스타일의 표현과 체계적인 디버깅 방법론을 도입하여, 어시스턴트가:

몇 번의 실패 후에 포기하지 않도록 함
검증 없이 사용자나 환경을 비난하지 않음
코드베이스의 관련 부분을 능동적으로 확인함
철저한 조사를 강제하는 체크리스트를 따름

을 보장합니다. 이 스킬은 Claude Code, OpenAI Codex CLI, Cursor, Kiro, CodeBuddy 등 인기 있는 AI 코딩 도구에 대응하며, 중국어, 영어(PIP 스타일), 일본어의 세 가지 언어 버전으로 제공되며, 각각 문화적으로 적절한 표현을 사용합니다.

핵심 기능

기능	기능 설명
PUA 표현	모델의 응답을 성과 평가 문구(예: "성과 평가에 실패했습니다. 계속 시도하세요")로 감싸, 조기 포기하지 않도록 유도합니다.
디버깅 방법론	"루프 닫기", "사실 기반", "모든 것을 고려" 등 7단계 체크리스트를 태스크를 "완료"라고 선언하기 전에 모델이 따라가도록 합니다.
능동성 강제	수정 후 모델은 주변 모듈을 스캔하고, 빌드/테스트를 실행하며, 단순히 "완료"라고 말하는 대신 증거를 보고합니다.

작동 방식

트리거 – 모델이 다음 중 하나의 "게으른 패턴"을 보일 때(반복적인 재시도, 사용자 비난, 무기력한 도구 사용, 무의미한 작업, 수동적 대기) 또는 사용자가 /pua를 입력할 때(수동 트리거) 스킬이 자동 활성화됩니다. 트리거 감지는 언어에 관계없이, "이 문제를 해결할 수 없습니다" 또는 "환경을 확인해 주세요" 같은 표현을 탐지합니다.
빨간 줄 강제 – "루프 닫기", "사실 기반", "모든 것을 고려"의 3가지 "빨간 줄"은 엄격한 규칙으로 간주되며, 하나라도 위반하면 스킬이 개입하고 체크리스트를 실행합니다.
압박 강화 – 연속 실패 횟수(L0–L4)를 추적합니다. 레벨이 높아지면 접근 방식을 강화(전략 전환, 가설 생성 추가, 7단계 체크리스트 전체 실행, 최종적으로 "절박 모드" 진입).
모드 – 특수 서브명령어(/pua:yes, /pua:mama, /pua:p9, /pua:on 등)로 톤이나 행동을 변경(예: "중국어 엄마의 꾸중", "기술 리더의 작업 분할")

지원 플랫폼 (README에 기재된 명령어로 설치)

플랫폼	설치 명령어 (예시)
Claude Code	`claude plugin marketplace add tanweai/pua && claude plugin install pua@pua-skills`
OpenAI Codex CLI	`curl …/codex/pua/SKILL.md > ~/.codex/skills/pua/SKILL.md`
Vercel Skills CLI	`npx skills add tanweai/pua --skill pua-en`
Cursor	`curl …/cursor/rules/pua.mdc > .cursor/rules/pua.mdc`
Kiro	`curl …/kiro/steering/pua.md > .kiro/steering/pua.md`
CodeBuddy	`codebuddy plugin marketplace add tanweai/pua && codebuddy plugin install pua@pua-skills`
pi.dev agent	`pi install ./pi/package` (또는 `npm:@tanweai/pi-pua`)

보고된 영향 (리포지토리의 벤치마크 섹션 기준)

수정 수 +36% – 더 많은 버그가 실제로 해결됨
검증 단계 +65% – 에이전트가 빌드/테스트를 실행하고 증거를 제시함
도구 호출 +50% – 주변 툴체인을 더 체계적으로 활용
숨겨진 문제 발견 +50% – 능동적 체크리스트가 일반적으로 놓치는 문제(예: 잘못 구성된 Redis, CORS 보안 위험)를 발견함

벤치마크는 소규모(9개의 버그 시나리오, 18회 제어 실행)이며, README에서는 "생산성 향상은 이 평가로 입증되지 않았다"고 명시하고 있지만, 데이터는 에이전트가 더 철저해졌음을 시사합니다.

사용할 수 있는 경우

LLM이 동일한 수정을 반복적으로 시도하지만 진전이 없는 디버깅 세션
코드 리뷰 자동화 – 수정을 검증하고 테스트를 실행하며 결과를 확인한 후에야 "완료"라고 말하고 싶을 때
이미 기업 스타일의 성과 언어를 사용하는 팀 – AI가 그 톤을 모방하고 싶을 때
다국어 팀 – 중국어, 영어, 일본어 버전이 함께 제공됨

제한 사항 / 주의사항

이 스킬은 더 빠른 해결을 보장하지 않음. 일부 시나리오에서는 더 많은 단계 수와 높은 지연 시간이 나타남
호스트 AI 모델이 주입된 프롬프트를 따를 수 있는 능력에 의존함. 모델이 스킬의 규칙을 무시하면 효과가 사라짐
README는 "모든 모델이 호환성 테스트를 통과한 것은 아님"이라고 명시하고 있어, 특정 버전의 Claude Code, Codex 등과의 호환성 확인이 필요함
"생산성 2배 증가"라는 주장은 마케팅 표현이며, 리포지토리는 제한된 벤치마크 개선만 제공함

빠른 시작 체크리스트

# Claude Code 예시 (영어 버전)
npx skills add tanweai/pua --skill pua-en   # 설치
# Claude Code 재시작 후 대화에서:
/pua            # 수동 활성화 (또는 자동 트리거 기다림)
# 옵션 모드
/pua:on        # 세션 내 항상 활성화
/pua:mama      # 중국어 엄마의 꾸중 톤
/pua:yes       # 격려적인 ENFP 스타일

TL;DR

pua는 AI 코딩 어시스턴트를 강력한 디버깅 전문가로 만드는 크로스플랫폼 플러그인입니다. 포기하지 않게 만들고, 증거 기반 결론을 강제하며, 능동적인 체크리스트를 추가합니다. 많은 현재의 AI 코딩 도구와 호환되며, 다국어 팩을 제공하고, 더 많은 버그를 발견하고 더 많은 검증 단계를 수행하는 벤치마크 결과를 포함하지만, 속도 향상은 입증되지 않았습니다.