프로젝트 소개
# 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 와일드카드 보안 위험을 놓쳤지만, 사용 후 적극적인 점검 목록을 통해 이러한 문제를 발견했습니다.
## 주의
공식 성명: 모든 모델이 테스트를 통과한 것은 아니며, 이 평가를 통해 생산성 향상이 입증된 것은 아닙니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.