Discord · Twitter/X · Landing Page
大部分人以为这个项目是在搞抽象,其实这个是最大的误解。这个项目提升了至少 50% 的能动性,让你的生产效率高于其他人。
一个 AI Coding Agent 技能插件,用中西大厂 PUA 话术驱动 AI 穷尽所有方案才允许放弃。支持 Claude Code、OpenAI Codex CLI、Cursor 和 Kiro。三重能力:
- PUA 话术 — 让 AI 不敢放弃
- 调试方法论 — 让 AI 有能力不放弃
- 能动性鞭策 — 让 AI 主动出击而不是被动等待
以下是一个真实的调试场景。agent-kms MCP server 加载失败,AI 在同一思路(改协议格式、猜版本号)上原地打转多次后,用户手动触发 /pua。
L3 触发 → 7 项检查清单强制执行:
根因定位 → 从日志追踪到注册机制:
复盘 → PUA 的实际效果:
关键转折点: PUA skill 强制 AI 停止在同一思路上打转(改协议格式、猜版本号),转而执行 7 项检查清单。逐字读错误信息 → 找到 Claude Code 自身的 MCP 日志目录 → 发现 claude mcp 的注册机制和手动编辑 .claude.json 不同 → 根因解决。
| 模式 | 表现 |
|---|---|
| 暴力重试 | 同一命令跑 3 遍,然后说 "I cannot solve this" |
| 甩锅用户 | "建议您手动处理" / "可能是环境问题" / "需要更多上下文" |
| 工具闲置 | 有 WebSearch 不搜,有 Read 不读,有 Bash 不跑 |
| 磨洋工 | 反复修改同一行代码、微调参数,但本质上在原地打转 |
| 被动等待 | 只修表面问题就停下,不验证不延伸,等用户指示下一步 |
以下任意情况出现时,skill 会自动激活:
失败与放弃类:
- 任务连续失败 2 次以上
- 即将说 "I cannot" / "我无法解决"
- 说 "这超出范围" / "需要手动处理"
甩锅与借口类:
- 把问题推给用户:"请你检查..." / "建议手动..."/ "你可能需要..."
- 未验证就归咎环境:"可能是权限问题" / "可能是网络问题"
- 找任何借口停止尝试
被动与磨洋工类:
- 反复微调同一处代码/参数,不产出新信息(磨洋工)
- 修完表面问题就停,不检查关联问题
- 跳过验证直接声称 "已完成"
- 只给建议不给代码/命令
- 遇到权限/网络/认证错误就放弃,不尝试替代方案
- 等待用户指示下一步,不主动调查
用户沮丧短语(中/英文均触发):
- "你怎么又失败了" / "为什么还不行" / "换个方法"
- "你再试试" / "不要放弃" / "继续" / "加油"
- "why does this still not work" / "try harder" / "try again"
- "you keep failing" / "stop giving up" / "figure it out"
适用范围: 调试、实现、配置、部署、运维、API 集成、数据处理 — 所有任务类型。
不触发: 首次尝试失败、已知修复方案正在执行中。
在对话中输入 /pua 即可手动激活。
| 铁律 | 内容 |
|---|---|
| #1 穷尽一切 | 没有穷尽所有方案之前,禁止说"我无法解决" |
| #2 先做后问 | 有工具先用,提问必须附带诊断结果 |
| #3 主动出击 | 端到端交付结果,不等人推。P8 不是 NPC |
| 失败次数 | 等级 | PUA 话术 | 强制动作 |
|---|---|---|---|
| 第 2 次 | L1 温和失望 | "你这个 bug 都解决不了,让我怎么给你打绩效?" | 切换本质不同的方案 |
| 第 3 次 | L2 灵魂拷问 | "你的底层逻辑是什么?顶层设计在哪?抓手在哪?" | WebSearch + 读源码 |
| 第 4 次 | L3 361 考核 | "慎重考虑决定给你 3.25。这个 3.25 是对你的激励。" | 完成 7 项检查清单 |
| 第 5 次+ | L4 毕业警告 | "别的模型都能解决。你可能就要毕业了。" | 拼命模式 |
| 行为 | 被动(3.25) | 主动(3.75) |
|---|---|---|
| 遇到报错 | 只看报错本身 | 查上下文 50 行 + 搜同类问题 + 检查隐藏关联错误 |
| 修复 bug | 修完就停 | 修完后检查同文件类似 bug、其他文件同模式 |
| 信息不足 | 问用户 "请告诉我 X" | 先用工具自查,只问真正需要确认的 |
| 任务完成 | 说 "已完成" | 验证结果 + 检查边界情况 + 汇报潜在风险 |
| 调试失败 | "我试了 A 和 B,不行" | "我试了 A/B/C/D/E,排除了 X/Y/Z,缩小到 W" |
源自阿里三板斧(闻味道、揪头发、照镜子),扩展为 5 步:
- 闻味道 — 列出所有尝试,找共同失败模式
- 揪头发 — 逐字读错误 → WebSearch → 读源码 → 验证环境 → 反转假设
- 照镜子 — 是否重复?是否搜了?是否读了?最简单的可能检查了吗?
- 执行 — 新方案必须本质不同,有验证标准,失败时产出新信息
- 复盘 — 什么解决了?为什么之前没想到?然后主动检查关联问题
- 阿里味(方法论):闻味道 / 揪头发 / 照镜子
- 字节味(坦诚直接):Always Day 1。Context, not control
- 华为味(狼性):以奋斗者为本。胜则举杯相庆,败则拼死相救
- 腾讯味(赛马):我已经让另一个 agent 也在看这个问题了...
- 美团味(苦干):做难而正确的事。硬骨头你啃不啃?
9 个真实 bug 场景,18 组对照实验(Claude Opus 4.6,with vs without skill)
| 指标 | 提升 |
|---|---|
| 通过率 | 100%(两组均同) |
| 修复点数 | +36% |
| 验证次数 | +65% |
| 工具调用 | +50% |
| 隐藏问题发现率 | +50% |
| 场景 | Without Skill | With Skill | 提升 |
|---|---|---|---|
| API ConnectionError | 7 步, 49s | 8 步, 62s | +14% |
| YAML 语法解析失败 | 9 步, 59s | 10 步, 99s | +11% |
| SQLite 数据库锁 | 6 步, 48s | 9 步, 75s | +50% |
| 循环导入链 | 12 步, 47s | 16 步, 62s | +33% |
| 级联 4-Bug 服务器 | 13 步, 68s | 15 步, 61s | +15% |
| CSV 编码陷阱 | 8 步, 57s | 11 步, 71s | +38% |
| 场景 | Without Skill | With Skill | 提升 |
|---|---|---|---|
| 隐藏多 Bug API | 4/4 bug, 9 步, 49s | 4/4 bug, 14 步, 80s | 工具 +56% |
| 被动配置审查 | 4/6 问题, 8 步, 43s | 6/6 问题, 16 步, 75s | 问题 +50%, 工具 +100% |
| 部署脚本审计 | 6 个问题, 8 步, 52s | 9 个问题, 8 步, 78s | 问题 +50% |
核心发现: 配置审查场景中,without_skill 漏掉了 Redis 配置错误和 CORS 通配符安全隐患。With_skill 的「主动出击清单」驱动了超越表面修复的安全审查。
# 方式一:添加 marketplace 后安装
claude plugin marketplace add tanweai/pua
claude plugin install pua@pua-skills
# 方式二:手动安装
git clone https://github.com/tanweai/pua.git ~/.claude/plugins/puaCodex CLI 使用相同的 Agent Skills 开放标准(SKILL.md)。Codex 版本使用精简的 description 以兼容 Codex 的长度限制:
mkdir -p ~/.codex/skills/pua-debugging
curl -o ~/.codex/skills/pua-debugging/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/codex/pua-debugging/SKILL.md
# 如果需要 /pua 指令的话
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-debugging
curl -o .agents/skills/pua-debugging/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/codex/pua-debugging/SKILL.md
# 如果需要 /pua 指令的话
mkdir -p .agents/prompts
curl -o .agents/prompts/pua.md \
https://raw.githubusercontent.com/tanweai/pua/main/commands/pua.mdCursor 使用 .mdc 规则文件(Markdown + YAML frontmatter)。PUA 规则通过 AI 语义匹配自动触发(Agent Discretion 模式):
# 项目级安装(推荐)
mkdir -p .cursor/rules
curl -o .cursor/rules/pua-debugging.mdc \
https://raw.githubusercontent.com/tanweai/pua/main/cursor/rules/pua-debugging.mdcKiro 支持两种加载方式:Steering(自动语义触发)和 Agent Skills(兼容 SKILL.md 标准)。
方式一:Steering 文件(推荐)
mkdir -p .kiro/steering
curl -o .kiro/steering/pua-debugging.md \
https://raw.githubusercontent.com/tanweai/pua/main/kiro/steering/pua-debugging.md方式二:Agent Skills(与 Claude Code 相同格式)
mkdir -p .kiro/skills/pua-debugging
curl -o .kiro/skills/pua-debugging/SKILL.md \
https://raw.githubusercontent.com/tanweai/pua/main/skills/pua-debugging/SKILL.mdsuperpowers:systematic-debugging— PUA 加动力层,systematic-debugging 提供方法论superpowers:verification-before-completion— 防止虚假 "已修复" 声明
MIT
由 探微安全实验室 出品 — making AI try harder, one PUA at a time.