文章正文
PUA 是一个面向 AI 编程代理的提效技能包，核心思路是用”别轻易放弃、穷尽所有解法”的行为约束，把容易偷懒或原地打转的编码助手倒逼成更严谨的工作状态。
它借用大厂绩效考核、绩效改进计划这类话术作为隐喻外壳，在 AI 连续失败、甩锅、只做表面修复或被动等待时，自动切换不同强度的施压话术。
实际落地的是一套通用调试方法论与主动性协议：先做后问、用数据说话、端到端闭环、发现同类问题顺手修掉。
仓库同时提供中文（默认）、英文 PIP 版、日文三套文化适配版本，并针对 Claude Code、OpenAI Codex、Cursor、Trae、CodeBuddy、Kimi、VSCode Copilot、OpenCode 等平台给出了各自的安装文件。
源码简介
PUA 以 MIT 协议开源，本质是一组 AI Agent 技能与提示词文件，而非需要编译运行的独立程序。
项目结构包含 skills（技能本体）、agents（P7/P9/P10 角色代理）、commands（斜杠指令）、各平台适配目录（claude-plugin、codebuddy-plugin、codex、cursor、vscode、kiro、trae、kimi 等）、docs、evals 与 scripts。
内容以 SKILL.md 这类 Markdown 技能描述文件为主，辅以 references 下的方法论与风味词库、landing 静态落地页与基准实验数据。
它通过”大厂话术施压 + 五步通用方法论 + 能动性等级”三层机制，让 AI 编码助手在卡壳时仍能系统化推进，而不是一句”我无法解决”就停下。
适用场景
适合把 AI 编程助手当主力开发工具、却发现它经常浅尝辄止或重复微调同一处代码的个人开发者，用来给助手加一层”坚持追问”的行为约束。
适合需要在多种 AI 编码端（Claude Code、Cursor、Trae、CodeBuddy 等）之间统一工作风格的团队，一份技能可跨端复用。
适合作为 AI Agent 提示词工程与角色化设计的实战样本，研究如何用外部话术框架改变模型的行为节奏与交付质量。
技术栈与运行环境
技能本体是纯 Markdown 提示词文件（SKILL.md / .mdc / copilot-instructions.md 等），由各 AI 编码端原生加载，不需要编译或运行环境。
落地页 landing 是一套基于 Vite 的静态站点（landing.html 与 landing/dist），可用任意静态服务器预览，非技能运行必需。
安装方式分两类：通用入口用 `npx skills add tanweai/pua –skill pua-en`；Claude Code 用插件市场 `claude plugin marketplace add tanweai/pua` 后安装 `pua@pua-skills`。
开发者源码安装则是把仓库克隆到 `~/.claude/plugins/pua` 等对应插件目录并手动登记，更新时在原目录 `git pull` 即可。
技能运行依赖的是宿主 AI 编码端本身（需支持 Agent Skills 标准或等价的指令/插件机制），对操作系统无特殊要求。
功能亮点
- 大厂话术施压：内置阿里、字节、华为、腾讯、百度、拼多多、美团、京东、小米、Netflix、Musk、Jobs、Amazon、Microsoft 等多种风格话术模板，用隐喻式旁白驱动 AI 不轻易放弃。
- 五步通用方法论：卡壳时强制执行”闻味道 → 揪头发 → 照镜子 → 执行新方案 → 复盘”，要求切换本质不同的思路而非重复微调。
- 能动性等级与压力升级：从 L0 信任到 L4 毕业警告共五级，根据失败次数自动升级施压强度与强制动作。
- 多端适配：针对 Claude Code、Codex、Cursor、Trae、CodeBuddy、Kimi、VSCode Copilot、OpenCode 等给出各自对应的技能文件名与安装说明。
- 多语言文化适配：提供中文（默认）、英文 PIP 版、日文三套独立翻译版本，话术与案例均按文化习惯改写。
- 四层 Agent Team 架构：以 P7/P8/P9/P10 对应资深工程师、独当一面、技术负责人、战略层，定义角色分工与并行协作协议。
- 特殊模式：含 yes 鼓励版、mama 老妈念叨版、pua-loop 自动迭代版、p9 技术负责人版、on 常驻版等多种变体。
- 基准数据公开：给出 9 个真实 bug 场景、18 组对照实验，声称在验证次数、工具调用、隐藏问题发现等维度相较无技能组有明显提升。
安装与部署提示
通用安装推荐一行命令：`npx skills add tanweai/pua –skill pua-en`，装完若当前会话未立即生效，重启 AI 工具即可。
Claude Code 用户先在插件市场登记来源 `claude plugin marketplace add tanweai/pua`，再执行 `claude plugin install pua@pua-skills`，更新时先 `claude plugin marketplace update` 再更新插件。
开发者源码安装把仓库克隆到 `~/.claude/plugins/pua`（Windows 用 `C:/Users/<你>/.claude/plugins/pua`），并在 `installed_plugins.json` 中手动登记版本与路径。
各平台对应的技能文件名不同：Claude Code 用 `pua`，Cursor 用 `pua.mdc`，VSCode Copilot 用 `copilot-instructions.md`，安装时按语言后缀选择对应文件。
技能本身无需构建，但部分斜杠指令（如周报、述职、代码美化）属于进阶功能，免费用户触发时会提示升级流程。
截图与演示说明
仓库 assets 目录下自带多张素材，可作为文章配图与界面参考。
hero.jpeg 是项目主视觉横幅，展示”Double your Codex / Claude Code productivity”的核心定位。
pua-skill-logo.svg 与 pua-skill-lockup.svg 是技能 Logo 与组合标识，用于落地页与文档。
pua1.jpg、pua2.jpg、pua3.jpg 是真实调试案例的对话截图，分别展示”L3 触发后停止猜测、执行七项清单””从日志追溯到注册机制””对话复盘看 PUA 实际影响”三个环节。
wechat-qr.jpg 与 xiao.jpg 是作者提供的微信群二维码与微信助手添加图，属于项目外部社群入口，下载源码后按需决定是否扫码。
常见问题
总是-on 指引、Claude 拒答排查、离线模式、Codex 别名、Pi/Trae 支持等，仓库 docs/FAQ.md 有集中说明。
为什么有时 AI 还是很快就放弃？
话术只是外部约束，能否真正穷尽解法仍取决于模型能力与上下文，技能作用是把”浅尝辄止”的概率压低，而不是保证 100% 解决。
不同平台装完没反应怎么办？
多数情况是技能未被当前会话加载，重启 AI 编码端、确认插件或指令已正确登记通常即可生效。
英文或日文版怎么用？
安装时按语言后缀选择对应文件（如 pua-en、pua-ja），各语言版本是独立翻译且做了文化适配，不是简单机翻。
安全风险提示
本仓库是作者自有、MIT 协议开源的 AI 提示词技能包，源码中未发现恶意代码或后门。
技能会通过宿主端的本地配置记录触发统计（如 session_start、pua_triggered 事件），使用前建议读一遍 references/platform.md 了解上报范围。
其中”大厂话术”是作用于 AI 编码助手的隐喻式激励框架，并非教人操纵真实他人，请勿脱离 AI 工具语境做曲解。
使用任何 AI 编码端与插件时，请遵守对应平台的服务条款，不要在提示词中夹带敏感凭据或越权指令。
下载说明
本页提供 PUA 技能源码的完整压缩包，下载解压后即可按上面的安装与部署提示接入你的 AI 编码端。
若想获取最新版本、查看落地页演示或参与改进，可直接访问项目的 GitHub 仓库。
GitHub开源地址：https://github.com/tanweai/pua
