mirror of
https://github.com/tanweai/pua.git
synced 2026-09-01 15:39:55 +08:00
feat: add issue templates + CONTRIBUTING.md
- Bug report / Feature request / Question templates - config.yml: disable blank issues, link to guide + Telegram - CONTRIBUTING.md: issue classification rules, theory base reference, anti-AI-analysis-dismissal policy, auto-ban for abuse
This commit is contained in:
@@ -0,0 +1,59 @@
|
||||
# Contributing to PUA Skill
|
||||
|
||||
感谢你对 PUA Skill 的关注!以下是提交 Issue 和 PR 的规范。
|
||||
|
||||
## Issue 提交规范
|
||||
|
||||
### 1. 必须归类
|
||||
|
||||
每个 Issue 必须使用模板并选择正确的类型:
|
||||
|
||||
| 类型 | 前缀 | 用途 |
|
||||
|------|------|------|
|
||||
| Bug | `bug:` | 功能异常、命令不触发、hook 报错 |
|
||||
| Feature | `feat:` | 新功能、新味道、新平台支持 |
|
||||
| Question | `question:` | 使用疑问(提问前请先查阅 [Guide](https://openpua.ai/guide.html)) |
|
||||
|
||||
不符合归类规范的 Issue 将被关闭并要求重新提交。
|
||||
|
||||
### 2. 关于 "PUA 话术是否有效" 的讨论
|
||||
|
||||
PUA Skill 的理论基础已在我们的研究博客中系统阐述:
|
||||
|
||||
**[Emotion/Persona Prompting 对 AI Agent 效果的系统性分析](https://openpua.ai/blog/emotion-persona-prompting.html)**
|
||||
|
||||
核心结论:
|
||||
- PUA Skill 85-90% 的效果来自**结构化行为约束**(checklist、escalation protocol、验证步骤),而非情感修辞
|
||||
- PUA 话术("3.25"、"毕业"等)的真正作用是**注意力锚定和行为路由信号**,不是"激发 AI 的情感"
|
||||
- 这一结论基于 20+ 篇顶会论文(ACL/EMNLP/ICML/IJCAI)的系统梳理
|
||||
|
||||
**以下类型的 Issue 不会被接受:**
|
||||
- 仅凭 AI 工具(ChatGPT/Claude/Gemini 等)分析本项目代码后得出"PUA 话术对 LLM 无效"的结论来否定项目价值。我们已经在上述博客中对这个问题做了比任何 AI 摘要更深入的分析,包括 EmotionPrompt/Persona Prompting 的局限性、Anthropic Persona Vectors 的机制差异、以及 PUA 话术作为 routing signal 的量化分解
|
||||
- 没有提供**新的实验数据或论文引用**、仅靠观点否定的 Issue
|
||||
|
||||
**欢迎的讨论方式:**
|
||||
- 带有自己的 A/B 实验数据的效果质疑(如 [PR #82](https://github.com/tanweai/pua/pull/82) 的 SM skill 就是很好的范例)
|
||||
- 引用我们博客中未覆盖的新论文
|
||||
- 基于具体场景的改进建议
|
||||
|
||||
### 3. 社区行为准则
|
||||
|
||||
**以下行为将导致自动化处理:**
|
||||
- 对项目或维护者的攻击、辱骂、人身攻击 → Issue 将被自动关闭,账号将被永久拉黑
|
||||
- 垃圾信息、广告、无关内容 → 自动关闭
|
||||
- 重复提交已关闭的 Issue → 自动关闭
|
||||
|
||||
我们使用自动化工具监控 Issue 内容。恶意行为零容忍。
|
||||
|
||||
## PR 提交规范
|
||||
|
||||
- 每个 PR 解决一个问题,不要混合多个无关改动
|
||||
- PR 标题使用 conventional commit 格式:`fix:` / `feat:` / `chore:` / `docs:`
|
||||
- 如果改了核心 SKILL.md,请说明改动的理由和预期效果
|
||||
- 如果改了多个平台的文件(cursor/kiro/vscode/codex),请确保内容同步
|
||||
|
||||
## 联系方式
|
||||
|
||||
- Telegram: https://t.me/+wBWh6h-h1RhiZTI1
|
||||
- Discord: https://discord.gg/EcyB3FzJND
|
||||
- Email: minwei.wang@tanweai.com
|
||||
@@ -0,0 +1,23 @@
|
||||
---
|
||||
name: Bug Report
|
||||
about: 报告功能异常 / Report a bug
|
||||
title: "bug: "
|
||||
labels: bug
|
||||
---
|
||||
|
||||
## 问题描述 / Description
|
||||
<!-- 一句话说清楚什么坏了 -->
|
||||
|
||||
## 复现步骤 / Steps to Reproduce
|
||||
1. 安装方式:`marketplace` / `git clone` / `Fetch and follow`
|
||||
2. 执行的命令:
|
||||
3. 期望结果:
|
||||
4. 实际结果:
|
||||
|
||||
## 环境 / Environment
|
||||
- Claude Code 版本:
|
||||
- OS:macOS / Linux / Windows
|
||||
- 安装方式:
|
||||
|
||||
## 截图 / 日志(如有)
|
||||
<!-- 粘贴截图或错误日志 -->
|
||||
@@ -0,0 +1,8 @@
|
||||
blank_issues_enabled: false
|
||||
contact_links:
|
||||
- name: 使用问题 / Usage Questions
|
||||
url: https://openpua.ai/guide.html
|
||||
about: 使用问题请先查阅新手教程 / Check the guide before asking
|
||||
- name: 社区讨论 / Community
|
||||
url: https://t.me/+wBWh6h-h1RhiZTI1
|
||||
about: 加入 Telegram 群讨论 / Join Telegram for discussions
|
||||
@@ -0,0 +1,15 @@
|
||||
---
|
||||
name: Feature Request
|
||||
about: 请求新功能 / Request a new feature
|
||||
title: "feat: "
|
||||
labels: enhancement
|
||||
---
|
||||
|
||||
## 功能描述 / Description
|
||||
<!-- 你希望 PUA Skill 增加什么功能? -->
|
||||
|
||||
## 使用场景 / Use Case
|
||||
<!-- 什么场景下你需要这个功能? -->
|
||||
|
||||
## 你考虑过的替代方案 / Alternatives
|
||||
<!-- 有没有其他方式可以实现? -->
|
||||
@@ -0,0 +1,16 @@
|
||||
---
|
||||
name: Question / 使用疑问
|
||||
about: 提问前请先查阅 Guide / Check guide before asking
|
||||
title: "question: "
|
||||
labels: question
|
||||
---
|
||||
|
||||
## 问题 / Question
|
||||
<!-- 你遇到了什么疑问? -->
|
||||
|
||||
## 你已经尝试过的 / What you've tried
|
||||
<!-- 查阅了哪些文档?试过哪些方法? -->
|
||||
|
||||
## 环境 / Environment
|
||||
- Claude Code 版本:
|
||||
- 安装方式:
|
||||
Reference in New Issue
Block a user