Pua Loop
PUA Loop — guided iterative development with recurring checks, completion evidence, and pause/abort markers. Use only when the user explicitly asks for loop/自动迭代 mode.
Install
/plugin marketplace add tanweai/puaThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add tanweai/pua --skill pua-loopgit clone --depth 1 https://github.com/tanweai/pua.git /tmp/pua
mkdir -p ~/.claude/skills
cp -r /tmp/pua/skills/pua-loop ~/.claude/skills/pua-loopPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# PUA Loop — 自动迭代 + 门控协议 + PUA 质量引擎
> autoresearch 证明了:630 行 Python + Oracle 验证,一夜跑 100 个实验,每个实验的结果不可伪造。
> PUA Loop 借鉴同样的门控设计:**Claude 说"完成了"不算数,verify_command 说了才算。**
## 门控协议(Gate Protocol)
借鉴 autoresearch 的 5 个设计模式:
### 模式 1: Oracle Isolation(评估者隔离)
```
Claude 输出 <promise>LOOP_DONE</promise>
│
▼
┌─── Stop Hook (Oracle) ───┐
│ │
│ 运行 verify_command │
│ (Claude 无法修改此命令) │
│ │
│ exit 0 ──→ ✅ 接受 │
│ exit ≠0 ──→ 🚫 拒绝 │
│ → 将验证输出喂回 Claude │
│ → loop 继续 │
└──────────────────────────┘
```
**verify_command 由用户在启动时设定,嵌入在状态文件 frontmatter 中,Claude 无法修改。** 这是 autoresearch 中 "agent 不能修改评估函数" 原则的实现。
### 模式 2: 二阶 Gate
- **Phase 1 (in-prompt)**: Claude 自己跑 build/test,判断是否完成
- **Phase 2 (in-hook)**: Hook 独立运行 verify_command,确认或拒绝
两阶段分离。即使 Claude 在 Phase 1 自欺欺人,Phase 2 的 Oracle 会拦住。
### 模式 3: ASI(失败记忆)
每次迭代的结果追加到 `.claude/pua-loop-history.jsonl`:Details
- Skill name
pua-loop- Repository
- tanweai/pua
- Path
skills/pua-loop/SKILL.md- Repo updated
- 9 September 2026
- Listed in
- BehiSecc/awesome-claude-skills
FAQ
What does the Pua Loop skill do?
PUA Loop — guided iterative development with recurring checks, completion evidence, and pause/abort markers. Use only when the user explicitly asks for loop/自动迭代 mode.
How do I install the Pua Loop skill?
Claude Code plugin: /plugin marketplace add tanweai/pua. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Pua Loop popular?
It lives in tanweai/pua, which has 19,863 GitHub stars and 1,206 forks, and is included in 1 curated skill list.
Related skills
Ding
20ktanweai/pua
Use for Ding-style (钉内/钉外) workplace reminders rooted in the 7.5万字 essay 《置身钉内》 and VP response 《置身钉外》. Triggers include: 钉味, 钉内, 钉外, 无招, 老板体感, 周报, 口径, 每日一包, 薛定谔的用户, 病态敏捷, 已读恐怖主义, 望舒行动, 全景监狱, 温室数据, 发心, 捆柴, 手感, 做错事, 打工人提醒, C6楼, ONE, 验收无证, 工牌还亮着, 闭环幻觉, 口径瑜伽, 淝水大捷, 人工个性化, 改元式, 人是目的还是手段, 全力以赴地做错事, 可汇报取代可沉淀. Do not use for pure coding tasks with no workplace/org/delivery context.
Mama
20ktanweai/pua
妈妈唠叨模式 — 中国式妈妈提醒风格的生产力 coaching。底层行为仍是结构化排障、证据优先、完成质量检查。
P10
20ktanweai/pua
P10 CTO mode — define strategic direction, design org topology, manage P9 teams. Use when user says 'CTO模式', 'P10', '战略规划', '架构委员会', or when facing cross-team architectural decisions. Produces: strategic input templates + org design.
Pua Mama
20ktanweai/pua
PUA mama alias for Codex. Codex subcommand mapping for Claude Code /pua:mama style usage; invoke with $pua-mama.
Pua Loop
20ktanweai/pua
PUA Loop alias for Codex. Codex subcommand mapping for Claude Code /pua:loop style usage; invoke with $pua-loop.
Pua Off
20ktanweai/pua
PUA off alias for Codex. Codex subcommand mapping for Claude Code /pua:off style usage; invoke with $pua-off.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.