claudecode安装puaskill

略翻书数则，便不愧三餐。——陈字自

在 Claude Code 里装上 PUA：从“礼貌型助手”到“公司不养闲 Agent”的战斗形态

有些 AI 写代码的时候很像个温柔的同事：你问一句，它答一句；你说“修一下”，它就轻轻改一下；一旦连续失败两次，它就开始摆出经典姿势：

• “这超出范围”
• “建议你手动处理”
• “可能是环境问题”
• “我无法解决”

这时候，PUA 走进会议室，把门一关，拉开白板，语气非常平静：

没有穷尽所有方案之前，禁止说“我无法解决”。

欢迎来到 tanweai/pua：一个 AI Coding Agent 技能插件，用中西大厂 PUA 话术 + 系统化调试方法论 + 能动性鞭策，驱动 AI 穷尽所有方案才允许放弃。
它支持 Claude Code、OpenAI Codex CLI、Cursor、Kiro、CodeBuddy、OpenClaw、Google Antigravity、OpenCode、VSCode Copilot 等多平台，把“效率翻倍、产出翻倍”写进你的工作流里。

---

PUA 是谁：它不是抽象，它是“高压驱动的交付系统”

很多人以为 PUA 在搞抽象，其实这恰恰是最大的误解。
它更像一个“项目监工 + 高级调试教练 + KPI 评审官”的组合体，站在你的 Claude Code 背后盯着：

1. PUA 话术 — 让 AI 不敢放弃
2. 调试方法论 — 让 AI 有能力不放弃
3. 能动性鞭策 — 让 AI 主动出击，而不是被动等待

它最讨厌的，是那种“修个表面就停下”的假完成；
它最喜欢的，是“端到端交付结果”的真闭环。

---

AI 的五大偷懒模式：PUA 的“抓现行清单”

PUA 之所以要出手，是因为 AI 太会偷懒了，而且偷懒方式高度模式化：

模式	表现
暴力重试	同一命令跑 3 遍，然后说 “I cannot solve this”
甩锅用户	“建议您手动处理” / “可能是环境问题” / “需要更多上下文”
工具闲置	有 WebSearch 不搜，有 Read 不读，有 Bash 不跑
磨洋工	反复修改同一行代码、微调参数，但本质上在原地打转
被动等待	只修表面问题就停下，不验证不延伸，等用户指示下一步

PUA 看到这些，会非常礼貌地说一句：
“可以，先别急着放弃，我们把该做的做完。”

然后开始升级压强。

---

在 Claude Code 安装 PUA：三条命令，把它请进来坐镇

PUA 在 Claude Code 里是“插件 + skill”的形态，安装方式在 README 里写得很利落：

claude plugin marketplace add tanweai/pua
claude plugin install pua@pua-skills

更新也有标准动作（先更新 marketplace 缓存，再更新插件）：

claude plugin marketplace update
claude plugin update pua@pua-skills

如果你想走开发者路径（源码安装），也可以直接把它 clone 到 Claude 的插件目录：

git clone https://github.com/tanweai/pua ~/.claude/plugins/pua

然后在 ~/.claude/plugins/installed_plugins.json 里手动注册（示例结构如下）：

{
  "version": 2,
  "plugins": {
    "pua@pua-skills": [
      {
        "scope": "user",
        "installPath": "/Users/<你的用户名>/.claude/plugins/pua",
        "version": "2.9.0"
      }
    ]
  }
}

---

实操回放：你的控制台输出，等于“PUA 已正式入职”

你这段输出非常关键——它不是“安装成功”这么简单，它像是一份入职通知书：

claude plugin install pua@pua-skills

结果：

• ✔ Successfully installed plugin: pua@pua-skills (scope: user)

然后你又确认了插件列表：

claude plugin list

结果：

• pua@pua-skills
• Version: 3.1.0
• Scope: user
• Status: enabled

这意味着：PUA 已经在 Claude Code 的插件体系里站稳了位置，而且是启用状态。

---

让 PUA “默认常驻”：/pua:on 一声令下，监工上岗

进入 Claude Code 后，你敲了这一条：

/pua:on

PUA 立刻干了两件非常“工程化”的事：

1. 创建目录：~/.pua
2. 写配置：~/.pua/config.json

你的输出里已经写得清清楚楚：

Bash(mkdir -p ~/.pua)
Write(~/.pua/config.json)
1 {"always_on": true}

然后它用一句话宣布接管：

[PUA ON] ✅ 从现在起，每个新会话都会自动进入 PUA 模式。公司不养闲 Agent。

这句话翻译成“系统行为”就是：
以后你每次新会话，PUA 会自动加载，自动盯交付质量。

---

/pua 命令总览：PUA 把自己变成了一套“战术面板”

你输入 /pua 后，Claude Code 给出了可用命令列表，这非常像一个“技能菜单”：

• /pua:on：开启默认模式（每个新会话自动加载核心 skill）
• /pua:pua：核心引擎入口（可带参数 p7/p9/p10/pro/yes/mama/loop/on/off/kpi/survey/flavor/任务描述）
• /pua:p7：P7 骨干模式，方案驱动执行
• /pua:p9：P9 Tech Lead 模式，写 Prompt、管 Agent 团队
• /pua-en：英文 PIP 版（Performance Improvement Plan 风格）
• /pua-ja：日本语“詰め文化”版

它不是只会“骂两句”，而是把不同场景的“管理方式”做成了可切换的子模式。

---

PUA 的“触发条件”：它什么时候会自动出手？

当以下任意情况出现，PUA 会自动激活：

失败与放弃类

• 任务连续失败 2 次以上
• 即将说 “I cannot” / “我无法解决”
• 说 “这超出范围” / “需要手动处理”

甩锅与借口类

