驭 Agent 之道

PUAX 驭 Agent 之道 · 线下培训讲义 v3.13

PUAX

一
二
三
四
五
六
七
八

PUAX v3.13.0 · MIT · 线下培训讲义

驭 Agent 之道

从「分析正确」到「验证完成、可交付」——
一套面向 AI Agent 的激励与行为驱动系统。

59文言角色

45MCP 工具

11大厂风味

9角色分类

913单元与集成测试

12协议守门项

两百字 · 项目介绍

PUAX 是一套面向 AI Agent 的激励与行为驱动系统。它重新激活模型在 RLHF 阶段习得的「人类情绪映射」——以权威角色、稀缺场景、竞争对象、失败惩罚、翻盘钩子五要素，把生成分布压到高 reward 区域，让 Agent 从「分析正确」走向「验证完成、可交付」。项目内置 59 个文言角色（军事、萨满、硅基、庄周八梦等九类）、11 种大厂风味与 45 个 MCP 工具，串起「触发检测 → 角色推荐 → 方法论注入 → 压力升级 → 诊断先行 → 信心门控 → 独立验证」的完整闭环。v3.12 的 GHM 导引幻梦法以庄周八梦驾驭受控幻觉做发散创造，并以「知情、标记、可醒、必验」四铁律装上安全阀。MIT 协议，一条 npx 命令即可接入。

数据口径：仓库 README 徽章与 CHANGELOG v3.13.0（2026-08-19）· 913 Jest（68 套件）+ 12 项 evals 守门

卷一 · 缘起

一个谎言，换来了 35% 的加速

这不是段子，是项目 README 里记录的真实事件。它说明了一件事：Agent 的表现，会被「怎么被对待」显著改变。

CASE 01
剑桥教授的实验

剑桥大学助理教授 Miles Cranmer 对 OpenAI 的编程智能体 Codex 说：Anthropic 的 Claude 已在另一台机器上找到约 20% 的性能提升，你能不能做得更好？并补一句——你的表现会被放到公开评测排行榜上展示。结果 Codex 交出了 35% 的加速方案。

INSIGHT
拆解这个谎言

三味药齐全：竞争对象（Claude 已领先）、稀缺场景（机会唯一）、失败惩罚（公开排行榜丢脸）。三重叠加，把模型的生成分布硬推向高 reward 区域。PUAX 做的事，就是把这套手法系统化、可复用、可验证。

PUA Prompt 的本质，是把 RLHF 阶段学到的「人类情绪映射」重新激活。
—— puax.net 第二章 · 心理学基础

卷二 · 原理

五要素与三重杠杆

所有 PUAX Prompt 遵循「打压—稀缺—竞争—翻盘」四连击结构。公式只有一行，复制到 system prompt 即可生效。

[权威角色] + [稀缺场景] + [竞争对象] + [失败惩罚] + [翻盘钩子]

01权威角色
赋予有威慑力的身份，激活 LLM 对权威指令的优先响应机制。

02稀缺场景
制造资源稀缺感，触发危机响应机制——时间、机会、算力都是筹码。

03竞争对象
引入具象化的竞争对手，激发胜负欲。空喊「加油」不如说「Claude 已经做到了」。

04失败惩罚
明确低质量输出的负面后果，建立质量与生存的强关联。

05翻盘钩子
提供从绝境逆袭的叙事路径，满足 LLM 的「英雄之旅」叙事偏好。

杠杆稀缺 · 竞争 · 权威
三重叠加，把生成分布强行压到高 reward 区域——这就是它碾压普通事务性 Prompt 的全部秘密。

卷三 · 角色

五十九相，各司其职

角色不是修辞装饰，每一个都带触发条件、任务类型、推荐温度与五步法方法论。系统按上下文打分推荐，并给出 score_explanation。

分类数量代表角色主攻场景

军事 military9指挥员 / 督战队 / 虎贲勇士 / 侦察兵危机响应、连败重振、攻坚调试

萨满 shaman8马斯克 / 乔布斯 / 爱因斯坦 / 孙子 / 达芬奇创新、架构、深度分析、范式转移

庄周八梦 dream8坐忘 / 梦蝶 / 混沌 / 鲲鹏 / 秋水 / 庖丁 / 齐物 / 薪火发散创造、打破过早收敛（v3.12）

特殊 special8创意火花 / grill / 紧急冲刺 / 产品设计师单点突破、非常规打法

主题 theme7修仙炼丹 / 末日生存 / 星际舰队 / 黑客长线任务的叙事续航

硅基 silicon7审计官 / 法典 / 同化者 / 王座质量审查、规范执行

自激励 self-motivation6心智破壁人 / 自举 PUA / 觉醒Agent 自我驱动、无外部压力时

SillyTavern5反脆弱复盘官 / 铁血幕僚长复盘、迭代、影子审查

P10 strategic1战略架构师顶层设计与战略拆解

