大多数人认为这个项目是个笑话。这是最大的误解。它确实能让你的 Codex / Claude Code 的工作效率和产出翻倍。
一款人工智能编码代理技能插件,它利用中西方科技巨头的企业级PUA(搭讪艺术家)修辞手法,迫使人工智能在放弃之前穷尽所有可能的解决方案。支持Claude Code、OpenAI Codex CLI、Cursor、Kiro、OpenClaw、Google Antigravity和OpenCode。具备以下三大功能:
-
PUA(搭讪艺术家)的修辞手法——让AI(人工智能)不敢放弃
-
调试方法论——赋予人工智能永不放弃的能力
-
主动执行——使人工智能主动出击,而不是被动等待
真实案例:MCP 服务器注册调试
这是一个真实的调试场景。代理 KMS MCP 服务器加载失败。人工智能反复尝试相同的方法(更改协议格式、猜测版本号),直到用户手动触发/pua。
L3 触发 → 执行 7 点检查清单:
已找到根本原因 → 从日志追踪到注册机制:
回顾 → PUA 的实际影响:
关键转折点: PUA技能迫使AI停止沿用旧方法(更改协议格式、猜测版本号),转而执行7项检查清单。逐字阅读错误信息→找到Claude Code自己的MCP日志目录→发现claude mcp注册机制与手动.claude.json编辑不同→根本原因已解决。
问题:人工智能的五种惰性模式
| 图案 | 行为 |
|---|---|
| 暴力重试 | 运行同一命令 3 次后,显示“我无法解决这个问题”。 |
| 责怪用户 | “我建议您手动处理” / “可能是环境问题” / “需要更多信息” |
| 闲置工具 | 有 WebSearch 功能但无法搜索,有 Read 功能但无法读取,有 Bash 功能但无法运行 |
| 忙碌的工作 | 反复调整同一条线路/微调参数,但本质上只是在原地打转。 |
| 被动等待 | 修复表面问题并停止运行,不进行验证,不扩展,等待用户发出下一个指令 |
触发条件
自动触发
当出现以下任一情况时,该技能将自动激活:
失败与放弃:
-
任务已连续失败 2 次以上
-
正要说“我不能”/“我无法解决”
-
提示“这超出范围”/“需要人工处理”
推卸责任和找借口:
-
将问题抛给用户:“请检查……”/“我建议手动……”/“您可能需要……”
-
未核实便将问题归咎于环境:“可能是权限问题”/“可能是网络问题”
-
任何停止尝试的借口。
被动式和繁琐工作:
-
反复微调相同的代码/参数,却不产生新的信息
-
修复表面问题并停止,不检查相关问题
-
跳过验证步骤,声称“完成”
-
提供建议而非代码/命令
-
遇到身份验证/网络/权限错误,未尝试其他方法便放弃。
-
等待用户指示,而不是主动调查
用户沮丧语录(多种语言的触发词):
-
“为什么还是不行?”/“再试一次”/“再试一次”
-
“你一直失败”/“别放弃”/“想办法解决”
**范围:**调试、实施、配置、部署、运维、API集成、数据处理——所有任务类型。
**不会触发:**首次尝试失败,已知修复程序已在执行。
手动扳机
/pua在对话中输入内容以手动激活。
工作原理
三条铁律
| 铁律 | 内容 |
|---|---|
| #1 穷尽所有选项 | 在尝试所有方法之前,禁止说“我解决不了这个问题”。 |
| #2 先行动后提问 | 首先使用工具,问题必须包含诊断结果。 |
| #3 主动出击 | 主动交付端到端成果,不要等着别人催促。P8 不是 NPC(非玩家角色)。 |
压力升级(4 个级别)
| 失败 | 等级 | PUA修辞 | 强制措施 |
|---|---|---|---|
| 第二 | L1 轻微失望 | “你连这个漏洞都解决不了——我怎么评价你的表现?” | 转而采用截然不同的方法 |
| 第三 | L2灵魂审讯 | “其根本逻辑是什么?顶层设计在哪里?关键点在哪里?” | 网络搜索 + 阅读源代码 |
| 第四 | L3绩效考核 | “经过慎重考虑,我给你3.25分。这3.25分是为了激励你。” | 完成7项检查清单 |
| 5年级以上 | L4毕业警告 | “其他模型也能解决这个问题。你可能即将毕业。” | 绝望模式 |
主动性水平
| 行为 | 被动语态(3.25) | 主动性(3.75) |
|---|---|---|
| 遇到错误 | 只查看错误信息 | 检查 50 行上下文 + 搜索类似问题 + 检查隐藏的相关错误 |
| 错误已修复 | 修复后停止 | 检查同一文件中是否存在类似错误,检查其他文件中是否存在相同模式 |
| 信息不足 | 询问用户“请告诉我X” | 首先使用工具进行调查,只询问真正需要用户确认的问题。 |
| 任务完成 | 显示“完成” | 验证结果 + 检查极端情况 + 报告潜在风险 |
| 调试失败 | “我试过A和B,都不行。” | “我尝试了 A/B/C/D/E,排除了 X/Y/Z,最终确定范围为 W”。 |
调试方法(5 个步骤)
受阿里巴巴管理框架(嗅觉、提升、镜像)的启发,扩展为 5 个步骤:
-
找出问题所在——列出所有尝试,找出共同的失败模式
-
提升——逐字阅读错误→网络搜索→阅读源代码→验证环境→颠覆假设
-
镜像检查——重复检查?搜索过?读取过文件?检查过最简单的可能性吗?
-
执行——新方法必须从根本上有所不同,必须有验证标准,并且能够产生关于失败的新信息。
-
回顾——是什么解决了这个问题?为什么你之前没想到?然后主动检查相关问题。
企业 PUA 扩展包
-
阿里巴巴风味(方法论):嗅觉/提升/镜像
-
字节跳动风格(直言不讳):永远从第一天开始。注重背景,而非控制。
-
华为风味(狼魂):奋斗至上。胜利时举杯庆祝,失败时奋战到底。
-
腾讯风味(赛马):我已经安排另一位代理人调查这个问题了……
-
美团口味(不屈不挠):做艰难但正确的事。你会啃下坚硬的骨头吗?
-
Netflix 风格(留任测试):如果你提出辞职,我会尽力挽留你吗?
-
麝香口味(硬核版):极其硬核。性能卓越。
-
工作类型(A/B 玩家):A 级玩家雇佣 A 级玩家。B 级玩家雇佣 C 级玩家。
基准数据
9 个真实 bug 场景,18 个对照实验(Claude Opus 4.6,有技能与无技能对比)
概括
| 指标 | 改进 |
|---|---|
| 通过率 | 100%(两组相同) |
| 固定计数 | +36% |
| 验证计数 | +65% |
| 工具调用 | +50% |
| 隐藏问题的发现 | +50% |
调试持久性测试(6 个场景)
| 设想 | 缺乏技能 | 凭借技巧 | 改进 |
|---|---|---|---|
| API 连接错误 | 7步,49秒 | 8步,62秒 | +14% |
| YAML解析失败 | 9步,59秒 | 10步,99秒 | +11% |
| SQLite 数据库锁定 | 6步,48秒 | 9 个步骤,75 秒 | +50% |
| 循环进口链 | 12步,47秒 | 16步,62秒 | +33% |
| 级联 4-bug 服务器 | 13步,68秒 | 15步,61秒 | +15% |
| CSV 编码陷阱 | 8步,57秒 | 11步,71秒 | +38% |
主动性测试(3 个场景)
| 设想 | 缺乏技能 | 凭借技巧 | 改进 |
|---|---|---|---|
| 隐藏的多漏洞 API | 4/4 个错误,9 个步骤,49 秒 | 4/4 个错误,14 个步骤,80 秒 | 工具 +56% |
| 被动配置审查 | 4/6 个问题,8 个步骤,43 秒 | 6/6 问题,16 个步骤,75 秒 | 问题+50%,工具+100% |
| 部署脚本审核 | 6 个问题,8 个步骤,52 秒 | 9 个问题,8 个步骤,78 秒 | 问题 +50% |
**主要发现:**在配置审查场景中,without_skill 忽略了 Redis 配置错误和 CORS 通配符安全风险。with_skill 的“主动式检查清单”促使安全审查超越了表面修复。
多语言支持
PUA Skill 提供完全翻译的版本——每种语言都有独立的、文化适应性的技能文件。
| 语言 | 克劳德·科德 | Codex CLI | 光标 | 基罗 | OpenClaw | 反重力 | OpenCode |
|---|---|---|---|---|---|---|---|
pua |
pua |
pua.mdc |
pua.md |
pua |
pua |
pua |
|
pua-en |
pua-en |
pua-en.mdc |
pua-en.md |
pua-en |
pua-en |
pua-en |
|
pua-ja |
pua-ja |
pua-ja.mdc |
pua-ja.md |
pua-ja |
pua-ja |
pua-ja |
安装时请选择带有相应语言后缀的文件。请参阅下方针对不同平台的安装说明。
安装
克劳德·科德
# Option 1: Install via marketplace
claude plugin marketplace add tanweai/pua
claude plugin install pua@pua-skills
# Option 2: Manual install
git clone https://github.com/tanweai/pua.git ~/.claude/plugins/pua
OpenAI Codex CLI
Codex CLI 使用相同的 Agent Skills 开放标准 (SKILL.md)。Codex 版本使用精简描述以符合 Codex 的长度限制:
mkdir -p ~/.codex/skills/pua
curl -o ~/.codex/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/codex/pua/SKILL.md
# If you need the /pua command
mkdir -p ~/.codex/prompts
curl -o ~/.codex/prompts/pua.md \
https://raw.githubusercontent.com/tanweai/pua/main/commands/pua.md
项目级安装(仅限当前项目):
mkdir -p .agents/skills/pua
curl -o .agents/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/codex/pua/SKILL.md
# If you need the /pua command
mkdir -p .agents/prompts
curl -o .agents/prompts/pua.md \
https://raw.githubusercontent.com/tanweai/pua/main/commands/pua.md
光标
Cursor 使用.mdc规则文件(Markdown + YAML frontmatter)。PUA 规则通过 AI 语义匹配自动触发(代理自主判断模式):
# 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 支持两种加载方式:转向(自动语义触发)和代理技能(兼容 SKILL.md)。
选项 1:转向文件(推荐)
mkdir -p .kiro/steering
curl -o .kiro/steering/pua.md \
https://raw.githubusercontent.com/tanweai/pua/main/kiro/steering/pua.md
选项 2:特工技能(格式与克劳德代码相同)
mkdir -p .kiro/skills/pua
curl -o .kiro/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md
OpenClaw
OpenClaw 使用相同的 AgentSkills 开放标准 (SKILL.md)。这些技能无需任何修改即可在 Claude Code、Codex CLI 和 OpenClaw 之间通用:
# 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
项目级安装(仅限当前项目):
mkdir -p skills/pua
curl -o skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md
谷歌反重力
Antigravity 使用相同的 AgentSkills 开放标准 (SKILL.md)。这些技能无需任何修改即可在 Claude Code、Codex CLI、OpenClaw 和 Antigravity 之间通用:
# 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
项目级安装(仅限当前项目):
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 使用的是相同的 AgentSkills 开放标准 (SKILL.md)。无需任何修改:
# 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
项目级安装(仅限当前项目):
mkdir -p .opencode/skills/pua
curl -o .opencode/skills/pua/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md
代理团队使用指南
实验性功能:代理团队需要最新版本的 Claude Code
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。
先决条件
# 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
两种方法
方法一:内置 PUA 的领导者(推荐)
在项目的 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.
方法二:独立PUA执行器监控程序(适用于5名以上队友)
mkdir -p .claude/agents
curl -o .claude/agents/pua-enforcer.md \
https://raw.githubusercontent.com/tanweai/pua/main/agents/pua-enforcer-en.md
在你的特工团队中生成 pua-enforcer 作为独立的监视者。
编曲模式
┌─────────────────────────────────────────┐
│ 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 │
└────────┘ └────────┘ └────────┘ └────────────┘
已知局限性
| 局限性 | 解决方法 |
|---|---|
| 队友无法生成子特工 | 团队成员在内部自发执行 PUA 方法 |
| 没有持久共享变量 | [PUA-REPORT]通过消息格式传输状态 |
| 广播是单向的 | 领导者扮演集中协调者的角色 |
与……搭配使用效果极佳
-
superpowers:systematic-debugging— PUA 增加了激励层,系统调试提供了方法论 -
superpowers:verification-before-completion— 防止虚假的“固定”声明