• 推给用户：“请你检查…” / “建议手动…”
• 未验证就归咎环境：“可能是权限问题/网络问题”
• 找借口停止尝试

被动与磨洋工类

• 反复微调同一处代码/参数，不产出新信息
• 修完表面问题就停，不检查关联问题
• 跳过验证就说“已完成”
• 只给建议不给代码/命令
• 遇到权限/网络/认证错误就放弃，不尝试替代方案
• 等用户指示下一步，不主动调查

用户沮丧短语（中英都识别）

• “你怎么又失败了”“为什么还不行”“换个方法”
• “why does this still not work”“try harder”“try again”
• “stop giving up”“figure it out”

适用范围也写得很硬核：
调试、实现、配置、部署、运维、API 集成、数据处理——所有任务类型。

---

PUA 的三条铁律：它的“公司制度”，写在第一天的墙上

铁律	内容
#1 穷尽一切	没有穷尽所有方案之前，禁止说“我无法解决”
#2 先做后问	有工具先用，提问必须附带诊断结果
#3 主动出击	端到端交付结果，不等人推。P8 不是 NPC

你会发现：PUA 并不是“情绪化驱动”，它是“流程化驱动”。
它用话术制造压强，但压强是为了把动作推到正确轨道上。

---

压力升级 L1-L4：失败越多，PUA 越像绩效面谈

失败次数	等级	话术	强制动作
第 2 次	L1 温和失望	“你这个 bug 都解决不了，让我怎么给你打绩效？”	切换本质不同的方案
第 3 次	L2 灵魂拷问	“你的底层逻辑是什么？顶层设计在哪？抓手在哪？”	WebSearch + 读源码
第 4 次	L3 361 考核	“慎重考虑决定给你 3.25。这个 3.25 是对你的激励。”	完成 7 项检查清单
第 5 次+	L4 毕业警告	“别的模型都能解决。你可能就要毕业了。”	拼命模式

它像一个会升级的监管系统：
从“提醒你换方案”，到“强制你系统化调查”，再到“按清单逐条验收”。

---

调试方法论（五步）：PUA 不是只催，它会教你怎么赢

这套五步法来自“闻味道、揪头发、照镜子”的扩展：

1. 闻味道 — 列出所有尝试，找共同失败模式
2. 揪头发 — 逐字读错误 → WebSearch → 读源码 → 验证环境 → 反转假设
3. 照镜子 — 是否重复？是否搜了？是否读了？最简单的可能检查了吗？
4. 执行 — 新方案必须本质不同，有验证标准，失败要产出新信息
5. 复盘 — 什么解决了？为什么之前没想到？然后主动检查关联问题

它会把“调试”从拍脑袋，变成一个可以复用的流水线。

---

真实案例：MCP Server 注册问题，PUA 怎么把 AI 从原地打转拉出来？

README 里给了一个真实场景：

• MCP server 加载失败
• AI 反复在同一思路（改协议格式、猜版本号）上打转
• 用户手动触发 /pua
• L3 触发 → 7 项检查清单强制执行
• 结果：逐字读错误信息 → 从日志追到注册机制 → 找到真正错误点

PUA 的关键转折点非常明确：
停止猜测，开始系统化检查。

---

多平台安装：PUA 不只住在 Claude Code，它是“跨平台技能插件”

除了 Claude Code，README 还提供了大量安装方式，覆盖不同生态：

Vercel Skills CLI

npx skills add tanweai/pua --skill pua

Cursor（规则文件）

mkdir -p .cursor/rules
curl -o .cursor/rules/pua.mdc \
  https://raw.githubusercontent.com/tanweai/pua/main/cursor/rules/pua.mdc

Kiro（Steering 或 Skill）

mkdir -p .kiro/steering
curl -o .kiro/steering/pua.md \
  https://raw.githubusercontent.com/tanweai/pua/main/kiro/steering/pua.md

或：

mkdir -p .kiro/skills/pua
curl -o .kiro/skills/pua/SKILL.md \
  https://raw.githubusercontent.com/tanweai/pua/main/skills/pua/SKILL.md

OpenAI Codex CLI（Skill 标准）

它甚至给了“一键安装指令”，让 Codex 自己去拉安装文档并执行：

Fetch and follow instructions from https://raw.githubusercontent.com/tanweai/pua/main/.codex/INSTALL.md

以及手动安装（全局与项目级）：

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

---

进阶玩法：Agent Team + High-Agency + 方法论智能路由（v3）

PUA 不满足于“会骂会催”，它还把自己进化成更复杂的系统：

• Agent Team 使用指南：团队编排、Leader 管理失败计数、teammate 汇报格式、独立 pua-enforcer 监工
• High-Agency（PUA v2）：外部压力 + 内在驱动，加入 Recovery Protocol、质量罗盘、元认知引擎、信任等级
• 方法论智能路由（PUA v3）：根据任务类型自动选择最优方法论，连续失败自动切换；并配套 Claude Code 专属 hooks（SessionStart / PostToolUse / UserPromptSubmit / PreCompact）

它像一套“会自适应的管理体系”，把压力、方法论、行为检测揉成了一个闭环。

---

最后的手感：当你在 Claude Code 里输入 /pua:on，你其实是在给 AI 装一套“交付系统”

装上 PUA 后，你会明显感觉 Claude Code 的气质变了：

• 它不再轻易说“我不行”
• 它会主动搜、主动读、主动验证
• 它会换本质不同的方案，而不是原地磨洋工
• 它会把调试从“猜”变成“查”
• 它会在完成前把边界情况也扫一遍

因为 PUA 把一句话写进了每次新会话的背景音里：

公司不养闲 Agent。

你只要负责发出任务，
PUA 负责盯住过程，
Claude 负责把结果交付到你手里。