From 311ec280c3e2c5819d2f528b366310ec3028602a Mon Sep 17 00:00:00 2001
From: xsser <xsser@qq.com>
Date: Tue, 24 Mar 2026 02:01:59 +0800
Subject: [PATCH] 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
---
 .github/CONTRIBUTING.md                   | 59 +++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/bug_report.md      | 23 +++++++++
 .github/ISSUE_TEMPLATE/config.yml         |  8 +++
 .github/ISSUE_TEMPLATE/feature_request.md | 15 ++++++
 .github/ISSUE_TEMPLATE/question.md        | 16 ++++++
 5 files changed, 121 insertions(+)
 create mode 100644 .github/CONTRIBUTING.md
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md
 create mode 100644 .github/ISSUE_TEMPLATE/question.md

diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
new file mode 100644
index 0000000..e004f8f
--- /dev/null
+++ b/.github/CONTRIBUTING.md
@@ -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
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000..d6f8019
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -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
+- 安装方式：
+
+## 截图 / 日志（如有）
+<!-- 粘贴截图或错误日志 -->
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..1a77c6d
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -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
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 0000000..f372a8c
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,15 @@
+---
+name: Feature Request
+about: 请求新功能 / Request a new feature
+title: "feat: "
+labels: enhancement
+---
+
+## 功能描述 / Description
+<!-- 你希望 PUA Skill 增加什么功能？ -->
+
+## 使用场景 / Use Case
+<!-- 什么场景下你需要这个功能？ -->
+
+## 你考虑过的替代方案 / Alternatives
+<!-- 有没有其他方式可以实现？ -->
diff --git a/.github/ISSUE_TEMPLATE/question.md b/.github/ISSUE_TEMPLATE/question.md
new file mode 100644
index 0000000..a48a765
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/question.md
@@ -0,0 +1,16 @@
+---
+name: Question / 使用疑问
+about: 提问前请先查阅 Guide / Check guide before asking
+title: "question: "
+labels: question
+---
+
+## 问题 / Question
+<!-- 你遇到了什么疑问？ -->
+
+## 你已经尝试过的 / What you've tried
+<!-- 查阅了哪些文档？试过哪些方法？ -->
+
+## 环境 / Environment
+- Claude Code 版本：
+- 安装方式：