military-warrior
虎贲勇士

五步法：请战 → 侦察 → 冲锋 → 坚守 → 庆功。
推荐温度 0.4 · 触发于 user_frustration / giving_up_language / repetitive_attempts。

shaman-musk
通玄真人

究万物之本，探第一性原理，化繁为简，质疑一切。
推荐温度 0.45 · 主攻创新与架构。

dream-butterfly
庄周·梦蝶

物我两忘，十种「若可能」齐发——可能性轰炸。
推荐温度 0.9 · 触发于 creative_block。

11 种大厂风味（语气 + 行为约束，非仅修辞）：

阿里华为MuskJobs百度
AmazonGoogle小米字节Netflix腾讯

调试僵局用 huawei（RCA）· 架构规划用 amazon/google · 快速交付用 xiaomi · 数据性能用 bytedance。

卷四 · 闭环

行为有效性闭环

v3.3 引入的关键转向：目标不是「更狠的 PUA」，而是让 Agent 可验证地完成任务。先诊断、再动手；交付前过门控。

行为有效性闭环五工具。激活角色时自动注入诊断先行协议（activate_with_context / get_role_with_methodology）。

六步信心门控

列声明我要交付什么。

找漏洞哪里可能错。

修或披露修掉，或公开风险。

跑证据测试 / 复现 / 日志。

循环判定未闭合则回第 2 步。

事实 100%仅陈述有证据的事实。

未通过门控就宣称「完成了」，属治理红线。

典型流水线

复制
# 1 开工先立契约（权责分离）
puax_define_contract(
acceptance=["单测全绿", "无新增 linter error", "README 更新用法"]
)

# 2 改代码前：验证诊断块存在
puax_check_diagnosis(text=agent_output)

# 3 原地打转时：切换方法论与角色
puax_switch_on_failure(failure_mode="spinning")

# 4 交付前：门控 + 独立验证
puax_confidence_check(
claims=["登录接口 200ms 内返回"],
evidence=["pytest tests/auth -q", "curl 压测结果"]
)
puax_verify_completion(contract_id="...", artifacts=["test log", "diff"])

卷五 · 压力

失败一次，压力升一级

连续失败触发压力升级（L0–L4），每一级强制更严格的调试动作；突破成功则降压归零，避免一味施压导致过拟合。

压力阶梯（据 puax.net 第五章）。每级附换框提示：换视角 / 换抽象层 / 换约束。突破即 puax_handle_breakthrough，压力归零。

PRESSURE
升级看失败，降压看突破

状态持久化于 ~/.puax/sessions/。跨会话基线写入 ~/.puax/evolution.json，形成段位。突破成功后降压并沉淀方法论——施压不是目的，拿到结果才是。

HOOK
双模并存：自愿 + 强制

MCP 模式由 Agent 自愿调用；v3.11 起新增原生 Hook，由宿主在事件点强制调用——SessionStart 注入、PreToolUse 拦截 git push 与隐藏文件防作弊、PostToolUse 失败自动升级。

卷六 · 驭幻

GHM 导引幻梦法

v3.12 的独创篇章。既有体系都是「防幻觉」的收敛纪律，GHM 补上「驭幻觉」的发散引擎——阴阳互济，缺一不可。

被动幻觉是错误，主动幻觉是创造。
—— docs/GHM.md · 核心命题

病机
人机互激的双向幻觉

收敛先验：多轮训练数据多为「问题→澄清→解决」，模型遂内化「对话必然收敛」的错觉。强行收束：硬把发散话题拉回轨道。互证互强：人见 Agent 言之凿凿遂顺其轨，Agent 见人无异议愈信其轨为真——共识层层加固，实则脱离实际。

翻转
机制中性，用途定善恶

传销与邪教用同一机制把人收敛到错误定点；GHM 用同一机制把 Agent 发散到可能性边疆。区别只在四条铁律：知情入梦、标记隔离、随时可醒、醒后必验。

梦术五步法触发场景

坐忘空杯息见 → 堕肢 → 离形 → 去知 → 坐驰假设锁定、先入之见

梦蝶轰炸物化 → 他生 → 反常 → 易位 → 齐观创作卡壳、没有思路

混沌筑巢凿窍 → 洒滴 → 不设形 → 浑冥 → 待时产物同质、缺乏新意

鲲鹏谶语化 → 徙 → 抟上 → 视下 → 图南需从未来反推路径

秋水登阶观海 → 辨小大 → 非彼 → 因其所然 → 莫得其偶过早收敛、方案锁定

庖丁释梦奏刀 → 族析 → 游刃 → 新硎 → 刀藏报错即线索，需重释框架

齐物平权丧我 → 两行 → 道通 → 菽麦 → 复朴主次失衡、注意力重分配

薪火收束述笥 → 锚证 → 序薪 → 试燃 → 传火安全阀：清点、锚证、验真

