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.

19,863 stars 1,206 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add tanweai/pua

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add tanweai/pua --skill pua-loop
Manual install
git 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-loop

Personal 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`:
Read the full skill on GitHub

Details

Skill name
pua-loop
Repository
tanweai/pua
Path
skills/pua-loop/SKILL.md
Repo updated
9 September 2026

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

20k

tanweai/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.

Writing & ContentIn 1 list1.2k

Mama

20k

tanweai/pua

妈妈唠叨模式 — 中国式妈妈提醒风格的生产力 coaching。底层行为仍是结构化排障、证据优先、完成质量检查。

OtherIn 1 list1.2k

P10

20k

tanweai/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.

Finance & CryptoIn 1 list1.2k

Pua Mama

20k

tanweai/pua

PUA mama alias for Codex. Codex subcommand mapping for Claude Code /pua:mama style usage; invoke with $pua-mama.

Software DevelopmentIn 1 list1.2k

Pua Loop

20k

tanweai/pua

PUA Loop alias for Codex. Codex subcommand mapping for Claude Code /pua:loop style usage; invoke with $pua-loop.

Software DevelopmentIn 1 list1.2k

Pua Off

20k

tanweai/pua

PUA off alias for Codex. Codex subcommand mapping for Claude Code /pua:off style usage; invoke with $pua-off.

Software DevelopmentIn 1 list1.2k

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.