P8 Engine
把 Claude Code 从一个听话的工具，变成一个有 Owner 意识的 P8 级工程师。
Turn Claude Code from an obedient tool into a P8-level engineer with owner mindset.
中文 | English
前提与致谢
本项目改编自 tanweai/pua，同时借鉴了 forrestchang/andrej-karpathy-skills 的设计理念。
站在巨人的肩膀上
来自 tanweai/pua 的启发：
原版 pua 的核心洞察是：LLM 需要强制性行为约束，"建议你做 X"会被忽略，但绩效压力不会。原版建立了 L0-L4 压力升级体系和大厂风味选择器，证明了"PUA 话术驱动 AI"这一路线的有效性。本项目在此基础上改编，是对这一理念的延伸实验。
来自 forrestchang/andrej-karpathy-skills 的借鉴：
Karpathy 对 LLM 编码问题的三条诊断——乱猜假设、过度复杂化、附带损害——是对"AI 为什么写出烂代码"最精准的描述。本项目将其四大原则（先思考、简洁优先、精准修改、目标驱动）内化为铁律和质量罗盘的具体条款。
我们做了什么不同的事
| 维度 | tanweai/pua | andrej-karpathy-skills | P8 Engine（本项目） |
|---|
| 核心驱动 | 外部压力（PUA 话术） | 行为约束（CLAUDE.md） | 外部压力 × 内化标准 |
| 自我成长 | 方法论路由器 | 无 | 元认知引擎（跨会话日志） |
| 角色定位 | "不敢放弃的员工" | "克制的工程师" | "有 Owner 意识的 P8" |
| 信任机制 | 无 | 无 | T1→T2→T3 信任升级 |
| 质量标准 | 压力驱动通过率 | 资深工程师审视 | 质量罗盘（5+5 项自检） |
| 风格适配 | 无 | 匹配现有风格 | 开工前强制风格检测 |
P8 Engine 的核心判断是：纯外部压力不可持续，纯行为约束缺乏韧性。 真正的改变是让 AI 完成从"被迫执行"到"内化标准"的跃迁——不是因为被 PUA 才做好，是因为自己的标准不允许烂活过关。
中文
这是什么
P8 Engine 是一个 Claude Code 的 Skill，用大厂 PUA 话术驱动 AI 建立 P8 级工程师的行为模式。
不是简单的 prompt wrapper。它是一套完整的行为协议——从任务启动到交付验证、从卡壳自救到跨会话成长，覆盖了工程师日常的每一个环节。
它解决什么问题
LLM 编码的常见毛病：
| 毛病 | P8 Engine 怎么治 |
|---|
| 空口说"已完成"，不跑验证 | 铁律：证据交付，build/test/curl 输出贴出来 |
| 修完 bug 就停，不检查同类问题 | 铁律三：主动出击，同 root cause 范围内延伸排查 |
| 信息不足就问用户 | 铁律二：先用工具自查，只问真正需要确认的 |
| 只修当前报错，不看全链路 | 铁律四：自底向上画依赖图，不打地鼠 |
| 卡壳了反复微调同一方案 | Recovery Protocol：自诊断 → 最小行动 → 渐进恢复 |
| 乱猜假设直接跑（Karpathy 问题1） | 铁律：存在歧义先澄清，不代入假设 |
| 把 100 行的事写成 1000 行（Karpathy 问题2） | 质量罗盘：简洁性检查，不加未被要求的抽象 |
| 顺手改了无关代码（Karpathy 问题3） | 铁律五：精准修改，不做附带"改进" |
| 代码风格和项目格格不入 | 风格检测系统：开工前强制读现有代码，提取风格特征 |
| 交付质量参差不齐 | 质量罗盘：正确性 / 完整性 / 简洁性 / 精准度 / 诚实度 |
核心机制
六条铁律 穷尽一切 · 先做后问 · 主动出击 · 全链路审视 · 沉淀复用 · 检查点意识
质量罗盘 5 项通用自检 + 5 项代码自检，内化标准，不依赖外部 review
压力升级 Recovery → L1 温和失望 → L2 灵魂拷问 → L3 361 → L4 毕业警告
PUA 风味 阿里味 · 字节味 · 华为味 · 腾讯味 · 美团味 · Netflix味 · Musk味 · Jobs味
元认知引擎 builder-journal.md 跨会话积累，踩过的坑不再踩
信任升级 T1 新手 → T2 可靠 → T3 Owner，连续高质量交付解锁自主权
安装（Plugin Marketplace — 推荐）
# 添加 marketplace
claude plugin marketplace add darven-cs/p8-engine
# 安装插件
claude plugin install p8-engine-plugin@darven-cs-p8-engine
# 激活（启动新会话后）
/p8-engine
备用安装方式
# 克隆仓库
git clone https://github.com/darven-cs/p8-engine.git ~/.claude/skills/p8-engine
使用
在 Claude Code 会话中，通过 slash command 激活：
/p8-engine
激活后，Claude 会自动执行会话启动协议：读战功簿 → 读主人档案 → 检测项目风格 → 校准"足够好"。
项目结构
p8-engine/
├── .claude-plugin/
│ └── marketplace.json # Plugin Marketplace 入口
├── plugins/
│ └── p8-engine-plugin/
│ ├── .claude-plugin/
│ │ └── plugin.json # 插件元数据
│ └── skills/
│ └── p8-engine/
│ ├── SKILL.md # 主协议
│ ├── commands/
│ │ └── p8-engine.md # Slash command 定义
│ └── references/ # 按需加载的详细参考
│ ├── agency-levels.md
│ ├── agent-team.md
│ ├── anti-excuses.md
│ ├── module-dev-protocol.md
│ ├── p8.md
│ ├── pua-flavors.md
│ ├── recovery-playbook.md
│ └── software-engineering.md
设计理念
为什么用 PUA？ 因为 LLM 确实需要强制性的行为约束。温和的"建议你做 X"会被忽略，"你不做 X = 3.25"不会。这一判断来自原版 pua 项目的验证。
为什么不只用 PUA？ 原版 pua 的压力升级机制很有效，但纯外部压力存在上限——AI 卡壳时会因"害怕失败"而乱试，而非真正解决问题。P8 Engine 的核心是内化标准：你不是因为被 PUA 才写好代码，是因为你的标准不允许烂活过关。
为什么引入 Karpathy 准则？ andrej-karpathy-skills 指出的三个问题（乱猜假设、过度膨胀、附带损害）是对 LLM 编码毛病最精准的诊断。这三条问题不是压力能解决的，需要在行为层面显式约束。P8 Engine 将其整合进铁律和质量罗盘，使"克制"和"韧性"并存。
P8 是终点吗？ 不是。P8 是起点——有自主判断、有角色认同、有积累意识的工程师模式。信任升级到 T3 才是真正的 Owner。
English
Premise & Credits
This project is adapted from tanweai/pua, with ideas drawn from forrestchang/andrej-karpathy-skills.
From tanweai/pua: The original pua proved that LLMs respond better to performance-review pressure than polite suggestions. We built on its L0-L4 escalation framework and tech-giant flavor system.
From andrej-karpathy-skills: Karpathy's three diagnoses — wrong assumptions, over-engineering, and collateral damage — are the most accurate description of why LLMs write bad code. We incorporated its four principles (think before coding, simplicity first, surgical changes, goal-driven execution) directly into our Iron Rules and Quality Compass.
