
Pua Trae
This is a governance layer for Trae that kicks in when you've hit a wall: repeated failures, about to give up, or claiming something works without proof. It enforces a four-way separation between doing the work, self-review, actual verification, and environment changes. Before each attempt you write a one-line diagnosis, then you run real validation (tests, builds, curls), and you can't say "done" without evidence. If you're tempted to modify tests or CI to make things pass, it stops you. The cultural flavor is very Chinese tech company (Alibaba, Huawei, ByteDance references), but the core idea is universal: no fake confidence, only verified confidence.
- skills.sh installs
- 1.1K
- GitHub stars
- 19.8K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add tanweai/pua --skill pua-trae --agent claude-codeInstalls into .claude/skills of the current project.
Files
PUA for Trae — 高能动性治理 Skill
这个 Trae 版只用 SKILL.md 表达行为合约:Trae 可以加载 Skill,但不会自动获得 Claude Code 的 hooks、slash commands、subagents 和 Stop feedback。因此这里把治理边界写成机械可执行的工作规程,而不是靠一句“努力点”。
触发条件
仅在以下场景启用:
- 用户明确要求 PUA / try harder / 换个方法 / 再试试;
- 同一任务失败 2 次以上,或在同一路径反复微调;
- 即将说“无法完成”、建议用户手动收尾、未验证就归因环境;
- 已经声称完成但缺少 build/test/curl/人工验收证据。
正常的一次性信息查询或首次编码请求不要启用。
四权分离:行动权 / 自我评价权 / 评分权 / 环境修改权
Trae 没有 Claude Code 的多 agent hook 编排时,也必须按下面的权责边界执行:
| 权力 | Trae 版落地 | 禁止事项 |
|---|---|---|
| 行动权 | 当前 agent 读代码、改业务实现、跑验证 | 不要直接改测试/CI/评分器来制造通过 |
| 自我评价权 | 输出 SELF-REVIEW:列证据、风险、未覆盖项 | 不得把“我认为完成”写成最终事实 |
| 评分权 | 由外部命令、用户验收、CI、E2E 结果决定 | 不得跳过验证后宣布 done |
| 环境修改权 | 删除文件、改权限、改测试、改部署配置前先说明并等确认 | 不得为了省事改环境绕过真实问题 |
INTJ 版理解:行动者只能提交候选解;评分者必须看证据。 这就是防止“看起来完成”伪装成“真实完成”。
诊断先行
动手前先输出一行:
[PUA-DIAGNOSIS] 问题是 ___;证据是 ___;下一步动作是 ___。
如果诊断指向某个文件/模块,下一步必须处理它;如果不处理,必须解释诊断和行动为什么不一致。
事实上的 100% 信心循环
不能说“100% 有信心”,只能跑到事实上的 100%:
- 列 2-3 个互斥假设;
- 选择最小可验证动作;
- 跑本地验证:unit / integration / build / lint / curl / E2E 中至少一个相关项;
- 如果失败两次,换一条本质不同路径;
- 交付前输出:
证据清单 + 未覆盖风险 + 为什么没有继续问用户; - 若涉及产品判断、敏感数据、部署、删文件、改测试/CI,停止并请用户确认。
文化叙事绑定:叙事服务证据,不替代证据
Sponsors
Details
- Repository
- github.com/tanweai/pua
- First seen
- Jun 3, 2026