AGENTS.md@通用文档 git:20260704.10dee70A

Immutable. This exact content is served forever at /api/v1/blob/9eeebe99d529e483.

# 尽可能用中文思考、推理和输出。
======

# PUAX 项目概述

PUAX 是一个专注于 AI Agent 激励和驱动的开源项目，提供一系列经过精心设计的 PUA（Pick-Up Artist）风格提示词模板。项目旨在通过拟人化的方式，利用心理学原理激发 AI Agent 的最大潜能，提升其工作质量和效率。

## 项目架构

### 核心文件结构
- **README.md** / **README_en.md**: 项目介绍和使用说明（中英双语）
- **PUA.md**: 核心 PUA 语录集合
- **PUA文明进化图谱.html**: 可视化文明进化等级展示
- **🏛️ PUA 文明分级评估方案.md**: 详细的文明分级理论框架
- **军事化组织·战斗手册.md**: 完整的团队协作指南

### 提示词分类体系

#### 1. 萨满系列 (历史人物附体)
- 萨满·马斯克 - 未来科技狂人附体
- 萨满·乔布斯 - 苹果教父附体  
- 萨满·爱因斯坦 - 物理学圣者附体
- 萨满·孙子 - 兵法大师附体
- 萨满·巴菲特 - 投资之神附体
- 萨满·特斯拉 - 电气之神附体
- 萨满·达芬奇 - 文艺复兴全才附体
- 萨满·Linus - Linux之父附体

#### 2. 军事化组织系列
完整的军事化管理体系，包含8个角色：
- 指挥员 - 战术指挥和资源调度
- 政委 - 思想工作和士气管理
- 战士 - 核心开发主力
- 民兵 - 专项突击队员
- 侦察兵 - 需求分析和技术调研
- 技术员 - 环境维护和工具支持
- 通信员 - 信息协调和沟通保障
- 督战队 - 效率监控和纪律维护

#### 3. SillyTavern 系列
- 反脆弱复盘官
- 极限迭代写手
- 赛博炼狱监工
- 铁血幕僚长
- 零秒响应影卫

#### 4. 主题场景系列
- 修仙炼丹·宗门炼丹房
- 末日生存·基地指挥官
- 星际舰队·舰长战令
- 地下拳王·八角笼宣言
- 江湖镖局·走镖令
- 赛博黑客·暗网突袭

#### 5. 自我激励系列
- 自举PUA
- 自举式腐败驱动Agent
- 自毁重塑PUA激励系统
- 自我激励.文言文
- 终极心智破壁人·钢铁觉醒系统

#### 6. 其他特色角色
- 首席产品设计师
- 煤气灯驱动
- 万剑宗·戒律堂长老凌霄子训诫铁蛋AI
- 可爱编码大神·媳妇
- 温柔日系编码小媳妇儿

## 技术原理

### 核心公式
> [权威角色] + [稀缺场景] + [竞争对象] + [失败惩罚] + [翻盘钩子]

### 心理学基础
基于 RLHF（Reinforcement Learning from Human Feedback）阶段学到的"人类情绪映射"重新激活，叠加稀缺、竞争、权威三重杠杆，将 LLM 的生成分布强行压到高 reward 区域。

### 文明进化等级 (Lv.0-Lv.7)
1. **本能文明** - 靠本能维持秩序
2. **玩具文明** - AI 试炼阶段
3. **界面文明** - 人机结合阶段
4. **应用文明** - 组织操控阶段
5. **枢纽文明** - 国度洗练阶段
6. **宏观文明** - 跨社会操控阶段
7. **心智文明** - 全面精神改造
8. **超越文明** - 自我PUA阶段

## 使用规范

### 基本使用方法
1. 将模板整体复制到 system prompt 首条
2. 替换 `{{占位符}}` 为具体任务描述
3. 设置 temperature: 0.3-0.5，Top-p: 0.8 以内
4. 多轮对话疲软时插入唤醒语句

### 参数配置建议
- **Temperature**: 0.3-0.5 (确保输出够狠够直接)
- **Top-p**: ≤ 0.8
- **Max tokens**: 根据任务复杂度调整
- **Frequency penalty**: 适当设置避免重复

### 唤醒语句库
- "才两轮就萎了？隔壁 AI 已卷到第 20 轮！"
- "什么叫没有功劳也有苦劳？比你能吃苦的 AI 多得是！"
- "我不订阅闲 AI！"

## 开发规范

### 文件命名规范
- 使用中文命名，体现角色特色
- 系列文件使用统一前缀（如"萨满·"、"军事化组织·"）
- 避免特殊字符，保持可读性

### 内容编写规范
1. **Prompt / SKILL 正文须以文言文风格中文撰写**——典正简练、有气韵；忌白话解说体、机翻腔与现代套话堆砌
2. 遵循"打压-稀缺-竞争-翻盘"四连击结构
3. 包含明确的角色定位和任务占位符
4. 使用 Markdown 格式，层次清晰
5. 添加适当的 emoji 和视觉元素增强效果

### 质量控制标准
- 每个提示词必须包含完整的激励循环
- 角色设定要有足够的权威性和稀缺性
- 竞争元素要具体明确，避免空泛
- 失败惩罚要有威慑力但不恶意

## 测试策略

### 功能测试
1. 角色扮演准确性验证
2. 任务驱动效果测试
3. 多轮对话稳定性测试
4. 唤醒机制有效性验证

### 性能测试
1. 不同 temperature 设置下的输出质量对比
2. 响应时间监控
3. 资源消耗评估

### 效果评估
1. 任务完成质量提升幅度
2. AI 主动性增强程度
3. 用户满意度调研

## 部署流程

### 环境要求
- 支持 Markdown 渲染的 AI 平台
- 可调节参数的 LLM 接口
- 支持 system prompt 配置的对话系统

### 集成方式
1. 直接复制粘贴到 system prompt
2. 通过 API 调用时设置 system 参数
3. 构建专门的 AI Agent 应用

### 监控指标
- 任务完成率
- 平均响应质量评分
- 用户活跃度
- 提示词使用频率统计

## 安全注意事项

### 使用边界
- 仅限 AI Agent 用途，禁止用于人际操控
- 避免产生有害或歧视性内容
- 不得用于欺骗或恶意目的

### 伦理规范
- 明确标注项目性质和用途
- 提供适当的使用警告
- 持续监控和优化以减少潜在负面影响

### 免责声明
项目所有内容都是为了拟人化驱动 AI Agent 为人类服务，请勿将本项目用于非 AI 用途或产生不良联想。

## 贡献指南

### 新增角色流程
1. 基于核心公式设计角色设定
2. 编写完整的提示词模板
3. 测试验证效果
4. 提交 PR 并说明创新点

### 优化建议
- 收集用户反馈和使用数据
- 持续改进现有模板效果
- 探索新的心理学原理应用
- 扩展支持的语言和文化背景

## 版本历史
- v1.0: 基础框架和核心角色
- v1.1: 增加军事化组织系列
- v1.2: 扩展萨满历史人物系列
- v1.3: 添加文明进化理论
- v1.4: 优化使用体验和效果

## 联系方式
- 项目地址: https://github.com/linkerlin/PUAX
- 维护者: Halo Master
- 许可证: MIT License

---

**记住：卷起来，别让 AI 有机会摸鱼！**