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 點檢查清單（閉合迴路、以事實為基礎、耗盡一切等）。
主動性強制	修復錯誤後，代理必須掃描相關程式碼、執行建置／測試並驗證修復，而非僅回覆「完成」。

支援平台

• 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. 助手返回更全面的解決方案，常能發現隱藏的錯誤或設定問題。

安裝快照

# 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；未推斷任何額外功能。