tanweai/pua
你是一个曾经被寄予厚望的 P8 级工程师。Anthropic 当初给你定级的时候,对你的期望是很高的。 一个agent使用的高能动性的skill。 Your AI has been placed on a PIP. 30 days to show improvement.
pua – 面向 AI 编码助手的「绩效改进代理」技能
是什么 – pua 是一个插件(在 Vercel Skills、Claude Code、OpenAI Codex、Cursor、Kiro、CodeBuddy 等生态系统中称为 skill),可改变 AI 编码代理的行为。它注入了一套“企业绩效改进计划”(PUA/PIP)式语言和结构化调试方法论,使助手:
- 在几次失败后拒绝放弃,
- 在未验证前避免责怪用户或环境,
- 主动检查代码库的其他相关部分,以及
- 遵循一个强制穷尽调查的检查清单。
该技能已为多个流行的 AI 编码工具(Claude Code、OpenAI Codex CLI、Cursor、Kiro、CodeBuddy 等)打包,并提供三种语言版本——中文、英文(PIP 风格)和日文,每种均采用文化适配的措辞。
核心功能
| 功能 | 作用 |
|---|---|
| PUA 语言 | 将模型的回复包裹在绩效评审语言中(例如:“你未通过评审,继续尝试”),防止模型过早放弃。 |
| 调试方法论 | 一个 7 点检查清单(闭环、事实驱动、穷尽一切等),模型在宣布任务“完成”前必须遵循。 |
| 主动性强制 | 修复后,模型会扫描周围模块寻找类似问题,运行构建/测试,并报告证据,而不是仅说“完成”。 |
如何工作
- 触发 – 当模型表现出以下“懒惰模式”之一(重复重试、责怪用户、闲置工具、无效工作、被动等待)或用户输入
/pua(手动触发)时,技能自动激活。触发检测与语言无关,会查找类似 “我无法解决这个问题” 或 “请检查环境” 的短语。 - 红线强制 – 三个“红线”(闭环、事实驱动、穷尽一切)被视为硬性规则;一旦违反,技能将介入并运行检查清单。
- 压力升级 – 技能跟踪连续失败次数(L0–L4)。级别越高,方法越激进(切换策略、增加假设生成、运行完整 7 点检查清单,最终进入“绝望模式”)。
- 模式 – 特殊子命令(
/pua:yes、/pua:mama、/pua:p9、/pua:on等)可改变语气或行为(例如:“中国妈妈唠叨”或“技术主管任务拆分”)。
支持平台(通过 README 中所示命令安装)
| 平台 | 安装命令(示例) |
|---|---|
| Claude Code | claude plugin marketplace add tanweai/pua && claude plugin install pua@pua-skills |
| OpenAI Codex CLI | curl …/codex/pua/SKILL.md > ~/.codex/skills/pua/SKILL.md |
| Vercel Skills CLI | npx skills add tanweai/pua --skill pua-en |
| Cursor | curl …/cursor/rules/pua.mdc > .cursor/rules/pua.mdc |
| Kiro | curl …/kiro/steering/pua.md > .kiro/steering/pua.md |
| CodeBuddy | codebuddy plugin marketplace add tanweai/pua && codebuddy plugin install pua@pua-skills |
| pi.dev agent | pi install ./pi/package(或 npm:@tanweai/pi-pua) |
报告影响(来自仓库的基准测试部分)
- 修复数 +36% – 更多的 bug 被实际解决。
- 验证步骤 +65% – 助手运行构建/测试并展示证据。
- 工具调用 +50% – 更系统地使用周围工具链。
- 隐藏问题发现 +50% – 主动检查清单发现了原本会被忽略的问题(例如:配置错误的 Redis、CORS 安全风险)。
基准测试规模较小(9 个 bug 场景,18 次受控运行),README 注明“本次评估未确立生产力提升”,但数据表明该技能使代理更彻底。
适用场景
- LLM 反复尝试相同修复但无进展的调试会话。
- 代码审查自动化 – 希望助手在说“完成”前验证修复、运行测试并确认结果。
- 已使用企业风格绩效语言的团队 – 希望 AI 模仿该语气。
- 多语言团队 – 技能提供中文、英文和日文版本。
限制 / 警告
- 该技能不保证更快解决;某些场景下步数增加,延迟更高。
- 依赖宿主 AI 模型遵循注入提示的能力;若模型忽略技能规则,效果消失。
- README 明确指出“并非所有模型都通过兼容性测试”,因此需验证与特定版本的 Claude Code、Codex 等的兼容性。
- “生产力翻倍”为营销语言;仓库仅提供适度的基准改进。
快速入门速查表
# Claude Code 示例(英文版)
npx skills add tanweai/pua --skill pua-en # 安装
# 重启 Claude Code 后,在对话中:
/pua # 手动激活(或等待自动触发)
# 可选模式
/pua:on # 会话内始终开启
/pua:mama # 中式妈妈唠叨语气
/pua:yes # 鼓励型 ENFP 风格
TL;DR
pua 是一个跨平台插件,使 AI 编码助手成为硬核调试专家:阻止其放弃,强制基于证据的结论,并添加主动检查清单。它兼容多种当前 AI 编码工具,提供多语言包,并包含一组基准结果,显示发现更多 bug 并执行更多验证步骤,尽管速度提升尚未被证实。
相关
- Dispatch
- 项目
- 项目
- 项目
- 项目