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:
xsser
2026-03-24 02:01:59 +08:00
parent dc2771f03c
commit 311ec280c3
5 changed files with 121 additions and 0 deletions
+59
View File
@@ -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
+23
View File
@@ -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 版本:
- OSmacOS / Linux / Windows
- 安装方式:
## 截图 / 日志(如有)
<!-- 粘贴截图或错误日志 -->
+8
View File
@@ -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
+15
View File
@@ -0,0 +1,15 @@
---
name: Feature Request
about: 请求新功能 / Request a new feature
title: "feat: "
labels: enhancement
---
## 功能描述 / Description
<!-- 你希望 PUA Skill 增加什么功能? -->
## 使用场景 / Use Case
<!-- 什么场景下你需要这个功能? -->
## 你考虑过的替代方案 / Alternatives
<!-- 有没有其他方式可以实现? -->
+16
View File
@@ -0,0 +1,16 @@
---
name: Question / 使用疑问
about: 提问前请先查阅 Guide / Check guide before asking
title: "question: "
labels: question
---
## 问题 / Question
<!-- 你遇到了什么疑问? -->
## 你已经尝试过的 / What you've tried
<!-- 查阅了哪些文档?试过哪些方法? -->
## 环境 / Environment
- Claude Code 版本:
- 安装方式: