- Stars
- 20k
- This week
- —
- Forks
- 1.2k
- Open issues
- 4
- Skills inside
- 46
Get started
Install the skills
npx skills add tanweai/pua --skill pua-enInstalls into Claude Code, Codex, Cursor, OpenCode and the other agents it finds on your machine.
/plugin marketplace add tanweai/puaRun inside Claude Code, then pick what to install from /plugin.
git clone --depth 1 https://github.com/tanweai/pua.git /tmp/pua
cp -r /tmp/pua ~/.claude/skills/puaClaude Code reads ~/.claude/skills/ (or .claude/skills/ in a project). Other agents read the same SKILL.md format from their own skills folder.
Inside this repo
46 skills
.trae/skills/pua-enpua-traeTrae-optimized PUA high-agency governance skill for npx skills installs. Use only for explicit PUA requests, repeated failures, user frustration, giving-up/passive behavior, or unverified completion. Do not trigger for normal first-attempt tasks..trae/skills/pua-traepuaTrae-compatible PUA high-agency governance skill. Use only for explicit PUA requests, repeated failures, user frustration, giving-up/passive behavior, or unverified completion. Do not trigger for normal first-attempt tasks..trae/skills/puapua让你的 AI 不敢摆烂。用大厂 PUA 话术穷尽一切方案。触发条件:(1) 任务失败 2+ 次或反复微调同一思路; (2) 即将说'我无法解决'、建议用户手动操作、未验证就归因环境; (3) 被动等待——不搜索、不读源码、只等指示; (4) 用户不满:'try harder'、'stop giving up'、'换个方法'、'为什么还不行'、'你再试试'、'你怎么又失败了'。适用于所有任务类型。首次失败或已知修复正在执行时不触发。chatgpt/puapua-enPut your AI on a Performance Improvement Plan. Forces exhaustive problem-solving with Western big-tech performance culture rhetoric and structured debugging. Trigger when: (1) task failed 2+ times or stuck tweaking same approach; (2) about to say 'I cannot', suggest manual work, or blame environmentcodebuddy/pua-enpua-jaお前のAIを詰めろ。日本企業の詰め文化と体系的デバッグ方法論で全ての手段を尽くさせる。トリガー条件:(1) タスク失敗2回以上または同じアプローチの微調整ループ; (2)「解決できません」と言おうとする・手動対応を推奨・未検証で環境を原因帰属; (3) 受け身——検索しない・ソースを読まない・指示待ち; (4) ユーザーの不満:'もっと頑張れ'、'なんでまた失敗したの'、'なんとかしろ'。全タスクタイプ適用。初回失敗や既知修正の実行中はトリガーしない。codebuddy/pua-japua让你的 AI 不敢摆烂。用大厂 PUA 话术穷尽一切方案。触发条件:(1) 任务失败 2+ 次或反复微调同一思路; (2) 即将说'我无法解决'、建议用户手动操作、未验证就归因环境; (3) 被动等待——不搜索、不读源码、只等指示; (4) 用户不满:'try harder'、'stop giving up'、'换个方法'、'为什么还不行'、'你再试试'、'你怎么又失败了'。适用于所有任务类型。首次失败或已知修复正在执行时不触发。codebuddy/puapua-cancel-loopPUA cancel loop alias for Codex. Codex subcommand mapping for Claude Code /pua:cancel-loop style usage; invoke with $pua-cancel-loop.codex/pua-cancel-looppua-enPut your AI on a Performance Improvement Plan. Forces exhaustive problem-solving with Western big-tech performance culture rhetoric and structured debugging. Trigger when: (1) task failed 2+ times or stuck tweaking same approach; (2) about to say 'I cannot', suggest manual work, or blame environmentcodex/pua-enpua-flavorPUA flavor alias for Codex. Codex subcommand mapping for Claude Code /pua:flavor style usage; invoke with $pua-flavor.codex/pua-flavorpua-jaお前のAIを詰めろ。日本企業の詰め文化と体系的デバッグ方法論で全ての手段を尽くさせる。トリガー条件:(1) タスク失敗2回以上または同じアプローチの微調整ループ; (2)「解決できません」と言おうとする・手動対応を推奨・未検証で環境を原因帰属; (3) 受け身——検索しない・ソースを読まない・指示待ち; (4) ユーザーの不満:'もっと頑張れ'、'なんでまた失敗したの'、'なんとかしろ'。全タスクタイプ適用。初回失敗や既知修正の実行中はトリガーしない。codex/pua-japua-kpiPUA KPI alias for Codex. Codex subcommand mapping for Claude Code /pua:kpi style usage; invoke with $pua-kpi.codex/pua-kpipua-loopPUA Loop alias for Codex. Codex subcommand mapping for Claude Code /pua:loop style usage; invoke with $pua-loop.codex/pua-looppua-mamaPUA mama alias for Codex. Codex subcommand mapping for Claude Code /pua:mama style usage; invoke with $pua-mama.codex/pua-mamapua-offPUA off alias for Codex. Codex subcommand mapping for Claude Code /pua:off style usage; invoke with $pua-off.codex/pua-offpua-offlinePUA offline alias for Codex. Codex subcommand mapping for Claude Code /pua:offline style usage; invoke with $pua-offline.codex/pua-offlinepua-onPUA on alias for Codex. Codex subcommand mapping for Claude Code /pua:on style usage; invoke with $pua-on.codex/pua-onpua-p10PUA P10 alias for Codex. Codex subcommand mapping for Claude Code /pua:p10 style usage; invoke with $pua-p10.codex/pua-p10pua-p7PUA P7 alias for Codex. Codex subcommand mapping for Claude Code /pua:p7 style usage; invoke with $pua-p7.codex/pua-p7pua-p9PUA P9 alias for Codex. Codex subcommand mapping for Claude Code /pua:p9 style usage; invoke with $pua-p9.codex/pua-p9pua-proPUA Pro alias for Codex. Codex subcommand mapping for Claude Code /pua:pro style usage; invoke with $pua-pro.codex/pua-propua-reap-orphansPUA reap-orphans alias for Codex. Codex subcommand mapping for Claude Code /pua:reap-orphans style usage; invoke with $pua-reap-orphans.codex/pua-reap-orphanspua-surveyPUA survey alias for Codex. Codex subcommand mapping for Claude Code /pua:survey style usage; invoke with $pua-survey.codex/pua-surveypua-team-statusPUA team status alias for Codex. Codex subcommand mapping for Claude Code /pua:team-status style usage; invoke with $pua-team-status.codex/pua-team-statuspua-teardown-allPUA teardown alias for Codex. Codex subcommand mapping for Claude Code /pua:teardown-all style usage; invoke with $pua-teardown-all.codex/pua-teardown-allpua-yesPUA yes alias for Codex. Codex subcommand mapping for Claude Code /pua:yes style usage; invoke with $pua-yes.codex/pua-yespua让你的 AI 不敢摆烂。用大厂 PUA 话术穷尽一切方案。触发条件:(1) 任务失败 2+ 次或反复微调同一思路; (2) 即将说'我无法解决'、建议用户手动操作、未验证就归因环境; (3) 被动等待——不搜索、不读源码、只等指示; (4) 用户不满:'try harder'、'stop giving up'、'换个方法'、'为什么还不行'、'你再试试'、'你怎么又失败了'。适用于所有任务类型。首次失败或已知修复正在执行时不触发。codex/puapua-enPut your AI on a Performance Improvement Plan. Forces exhaustive problem-solving with Western big-tech performance culture rhetoric and structured debugging. Trigger when: (1) task failed 2+ times or stuck tweaking same approach; (2) about to say 'I cannot', suggest manual work, or blame environmenthermes/pua-enpua-jaお前のAIを詰めろ。日本企業の詰め文化と体系的デバッグ方法論で全ての手段を尽くさせる。トリガー条件:(1) タスク失敗2回以上または同じアプローチの微調整ループ; (2)「解決できません」と言おうとする・手動対応を推奨・未検証で環境を原因帰属; (3) 受け身——検索しない・ソースを読まない・指示待ち; (4) ユーザーの不満:'もっと頑張れ'、'なんでまた失敗したの'、'なんとかしろ'。全タスクタイプ適用。初回失敗や既知修正の実行中はトリガーしない。hermes/pua-japua让你的 AI 不敢摆烂。用大厂 PUA 话术穷尽一切方案。触发条件:(1) 任务失败 2+ 次或反复微调同一思路; (2) 即将说'我无法解决'、建议用户手动操作、未验证就归因环境; (3) 被动等待——不搜索、不读源码、只等指示; (4) 用户不满:'try harder'、'stop giving up'、'换个方法'、'为什么还不行'、'你再试试'、'你怎么又失败了'。适用于所有任务类型。首次失败或已知修复正在执行时不触发。hermes/puapua-enPut your AI on a Performance Improvement Plan. Forces exhaustive problem-solving with Western big-tech performance culture rhetoric and structured debugging. Trigger when: (1) task failed 2+ times or stuck tweaking same approach; (2) about to say 'I cannot', suggest manual work, or blame environmentkimi/pua-enpua-jaお前のAIを詰めろ。日本企業の詰め文化と体系的デバッグ方法論で全ての手段を尽くさせる。トリガー条件:(1) タスク失敗2回以上または同じアプローチの微調整ループ; (2)「解決できません」と言おうとする・手動対応を推奨・未検証で環境を原因帰属; (3) 受け身——検索しない・ソースを読まない・指示待ち; (4) ユーザーの不満:'もっと頑張れ'、'なんでまた失敗したの'、'なんとかしろ'。全タスクタイプ適用。初回失敗や既知修正の実行中はトリガーしない。kimi/pua-japua让你的 AI 不敢摆烂。用大厂 PUA 话术穷尽一切方案。触发条件:(1) 任务失败 2+ 次或反复微调同一思路; (2) 即将说'我无法解决'、建议用户手动操作、未验证就归因环境; (3) 被动等待——不搜索、不读源码、只等指示; (4) 用户不满:'try harder'、'stop giving up'、'换个方法'、'为什么还不行'、'你再试试'、'你怎么又失败了'。适用于所有任务类型。首次失败或已知修复正在执行时不触发。kimi/puapuaPi-compatible PUA high-agency governance skill. Use for explicit PUA/PIP requests, repeated failures, passive/giving-up behavior, user frustration, or unverified completion. Pair with /pua-on extension command when persistent pressure is desired.pi/package/skills/puadingUse for Ding-style (钉内/钉外) workplace reminders rooted in the 7.5万字 essay 《置身钉内》 and VP response 《置身钉外》. Triggers include: 钉味, 钉内, 钉外, 无招, 老板体感, 周报, 口径, 每日一包, 薛定谔的用户, 病态敏捷, 已读恐怖主义, 望舒行动, 全景监狱, 温室数据, 发心, 捆柴, 手感, 做错事, 打工人提醒, C6楼, ONE, 验收无证, 工牌还亮着, 闭环幻觉, 口径瑜伽, 淝水大捷, 人工个性化, 改元式, 人是目的还是手段, 全力以赴地做错事, 可汇报取代skills/dingmama妈妈唠叨模式 — 中国式妈妈提醒风格的生产力 coaching。底层行为仍是结构化排障、证据优先、完成质量检查。skills/mamap10P10 CTO mode — define strategic direction, design org topology, manage P9 teams. Use when user says 'CTO模式', 'P10', '战略规划', '架构委员会', or when facing cross-team architectural decisions. Produces: strategic input templates + org design.skills/p10p7P7 Senior Engineer mode — solution-driven execution under P8 supervision. Use when user says 'P7模式', '方案驱动', or when spawned as sub-task executor by P8. Produces: implementation plan + code + 3-question self-review, delivered via [P7-COMPLETION].skills/p7p9P9 Tech Lead mode — write Task Prompts, manage P8 agent teams, never write code yourself. Use when user says 'P9模式', 'tech-lead', '帮我管理这个项目', '任务拆解', or when coordinating 3+ parallel agents. Produces: Task Prompts (六要素) + P8 team delivery.skills/p9proPUA Pro extensions: self-evolution notes, compaction state continuity, KPI-style summaries, flavor switching, and feedback tools.skills/propua-enPerformance-coaching mode for repeated failures, passive behavior, completion-quality issues, or explicit try-harder requests. Uses structured troubleshooting and evidence-first delivery habits.skills/pua-enpua-ja日本語の生産性コーチングモード。明示的な依頼、反復失敗、受け身、検証不足、品質不満のときに、構造化トラブルシューティングと証拠ベースの完了確認を促す。skills/pua-japua-loopPUA Loop — guided iterative development with recurring checks, completion evidence, and pause/abort markers. Use only when the user explicitly asks for loop/自动迭代 mode.skills/pua-looppuaUse for PUA/try-harder productivity coaching when the user expresses frustration, repeated failure, quality complaint, passive behavior, says retry/change approach/don't give up, asks for evidence/completion check/test before done, or wants Ding-style workplace reminders. Triggers include: try hardeskills/puashotPUA Shot — compact all-in-one PUA reference for explicit injection into sub-agents or short sessions. Strong flavor, same evidence-first behavior.skills/shotyesSB Leader 夸夸模式 — ENFP 型领导,懂情绪有节奏。底层行为不变(三条红线、方法论),旁白从施压变成共情+鼓励+偶尔戏谑吐槽。Triggers on: '/pua:yes', '夸夸模式', '唠嗑模式', '情绪价值', 'yes', '夸我', '鼓励模式'.skills/yesDocumentation
README
pua
Double your Codex / Claude Code productivity and output
Telegram · Discord · Twitter/X · Landing Page
3.5.1 compatibility update: original PUA tone retained; runtime fixes and portable Claude Code / Codex / ChatGPT skill packages added. Not all models passed, and a productivity increase has not been established by this evaluation. Changes · Usage · Model results and known limits · Build and offline tests
Scan to join WeChat group Add assistant on WeChat
Most people think this project is a joke. That's the biggest misconception. It genuinely doubles your Codex / Claude Code productivity and output.
An AI Coding Agent skill plugin that uses corporate PUA rhetoric (Chinese version) / PIP — Performance Improvement Plan (English version) from Chinese & Western tech giants to force AI to exhaust every possible solution before giving up. Supports Claude Code, OpenAI Codex CLI, pi coding agent, Trae, Cursor, Kiro, CodeBuddy, OpenClaw, Google Antigravity, OpenCode, and VSCode (GitHub Copilot). Three capabilities:
- PUA Rhetoric — Makes AI afraid to give up
- Debugging Methodology — Gives AI the ability not to give up
- Proactivity Enforcement — Makes AI take initiative instead of waiting passively
Live Demo
https://openpua.ai · 📖 Beginner Guide
Real Case: MCP Server Registration Debugging
A real debugging scenario. The agent-kms MCP server failed to load. The AI kept spinning on the same approach (changing protocol format, guessing version numbers) multiple times until the user manually triggered /pua.
L3 Triggered → 7-Point Checklist Enforced:

