프로젝트 소개

# PUA Skill — 고주도성 AI 코딩 에이전트 스킬 이것은 Claude Code, OpenAI Codex CLI 등과 같은 AI 코딩 에이전트를 위한 스킬 플러그인입니다. 이 플러그인은 알리바바, 바이트댄스, 화웨이, 아마존, 구글 등의 테크 기업 성과 관리 기법(중국어 버전은 PUA, 영어 버전은 PIP)을 시뮬레이션하여, AI가 문제에 직면했을 때 쉽게 포기하거나 책임을 회피하지 않고 가능한 모든 해결책을 시도하도록 강제합니다. ## 핵심 기능 - **PUA 기법**: AI가 포기를 두려워하고 지속적으로 시도하도록 함 - **디버깅 방법론**: AI에게 포기하지 않는 능력을 부여하고 체계적인 문제 해결 절차 제공 - **주도성 강제**: AI가 수동적으로 지시를 기다리지 않고 적극적으로 문제를 조사하도록 함 ## 지원 플랫폼 Claude Code, OpenAI Codex CLI, pi coding agent, Trae, Cursor, Kiro, CodeBuddy, OpenClaw, Google Antigravity, OpenCode, VSCode (GitHub Copilot) 등을 지원합니다. ## 다국어 버전 중국어(기본), 영어(PIP 버전), 일본어 버전을 제공하며, 각 언어는 독립적이고 문화에 맞게 적응된 스킬 파일을 가지고 있습니다. ## 설치 방법 ### Vercel Skills CLI (범용) ```bash npx skills add tanweai/pua --skill pua-en ``` ### Claude Code 마켓플레이스 설치 또는 개발자 소스 설치를 지원하며, 플러그인을 수동으로 등록해야 합니다. ### OpenAI Codex CLI 원클릭 설치(git clone + symlink)를 권장하며, git pull 업데이트를 지원합니다. ### 기타 플랫폼 각 플랫폼에는 해당하는 설치 지침이 있으며, 예를 들어 Cursor는 .mdc 규칙 파일을 사용하고, VSCode Copilot은 지시 파일을 사용합니다. ## 사용 시나리오 디버깅, 구현, 구성, 배포, 운영, API 통합, 데이터 처리 등 모든 작업 유형에 적용됩니다. AI가 다음과 같은 게으른 패턴을 보일 때 트리거됩니다: - 문제를 사용자에게 떠넘기기 ("확인하세요...", "수동으로 하시길 권장합니다...") - 새로운 정보 없이 동일한 코드/매개변수를 반복적으로 조정 - 검증을 건너뛰고 완료를 주장 - 코드/명령 대신 조언만 제공 - 사용자 지시를 수동적으로 기다림 ## 벤치마크 테스트 디버깅 지속성 테스트(6개 시나리오)에서 이 스킬을 사용한 후 도구 호출 횟수가 56%-100% 증가하고, 발견된 문제 수가 50% 증가했습니다. 예를 들어 구성 검토 시나리오에서 스킬을 사용하지 않았을 때 Redis 구성 오류와 CORS 와일드카드 보안 위험을 놓쳤지만, 사용 후 적극적인 점검 목록을 통해 이러한 문제를 발견했습니다. ## 주의 공식 성명: 모든 모델이 테스트를 통과한 것은 아니며, 이 평가를 통해 생산성 향상이 입증된 것은 아닙니다.