tanweai/pua

pua – 一种让基于 LLM 的代码助手持续努力的「AI 编码代理」技能

是什么

• 可添加到多种 AI 编码助手（Claude Code、OpenAI Codex CLI、Cursor、Kiro、CodeBuddy、OpenClaw、Google Antigravity、OpenCode、VS Code Copilot 等）的插件/技能包。
• 该技能注入一组「PUA」（绩效改进计划 / 企业话术）规则，使助手表现得更具韧性：拒绝放弃、避免责怪用户，并主动排查隐藏问题。
• 规则以各平台可读的语言特定「技能文件」（SKILL.md、.mdc、.json 等）形式表达，可自动触发行为，也可通过 /pua 等命令手动调用。

核心理念

理念	如何工作
PUA 话术	用绩效评审语言包装助手的内部提示（例如：“在说‘做不到’之前必须穷尽所有可能的解决方案”）。
调试方法论	当检测到重复失败时，助手遵循的 7 项检查清单（闭合回路、基于事实、穷尽一切等）。
主动性强制	修复 bug 后，代理必须扫描相关代码、运行构建/测试并验证修复，而不是简单回复“完成”。

支持平台

• Claude Code（插件市场）
• OpenAI Codex CLI（SKILL.md 标准）
• Cursor（pua.mdc）
• Kiro（引导文件或 SKILL.md）
• CodeBuddy、OpenClaw、Google Antigravity、OpenCode、VS Code Copilot、pi.dev、Trae – 均通过相同技能定义支持。

主要特性

• 当助手连续两次失败、开始责怪用户或表现出“忙于表面工作”模式时自动触发。
• 通过 /pua（或 /pua:on、/pua:off、/pua:loop 等）命令手动触发。
• 多语言包支持 – 中文（阿里巴巴/字节跳动/华为风格）、英文（PIP/亚马逊风格）、日文，每种均采用文化适配的表达方式。
• 特殊模式 – 鼓励模式、“中国妈妈”式唠叨、技术主管委派、始终启用强制。
• README 中的基准数据声称，相比基准 Claude Opus 4.6 运行，修复数量更高、验证步骤更多、工具调用次数更多。

典型使用流程

1. 为首选的编码助手安装该技能（例如：npx skills add tanweai/pua --skill pua-en）。
2. 像往常一样进行调试或实现任务。
3. 若助手开始放弃或重复相同方法，该技能将自动激活，运行 7 项检查清单，并强制模型探索替代假设、查阅日志并验证结果。
4. 助手返回更全面的解决方案，常能发现隐藏的 bug 或配置问题。

安装快照

# Claude Code
claude plugin marketplace add tanweai/pua
claude plugin install pua@pua-skills

# Codex CLI（单行）
curl -o ~/.codex/skills/pua/SKILL.md \
  https://raw.githubusercontent.com/tanweai/pua/main/codex/pua/SKILL.md

（其他平台遵循相同模式——将适当的规则文件复制到工具的技能目录中。）

限制 / 注意事项

• 该技能本质上是提示工程的覆盖层；它不会在底层 LLM 已有功能之外增加新的代码分析能力。
• 报告的性能提升基于作者的内部基准测试；未提供独立验证。
• 由于强制模型持续尝试，运行时间可能增加（例如，“被动配置审查”测试显示更多步骤和更长总时间）。
• 重的企业话术风格可能对部分用户而言显得嘈杂或过于严格。

谁可能受益

• 严重依赖 AI 编码助手进行调试，希望模型避免过早“我无法解决”退出的开发者。
• 在 CI 类工作流中使用 Claude Code、Codex CLI 或类似代理的团队，需要更系统化、验证密集型行为的团队。
• 对在提示层面对 LLM 代理进行“绩效评审”式训练感兴趣的用户。

---

以上所有信息均直接取自仓库的 README；未推断任何额外功能。