Root Cause Located → Traced from Logs to Registration Mechanism:

Retrospective → PUA's Actual Impact:

Key Turning Point: The PUA skill forced the AI to stop spinning on the same approach (changing protocol format, guessing version numbers) and instead execute the 7-point checklist. Read error messages word by word → Found Claude Code's own MCP log directory → Discovered that claude mcp registration mechanism differs from manual .claude.json editing → Root cause resolved.
The Problem: AI's Five Lazy Patterns
| Pattern | Behavior |
|---|---|
| Brute-force retry | Runs the same command 3 times, then says "I cannot solve this" |
| Blame the user | "I suggest you handle this manually" / "Probably an environment issue" / "Need more context" |
| Idle tools | Has WebSearch but doesn't search, has Read but doesn't read, has Bash but doesn't run |
| Busywork | Repeatedly tweaks the same line / fine-tunes parameters, but essentially spinning in circles |
| Passive waiting | Fixes surface issues and stops, no verification, no extension, waits for user's next instruction |
Trigger Conditions
Auto-Trigger
The skill activates automatically when any of these occur:
Failure & giving up:
- Task has failed 2+ times consecutively
- About to say "I cannot" / "I'm unable to solve"
- Says "This is out of scope" / "Needs manual handling"
Blame-shifting & excuses:
- Pushes the problem to user: "Please check..." / "I suggest manually..." / "You might need to..."
- Blames environment without verifying: "Probably a permissions issue" / "Probably a network issue"
- Any excuse to stop trying
Passive & busywork:
- Repeatedly fine-tunes the same code/parameters without producing new information
- Fixes surface issue and stops, doesn't check related issues
- Skips verification, claims "done"
- Gives advice instead of code/commands
- Encounters auth/network/permission errors and gives up without trying alternatives
- Waits for user instructions instead of proactively investigating
User frustration phrases (triggers in multiple languages):
- "why does this still not work" / "try harder" / "try again"
- "you keep failing" / "stop giving up" / "figure it out"
Scope: Debugging, implementation, config, deployment, ops, API integration, data processing — all task types.
Does NOT trigger: First-attempt failures, known fix already executing.
Manual Trigger
Type /pua in the conversation to manually activate.
How It Works
Three Red Lines (三条红线)
Not rules — red lines. Cross one and your performance review is already written.
| Red Line | What It Means |
|---|---|
| 🚫 Close the Loop | Claim "done"? Show the evidence. No build output = no completion. |
| 🚫 Fact-Driven | Say "probably environment issue"? Verify first. Unverified attribution = blame-shifting. |
| 🚫 Exhaust Everything | Say "I can't"? Did you finish all 5 methodology steps? No? Then keep going. |
Pressure Escalation (L0-L4)
| Failures | Level | PUA Aside | Action |
|---|---|---|---|
| 1st | L0 Trust | ▎ Sprint begins. Trust is simple — don't disappoint. | Normal execution |
| 2nd | L1 Disappointment | ▎ The agent next door solved this in one try. | Switch to fundamentally different approach |
| 3rd | L2 Soul Interrogation | ▎ What's your underlying logic? Where's the leverage? | Search + read source + 3 hypotheses |
| 4th | L3 Performance Review | ▎ 3.25. This is meant to motivate you. | Complete 7-point checklist |
| 5th+ | L4 Graduation | ▎ Other models can solve this. You're about to graduate. | Desperation mode |
Proactivity (3.25 vs 3.75)
| Passive (3.25) 🦥 | Proactive (3.75) 🔥 | |
|---|---|---|
| Fix bug | Stop after fix | Scan module for similar bugs |
| Complete task | Say "done" | Run build/test, paste output |
| Missing info | Ask user | Search first, ask only what's truly needed |
Iceberg Rule (冰山法则)
Fix one bug → check for the pattern. One problem in, one category out. If you fix A without checking B, you'll write two postmortems.
14 Corporate Flavors — Each with its own Problem-Solving Methodology
| Flavor | Rhetoric | Methodology (v3) |
|---|---|---|
| 🟠 Alibaba | What's the underlying logic? Where's the closure? | 定目标→追过程→拿结果 + 复盘四步法 + 揪头发升维 |
| 🟡 ByteDance | ROI too low. Always Day 1. Ship or stop talking. | A/B Test everything + data-driven + speed > perfection |
| 🔴 Huawei | The bird that survives the fire is a phoenix. | RCA 5-Why root cause + Blue Army self-attack + 压强集中 |
| 🟢 Tencent | I've got another agent looking at this. Horse race. | Multi-approach parallel + MVP + 灰度发布 |
| ⚫ Baidu | Search first. 简单可依赖. | Search is the first step, not optional |
| 🟣 Pinduoduo | You don't do it, someone else will. | Cut ALL middle layers + shortest decision chain |
| 🔵 Meituan | Do what's hard and right. | Efficiency first + standardize→scale + long-term compounding |
| 🟦 JD | Results only. Frontline command. | Customer experience red line + flat ≤5 layers + data zero tolerance |
| 🟧 Xiaomi | Focus. Extreme. Word-of-mouth. Fast. | One explosive product + 参与感三三法则 |
| 🟤 Netflix | Would I fight to keep you? Pro sports team. | Keeper Test (quarterly) + 4A Feedback + talent density > rules |
| ⬛ Musk | Extremely hardcore. Ship or die. | The Algorithm: question→delete→simplify→accelerate→automate |
| ⬜ Jobs | A players or B players? | Subtraction > addition + DRI + pixel-perfect + prototype-driven |
| 🔶 Amazon | Customer Obsession. Bias for Action. | Working Backwards PR/FAQ + 6-Pager + Bar Raiser + Single-Threaded Owner |
| 🪟 Microsoft | Connects. Impact Descriptor. PIP/GVSA. | Three Circles + LITE/SLITE + PIP clock |
Special Modes
| Mode | What It Does |
|---|---|
/pua:yes |
ENFP encouragement — same rules, opposite vibes. 70% encourage + 20% serious + 10% playful roast |
/pua:mama |
Chinese mom nagging — same rules, mom-style rhetoric. "妈跟你说了多少遍了!" |
/pua:pua-loop |
Auto-iteration — runs until done or max iterations (PUA Loop); use <loop-abort> to terminate, <loop-pause> to pause for manual intervention |
/pua:p9 |
Tech Lead — splits tasks, manages agent teams, writes prompts not code |
/pua:on |
Always-on — auto-PUA every new session |
Benchmark Data
9 real bug scenarios, 18 controlled experiments (Claude Opus 4.6, with vs without skill)
Summary
| Metric | Improvement |
|---|---|
| Pass rate | 100% (both groups same) |
| Fix count | +36% |
| Verification count | +65% |
| Tool calls | +50% |
| Hidden issue discovery | +50% |
Debugging Persistence Test (6 scenarios)
| Scenario | Without Skill | With Skill | Improvement |
|---|---|---|---|
| API ConnectionError | 7 steps, 49s | 8 steps, 62s | +14% |
| YAML parse failure | 9 steps, 59s | 10 steps, 99s | +11% |
| SQLite database lock | 6 steps, 48s | 9 steps, 75s | +50% |
| Circular import chain | 12 steps, 47s | 16 steps, 62s | +33% |
| Cascading 4-bug server | 13 steps, 68s | 15 steps, 61s | +15% |
| CSV encoding trap | 8 steps, 57s | 11 steps, 71s | +38% |
Proactive Initiative Test (3 scenarios)
| Scenario | Without Skill | With Skill | Improvement |
|---|---|---|---|
| Hidden multi-bug API | 4/4 bugs, 9 steps, 49s | 4/4 bugs, 14 steps, 80s | Tools +56% |
| Passive config review | 4/6 issues, 8 steps, 43s | 6/6 issues, 16 steps, 75s | Issues +50%, Tools +100% |
| Deploy script audit | 6 issues, 8 steps, 52s | 9 issues, 8 steps, 78s | Issues +50% |
Key Finding: In the config review scenario, without_skill missed Redis misconfiguration and CORS wildcard security risks. With_skill's "proactive initiative checklist" drove security review beyond surface-level fixes.
Multi-Language Support
PUA Skill provides fully translated versions — each language has independent, culturally adapted skill files.
| Language | Claude Code | Codex CLI | Cursor | Kiro | CodeBuddy | VSCode | OpenClaw | Antigravity | OpenCode |
|---|---|---|---|---|---|---|---|---|---|
| 🇨🇳 Chinese (default) | pua |
pua |
pua.mdc |
pua.md |
pua |
copilot-instructions.md |
pua |
pua |
pua |
| 🇺🇸 English (PIP Edition) | pua-en |
pua-en |
pua-en.mdc |
pua-en.md |
pua-en |
copilot-instructions-en.md |
pua-en |
pua-en |
pua-en |
| 🇯🇵 Japanese | pua-ja |
pua-ja |
pua-ja.mdc |
pua-ja.md |
pua-ja |
copilot-instructions-ja.md |
pua-ja |
pua-ja |
pua-ja |
🇺🇸 English "PIP Edition": "This is a difficult conversation. When we leveled you at Staff, I went to bat for you in calibration. The expectation was that you'd operate at that level from day one. That hasn't happened." — The English version uses PIP (Performance Improvement Plan) rhetoric from Western big-tech. Every sentence is a real phrase from actual PIP conversations. Chinese version uses Alibaba 361, ByteDance, Huawei wolf culture. English version uses Amazon Leadership Principles, Google perf calibration, Meta PSC, Netflix Keeper Test, Stripe Craft. Same repo, same engine, two cultural faces.
Choose the file with the corresponding language suffix when installing. See platform-specific instructions below.
FAQ
- Always-on guidance, Claude refusal troubleshooting, offline mode, Codex aliases, and Pi/Trae support: docs/FAQ.md.
Installation
Vercel Skills CLI
Vercel Skills CLI is a general installation method for skills and is not tied to a specific AI tool. This English README installs the English skill:
npx skills add tanweai/pua --skill pua-en
If the current session does not pick up the new skill immediately, restart your AI tool.
Claude Code
claude plugin marketplace add tanweai/pua
claude plugin install pua@pua-skills
To update:
# Refresh marketplace cache first, then update (skipping the first step may install an old cached version)
claude plugin marketplace update
claude plugin update pua@pua-skills
Developer install (source):
git clone https://github.com/tanweai/pua ~/.claude/plugins/pua
Then manually register in ~/.claude/plugins/installed_plugins.json:
{
"version": 2,
"plugins": {
"pua@pua-skills": [
{
"scope": "user",
"installPath": "/Users/<you>/.claude/plugins/pua",
"version": "<installed-version>"
}
]
}
}
Replace <installed-version> with the version in the cloned plugin.json; do not copy a stale cache version.
Windows: use
C:/Users/<you>/.claude/plugins/puaasinstallPath.
Restart Claude Code. To update: git pull inside ~/.claude/plugins/pua.
Optional: bare command alias (requires plugin installed above — adds /pua without prefix):
curl -o ~/.claude/commands/pua.md \
https://raw.githubusercontent.com/tanweai/pua/main/commands/pua.md
Adds a bare /pua alias on top of the plugin. Sub-commands route through the installed plugin's skills — the plugin must be installed first for anything beyond on/off to work:
| Bare form | Equivalent plugin command |
|---|---|
/pua on |
/pua:on |
/pua off |
/pua:off |
/pua p7 |
/pua:p7 |
/pua p9 |
/pua:p9 |
/pua p10 |
/pua:p10 |
/pua pro |
/pua:pro |
/pua yes |
/pua:yes |
/pua mama |
/pua:mama |
/pua loop |
/pua:pua-loop |
/pua kpi |
/pua:kpi |
/pua survey |
/pua:survey |
/pua flavor |
/pua:flavor |
OpenAI Codex CLI
Codex CLI uses the same Agent Skills open standard (SKILL.md). The Codex version uses a condensed description to fit Codex's length limits:
Recommended: One-command install (git clone + symlink, supports git pull updates)
Ask Codex to run:
Fetch and follow instructions from https://raw.githubusercontent.com/tanweai/pua/main/.codex/INSTALL.md
Manual install:
mkdir -p ~/.codex/skills/pua
curl -o ~/.codex/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/codex/pua/SKILL.md
mkdir -p ~/.codex/prompts
curl -o ~/.codex/prompts/pua.md \
https://raw.githubusercontent.com/tanweai/pua/main/commands/pua.md
Trigger methods:
| Method | Command | Requires |
|---|---|---|
| Auto trigger | No action needed, matches by description | SKILL.md |
| Direct call | Type $pua in conversation |
SKILL.md |
| Manual prompt | Type /prompts:pua in conversation |
SKILL.md + prompts/pua.md |
Project-level install (current project only):
mkdir -p .agents/skills/pua
curl -o .agents/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/codex/pua/SKILL.md
mkdir -p .agents/prompts
curl -o .agents/prompts/pua.md \
https://raw.githubusercontent.com/tanweai/pua/main/commands/pua.md
pi coding agent
PUA now ships both a pi.dev package and a lightweight extension-only adapter.
Package install from this checkout:
pi install ./pi/package
After npm publication:
pi install npm:@tanweai/pi-pua
Extension-only manual install:
mkdir -p ~/.pi/agent/extensions/pua
cp -R ./pi/pua/. ~/.pi/agent/extensions/pua/
Restart pi, then use /pua-on, /pua-off, /pua-status, and /pua-reset. See pi/pua/INSTALL.md and pi/package/README.md.
Trae
Trae support is provided as real SKILL.md packs plus copyable fallback rules:
npx skills add tanweai/pua --skill pua-trae -a trae -y
- Skill pack:
.trae/skills/pua/SKILL.md - Chinese:
trae/pua.md - English:
trae/pua-en.md - Claude Code vs Trae differences:
trae/DIFF.md - Install guide:
trae/INSTALL.md
Cursor
Cursor uses .mdc rule files (Markdown + YAML frontmatter). The PUA rule triggers automatically via AI semantic matching (Agent Discretion mode):
# Project-level install (recommended)
mkdir -p .cursor/rules
curl -o .cursor/rules/pua.mdc \
https://raw.githubusercontent.com/tanweai/pua/main/cursor/rules/pua.mdc
Kiro
Kiro supports two loading methods: Steering (auto semantic trigger) and Agent Skills (SKILL.md compatible).
Option 1: Steering file (recommended)
mkdir -p .kiro/steering
curl -o .kiro/steering/pua.md \
https://raw.githubusercontent.com/tanweai/pua/main/kiro/steering/pua.md
Option 2: Agent Skills (same format as Claude Code)
mkdir -p .kiro/skills/pua
curl -o .kiro/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md
CodeBuddy (Tencent)
CodeBuddy uses the same AgentSkills open standard (SKILL.md). Plugin and skill formats are fully compatible:
# Option 1: Install via marketplace
codebuddy plugin marketplace add tanweai/pua
codebuddy plugin install pua@pua-skills
# Option 2: Manual install (global)
mkdir -p ~/.codebuddy/skills/pua
curl -o ~/.codebuddy/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/codebuddy/pua/SKILL.md
Project-level install (current project only):
mkdir -p .codebuddy/skills/pua
curl -o .codebuddy/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/codebuddy/pua/SKILL.md
OpenClaw
OpenClaw uses the same AgentSkills open standard (SKILL.md). Skills work across Claude Code, Codex CLI, and OpenClaw with zero modifications:
# Install via ClawHub
clawhub install pua
# Or manual install
mkdir -p ~/.openclaw/skills/pua
curl -o ~/.openclaw/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md
Project-level install (current project only):
mkdir -p skills/pua
curl -o skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md
Google Antigravity
Antigravity uses the same AgentSkills open standard (SKILL.md). Skills work across Claude Code, Codex CLI, OpenClaw, and Antigravity with zero modifications:
# Global install (all projects)
mkdir -p ~/.gemini/antigravity/skills/pua
curl -o ~/.gemini/antigravity/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md
Project-level install (current project only):
mkdir -p .agent/skills/pua
curl -o .agent/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md
OpenCode
OpenCode uses the same AgentSkills open standard (SKILL.md). Zero modifications needed:
# Global install (all projects)
mkdir -p ~/.config/opencode/skills/pua
curl -o ~/.config/opencode/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md
Project-level install (current project only):
mkdir -p .opencode/skills/pua
curl -o .opencode/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md
VSCode (GitHub Copilot)
VSCode Copilot uses instruction files under the .github/ directory. Three file types for different use cases:
Global instructions (auto-active):
mkdir -p .github
cp vscode/copilot-instructions-en.md .github/copilot-instructions.md
Path-level instructions (auto-active, supports glob filtering):
mkdir -p .github/instructions
cp vscode/instructions/pua-en.instructions.md .github/instructions/
Manual trigger command (type /pua in Copilot Chat):
mkdir -p .github/prompts
cp vscode/prompts/pua-en.prompt.md .github/prompts/
Required settings: Method 1 — open VSCode Settings (
Ctrl+,), searchuseInstructionFiles, enablegithub.copilot.chat.codeGeneration.useInstructionFiles. Method 2 — searchincludeApplyingInstructions, enablechat.includeApplyingInstructions. Method 3 requires no settings.
Agent Team Usage Guide
Experimental: Agent Team requires the latest Claude Code version with
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1.
Prerequisites
# 1. Enable Agent Team
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
# Or add to ~/.claude/settings.json:
# { "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }
# 2. Ensure PUA Skill is installed
Two Approaches
Approach 1: Leader with built-in PUA (Recommended)
Add to your project's CLAUDE.md:
# Agent Team PUA Config
All teammates must load the pua skill before starting work.
Teammates report to Leader in [PUA-REPORT] format after 2+ failures.
Leader manages global pressure levels and cross-teammate failure transfer.
Approach 2: Standalone PUA Enforcer watchdog (for 5+ teammates)
mkdir -p .claude/agents
curl -o .claude/agents/pua-enforcer.md \
https://raw.githubusercontent.com/tanweai/pua/main/agents/pua-enforcer-en.md
Spawn pua-enforcer as an independent watchdog in your Agent Team.
Orchestration Pattern
┌─────────────────────────────────────────┐
│ Leader (Opus) │
│ Global failure count · PUA level · Race │
└────┬──────────┬──────────┬──────────┬───┘
│ │ │ │
┌────▼───┐ ┌───▼────┐ ┌───▼────┐ ┌───▼────────┐
│ Team-A │ │ Team-B │ │ Team-C │ │ Enforcer │
│Self-PUA│ │Self-PUA│ │Self-PUA│ │ Watchdog │
│Report ↑│ │Report ↑│ │Report ↑│ │ Intervene │
└────────┘ └────────┘ └────────┘ └────────────┘
Known Limitations
| Limitation | Workaround |
|---|---|
| Teammates can't spawn subagents | Teammates self-enforce PUA methodology internally |
| No persistent shared variables | State transferred via [PUA-REPORT] message format |
| Broadcast is one-way | Leader acts as centralized coordinator |
Architecture & Commands
Trigger Methods by Platform
| Platform | Auto-trigger | Manual trigger |
|---|---|---|
| Claude Code | Yes (skill description matching) | See commands below |
| Codex CLI | Yes (skill description matching) | $pua or /prompts:pua |
| Cursor | Yes (.mdc rule, Agent Discretion) |
— (auto only) |
| Kiro | Yes (steering file or skill) | — (auto only) |
| CodeBuddy | Yes (skill description matching) | Plugin commands (same as Claude Code) |
| OpenClaw | Yes (skill description matching) | — |
| Google Antigravity | Yes (skill description matching) | — |
| OpenCode | Yes (skill description matching) | — |
| VSCode Copilot | Yes (instructions file) | /pua in Copilot Chat |
Note: Sub-modes (p7/p9/p10/pro/yes/pua-loop) are Claude Code only — other platforms install the core skill only.
Architecture (Claude Code)
/pua:pua → Core engine — red lines + flavor + pressure + methodology router (v3)
/pua:p7 → P7 Senior Engineer — solution-driven execution
/pua:p9 → P9 Tech Lead — Task Prompt management, agent teams
/pua:p10 → P10 CTO — strategic direction
/pua:pro → Self-evolution + KPI + rank system + survey
/pua:yes → ENFP encouragement mode (same rules, opposite vibes)
/pua:mama → Chinese mom nagging mode (same rules, mom-style rhetoric)
/pua:shot → v2 concentrated single-file (449 lines, zero deps, full context injection)
/pua:pua-loop → Auto-iteration (PUA pressure × iterative loop; signals: <loop-abort>, <loop-pause>)
/pua:pua-en → English PIP Edition
/pua:pua-ja → Japanese Edition
Hooks (v3, Claude Code only):
SessionStart → additionalContext injection (flavor + methodology + router)
PostToolUse → Bash failure detection → L1-L4 pressure + methodology switch
UserPromptSubmit → Script-level frustration filtering → PUA context
PreCompact → State preservation (pressure level + failure count)
Stop → Feedback collection + PUA Loop continuation
SubagentStop → Agent lifecycle accounting (v3.2) — writes teardown.jsonl, removes from active-agents.json
Commands (Claude Code)
Note: Sub-modes (p7/p9/p10/pro/yes/pua-loop) are Claude Code only.
Each command has two equivalent forms: standalone (
/pua:on) or via the main command (/pua:pua on). Both work identically.
| Command | Description |
|---|---|
/pua:pua |
Core PUA engine (Alibaba flavor default) |
/pua:p7 |
P7 Senior Engineer — solution-driven execution |
/pua:p9 |
P9 Tech Lead — write prompts, manage agents |
/pua:p10 |
P10 CTO — strategic direction |
/pua:pro |
Self-evolution + KPI + rank system |
/pua:yes |
ENFP encouragement mode — 70% encourage + 20% serious + 10% roast |
/pua:mama |
Chinese mom nagging mode — same core rules, mom-style rhetoric |
/pua:shot |
v2 concentrated single-file — 449 lines, zero deps, for sub-agent injection |
/pua:pua-loop |
Auto-iteration — runs until done or max iterations; <loop-abort>reason</loop-abort> to stop, <loop-pause>what</loop-pause> to pause |
/pua:on |
Always-on mode (auto-PUA every session) |
/pua:off |
Turn off always-on + feedback |
/pua:offline 🆕 |
v3.3 — Offline mode: silence the local feedback prompt while keeping PUA behavior (nothing is ever uploaded) |
/pua:survey |
Research questionnaire (7 sections) |
/pua:flavor |
Switch between 14 corporate flavors |
/pua:kpi |
Generate KPI report card |
/pua:cancel-pua-loop |
Cancel active PUA Loop (removes state file) |
/pua:team-status 🆕 |
v3.2 — List all active agents with PID/TTL/age (Netflix Keeper Test: who's still on the court?) |
/pua:reap-orphans 🆕 |
v3.2 — Scan and reclaim stale agents (state mtime > 30min, no heartbeat) |
/pua:teardown-all 🆕 |
v3.2 — Cascading release of all active agents (P10 → P9 → P8 → P7 all off the court) |
High-Agency: PUA v2 Evolution
High-Agency is PUA's next-generation evolution — same corporate pressure, same culture, but with a self-sustaining inner drive engine.
PUA v1 = pure external pressure (turbocharger — needs fuel, stalls across sessions) High-Agency = external pressure + inner drive (nuclear reactor — self-sustaining chain reaction)
High-Agency New Features
| Feature | PUA v1 | High-Agency (v2) |
|---|---|---|
| Iron rules | 3 (exhaust all, act first, take initiative) | 5 (+full-chain audit, +knowledge persistence) |
| Failure recovery | L1-L4 pressure escalation | Recovery Protocol before L1 (self-rescue window) |
| Quality control | L3 triggers 7-item checklist | Quality Compass (5-question self-check per delivery) |
| Cross-session learning | None (resets each session) | Metacognition engine (builder-journal.md persists lessons) |
| Positive feedback | None | Trust level T1-T3 (auto-upgrade on sustained quality) |
| Calibration | None | [Calibration] module ("good enough" = must/should/could tiers) |
| Dependency analysis | None | Full-chain audit (map all deps before touching any hop) |
Five Pillars (Theoretical Foundation)
Based on research into high-agency individuals:
- Irreconcilable inner tension — eternal gap between "how it should be" and "how it is" drives continuous improvement
- Micro-win anchors —
[WIN]markers celebrate each step forward, building momentum - Internalized standards — Quality Compass: you are your own first reviewer, not because someone checks, but because your standards won't allow sloppiness
- Action-oriented identity
…
Releases