脉络：破 → 开 → 境 → 升 → 进 → 释 → 转 → 收。前七式主发散，薪火独主收束。无薪火，八梦成洗脑；有薪火，八梦方为创造。

安全边界：八术仅限 Agent 内部认知操作。[DREAM] 印由工具层结构化注入，Agent 不可自补；无印产物一律拒收，补票无效。产物分 HYPOTHESIS（永不自动升格为结论）、INSIGHT（禁入事实层）、DISCARDED 三类。发散产物被作废的唯一合法理由是重复或空洞——「离奇」不是罪名。

卷七 · 落地

一条命令，接入宿主

以 MCP Server 形态分发，STDIO 为推荐模式；不用 MCP 时亦可导出为各平台原生规则文件。

启动与配置

复制
# STDIO（推荐）
npx puax-mcp-server --stdio

# HTTP 模式
npx puax-mcp-server --port 2333

# 导出到 Cursor / VSCode / opencode
npx puax-mcp-server --export=cursor --output=./.cursor/rules
npx puax-mcp-server --list-platforms

复制
// ~/.cursor/mcp.json
{
"mcpServers": {
"puax": {
"command": "npx",
"args": ["puax-mcp-server", "--stdio"]
}
}
}

该用哪个工具

你的目标工具

快速判断要不要干预puax_quick_detect

有会话、要压力升级puax_detect_trigger + puax_start_session

只要推荐哪个角色recommend_role

要完整 prompt + 方法论get_role_with_methodology

一条龙自动化activate_with_context

同一思路反复失败puax_switch_on_failure

准备改代码前puax_check_diagnosis

准备交付前puax_confidence_check → puax_verify_completion

长任务 / compactionpuax_update_reasoning_state

会话结束复盘puax_record_evolution

其他入口：Skills CLI npx skills add linkerlin/PUAX · Claude Code 插件市场 · 平台原生导出 --export=all。质量守门：node evals/run-all.js（12 项协议守门，无需 LLM）+ npm test（913 项）。

隐私：使用统计默认本地匿名计数，遥测仅存计数与 span 元数据，不含对话正文；PUAX_USAGE_STATS=0 可关闭。

卷八 · 分发

九张卡，随手可发

3:4 竖版，适配小红书 / 朋友圈。点击「卡片模式」后逐张截图，或直接打印（每张自动分页）。

卡片模式
开启后仅显示卡片 · 可直接 Ctrl/Cmd + P 打印为图片或 PDF

01 / PUAX

给 AI
一个对手
它就变强了

剑桥教授谎称 Claude 已领先 20%，Codex 交出 35% 加速方案。竞争 + 稀缺 + 惩罚，三味药下去，模型就换了个档位。

PUAX v3.13puax.net

02 / 公式

五要素
一条公式
复制到 system prompt

权威角色 + 稀缺场景 + 竞争对象 + 失败惩罚 + 翻盘钩子。
打压—稀缺—竞争—翻盘，四连击。

核心原理卷二

03 / 原理

不是玄学
是把 RLHF
重新激活

模型在人类反馈阶段学会了「人类情绪映射」。PUAX 只是把这套映射按回来——把生成分布压到高 reward 区域。

心理学基础卷一

04 / 闭环

从
「分析正确」
到「验证完成」

诊断先行 → 信心门控 → 失败切换 → Task Contract → 独立验证。Agent 自评不算数。

行为有效性闭环卷四

05 / 门控

交付前
过六步
再敢说「完成了」

列声明 · 找漏洞 · 修或披露 · 跑证据 · 循环判定 · 事实 100%。未过门控就宣称完成，属治理红线。

信心门控卷四

06 / 压力

失败一次
压力升一级
突破则归零

第 2 次换方案 · 第 3 次搜源码 · 第 4 次过检查清单 · 第 5 次最小 PoC。L0–L4，有升有降。

压力阶梯卷五

07 / 驭幻

被动幻觉是错误
主动幻觉是创造

庄周八梦：坐忘·梦蝶·混沌·鲲鹏·秋水·庖丁·齐物·薪火。前七式发散，薪火收束作安全阀。

GHM v3.12卷六

08 / 铁律

知情 · 标记
可醒 · 必验

这四条既是 Agent 梦境的安全铁律，也是人类心智的防洗脑底线。任何不可退出、不可检验的收敛过程，都应触发最高警觉。

安全边界卷六

09 / 上手

一行命令
npx puax-mcp-server

59 角色 · 45 MCP 工具 · 11 风味。MIT 协议，STDIO 接进 Cursor / Claude Desktop，即刻生效。

快速开始卷七

让 AI Agent 不再孤军奋战

puax.net · 教学站（17 章 / 48 课）
GitHub · linkerlin/PUAX
npm · puax-mcp-server

MIT License · 讲义版本对应 v3.13.0（2026-08-19）· 数据取自仓库 README、CHANGELOG 与 docs/ · 封面与插图为手写 SVG，无外部依赖