Skip to content

Community

yijiu2025 edited this page Oct 25, 2026 · 3 revisions

讨论与 Issue 规范(Community)

权威版本在仓库 CONTRIBUTING.md「报告问题与社区讨论」一节;本页是 wiki 镜像,便于随手修订与链接。行为准则见 CODE_OF_CONDUCT.md。

一句话判据

Issue = 维护者要做的事(修 bug、做已确认的功能);Discussion = 大家在聊的事(提问、想法、公告)。拿不准就先开 Discussion。

分流表

情况 去处
疑似缺陷,有可复现代码 Issue · 缺陷报告
功能建议 / 新能力想法 先开 Discussion · Ideas,讨论清楚再转 issue
使用方法提问 Discussion · Q&A
版本公告 / 变更通报 维护者发 Discussion · Announcements
安全漏洞 勿开公开 issue / 讨论:私密报告
下游应用的具体表现 对应应用仓(如 CoreFlow)

好 bug 报告的三要素

  1. 现象与期望分开写——不要只说「不对」;
  2. 最小复现:npm 版给 import + 调用行(带实际输出注释);源码直供给文件路径 + 片段。能三行复现的不要贴三十行;
  3. 环境:skinsuite 版本、消费形态(npm 版 / 源码直供)、Node 版本——两条消费路径排查方向不同。

标签语义

标签 含义
bug 可复现缺陷(带复现代码才打)
enhancement 已确认要做的新能力(从 Discussion 转来的带 from:discussion)
docs 文档问题
question 缺信息待补充(分流后改打 bug 或关闭转 Discussion)

维护者口径

  • 无响应时限承诺,尽量一周内首次回复;带最小复现的 bug 优先;
  • 缺信息的 issue 打 question 指出缺什么,两周无补充礼貌关闭(补充后欢迎重开);
  • Discussion Q&A 被采纳的答案点「Mark as answer」,沉淀成可检索知识库;
  • 一切互动遵守行为准则:对事不对人,新人提问友好,杠精和营销零容忍。

讨论区分类(保持 GitHub 默认英文名)

分类保持启用时的英文默认——创建/改名没有 API(GraphQL introspection 核实),规范链接统一用英文 slug,避免改名漂移:

分类(slug) 用途
📣 Announcements(announcements) 维护者发布版本通报 / 重要变更
💬 General(general) 不确定归哪的先放这,维护者分流
💡 Ideas(ideas) 功能提案;达成共识转 issue
🙏 Q&A(q-a) 使用提问;采纳答案设为 Answer
🙌 Show and tell(show-and-tell) 用 skinsuite 做的东西晒一晒
🗳 Polls(polls) 投票(用不上可留)

skinsuite Wiki

外部

Clone this wiki locally