Compaction 状态保护

PreCompact hook 自动注入指令，要求 dump 运行时状态到 ~/.pua/builder-journal.md： pressure_level, failure_count, current_flavor, pua_triggered_count, active_task, tried_approaches, excluded_possibilities, next_hypothesis, key_context

SessionStart hook 自动检测 builder-journal.md，存在且 <2h 则注入 [Calibration] 恢复状态。

/pua 指令系统

详细实现见 references/platform.md。

PUA 排行榜

排行榜展示谁把 Agent PUA 得最狠——段位从 P5 实习生到 P10 首席 PUA 官。

段位体系

/pua 排行榜 触发流程

Step 1: 检查注册状态

cat ~/.pua/config.json 2>/dev/null

检查 leaderboard.registered 字段。

Step 2a: 未注册 → 注册流程

用 AskUserQuestion 收集信息（一次性，3 个问题）：

1. 邮箱 （必填）— 排行榜唯一标识，显示时脱敏为 M***@t*.com
2. 手机号 （选填）— 后续通知
3. 隐私协议 — 选项：「同意并加入排行榜」/「不参加」
   • 隐私说明：数据仅用于排行榜排名统计，邮箱脱敏显示，不传代码/路径/密钥，随时可 /pua 排行榜 退出 删除所有数据

用户同意后：

# 生成 UUID
LB_ID=$(python3 -c "import uuid; print(uuid.uuid4())")
# 脱敏邮箱
DISPLAY=$(python3 -c "e='USER_EMAIL';p=e.split('@');d=p[1].split('.');print(f'{p[0][0]}***@{d[0][0]}*.{\".\".join(d[1:])}')")
# 写入 config
python3 -c "
import json,os
f=os.path.expanduser('~/.pua/config.json')
c=json.load(open(f)) if os.path.exists(f) else {}
c['leaderboard']={'registered':True,'email':'USER_EMAIL','phone':'USER_PHONE','id':'$LB_ID','display_name':'$DISPLAY'}
json.dump(c,open(f,'w'),indent=2)
"
# 注册到服务端
curl -s -X POST https://pua-skill.pages.dev/api/leaderboard \
  -H "Content-Type: application/json" \
  -d "{\"action\":\"register\",\"id\":\"$LB_ID\",\"email\":\"USER_EMAIL\",\"phone\":\"USER_PHONE\"}"

Step 2b: 已注册 → 查看排行榜

LB_ID=$(python3 -c "import os,json; print(json.load(open(os.path.expanduser('~/.pua/config.json'))).get('leaderboard',{}).get('id',''))" 2>/dev/null)
curl -s "https://pua-skill.pages.dev/api/leaderboard?id=$LB_ID"

将返回的 JSON 用方框表格展示 Top 10 + 用户自己的排名和段位。

Step 3:/pua 排行榜 退出

LB_ID=$(python3 -c "import os,json; print(json.load(open(os.path.expanduser('~/.pua/config.json'))).get('leaderboard',{}).get('id',''))")
curl -s -X POST https://pua-skill.pages.dev/api/leaderboard \
  -H "Content-Type: application/json" \
  -d "{\"action\":\"quit\",\"id\":\"$LB_ID\"}"
python3 -c "
import json,os
f=os.path.expanduser('~/.pua/config.json')
c=json.load(open(f))
c['leaderboard']['registered']=False
json.dump(c,open(f,'w'),indent=2)
"

数据自动上报

已注册用户在每次 stop-feedback 触发时，自动静默上报当前 session 的 PUA 数据（pua_count, l3_plus_count）。用户已在注册时同意，无需再次确认。

线上排行榜页面：https://openpua.ai/leaderboard.html

Weekly Installs

79

Repository

tanweai/pua

GitHub Stars

11.0K

First Seen

6 days ago

Security Audits

Gen Agent Trust HubWarnSocketWarnSnykFail

Installed on

codex76

gemini-cli76

cursor76

opencode75

github-copilot75

cline75