docs(github): 添加中文 issue 和 PR 模板

2026-04-29 19:54:56 +08:00
1 parent a8843802ec
commit 4d54aed8c7
@@ -0,0 +1,62 @@
+name: 问题 / 缺陷
+description: 按 OpenLess 当前 issue 口径记录可复现或可审计的问题。
+title: "[area] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        所有人类可读内容必须使用中文。一个 issue 只描述一个可独立处理的问题。
+
+        标题硬约束：
+        - 使用中文短句，推荐格式：`[area] 现象或目标`
+        - `area` 使用仓库约定的范围名称，例如 `infra/devex`、`windows`、`macos`、`tauri`、`audio`、`asr`、`insertion`、`ui`
+        - 不使用 fork-only 状态前缀，例如 `status/ready`、`agent/*`、`scope/*`
+
+        Labels 硬约束：
+        - 必须恰好选择 1 个类型：`bug` / `enhancement` / `documentation`
+        - 如果仓库已配置优先级标签，必须恰好选择 1 个优先级：`critical` / `high` / `medium` / `low`
+        - 如果仓库已配置范围标签，必须至少选择 1 个范围：`area:*`
+        - 可选：`needs-split`
+        - 不要把 `status/*`、`kind/*`、`agent/*`、`scope/*` 用到 upstream 或 upstream-ready issue 上。
+  - type: textarea
+    id: symptom
+    attributes:
+      label: 现象
+      description: 描述当前可观察到的问题、触发条件和证据。必要时列出日志、截图、layout、commit 或 PR。
+      placeholder: |
+        ## 现象
+
+        - 触发条件：
+        - 当前表现：
+        - 证据：
+    validations:
+      required: true
+  - type: textarea
+    id: impact
+    attributes:
+      label: 影响
+      description: 说明对用户、开发、测试、视觉资产治理、构建或交付流程的影响。
+      placeholder: |
+        ## 影响
+
+        -
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: 建议接受标准
+      description: 写成可验证的完成条件；不确定项写 TODO，不编造。
+      placeholder: |
+        ## 建议接受标准
+
+        - [ ]
+        - [ ]
+    validations:
+      required: true
+  - type: textarea
+    id: todo
+    attributes:
+      label: TODO / 不确定项
+      description: 只写尚未确认但必须保留的问题，不要补不存在的事实。
@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: OpenLess issue / PR 规范
+    url: https://github.com/appergb/openless
+    about: 提交前请确认中文正文、upstream 兼容标题、issue-first 和单一职责 PR 规则。
@@ -0,0 +1,60 @@
+name: 任务 / 治理项
+description: 按 OpenLess 当前 issue 口径记录文档、治理、验证或工具任务。
+title: "[area] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        所有人类可读内容必须使用中文。一个 issue 只描述一个可独立交付目标。
+
+        标题硬约束：
+        - 使用中文短句，推荐格式：`[area] 目标`
+        - 示例：`[infra/devex] 补齐 Windows 构建前置检查`、`[tauri] 补充跨平台打包说明`
+        - 不使用 fork-only 状态前缀，例如 `status/ready`、`agent/*`、`scope/*`
+
+        Labels 硬约束：
+        - 必须恰好选择 1 个类型：`enhancement` / `documentation`
+        - 如果仓库已配置优先级标签，必须恰好选择 1 个优先级：`critical` / `high` / `medium` / `low`
+        - 如果仓库已配置范围标签，必须至少选择 1 个范围：`area:*`
+        - 可选：`needs-split`
+        - 不要把 `status/*`、`kind/*`、`agent/*`、`scope/*` 用到 upstream 或 upstream-ready issue 上。
+  - type: textarea
+    id: symptom
+    attributes:
+      label: 现象
+      description: 说明为什么需要这个任务、现有流程哪里不足、有哪些证据。
+      placeholder: |
+        ## 现象
+
+        -
+    validations:
+      required: true
+  - type: textarea
+    id: impact
+    attributes:
+      label: 影响
+      description: 说明不做会影响什么交付、验证、治理或维护流程。
+      placeholder: |
+        ## 影响
+
+        -
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: 建议接受标准
+      description: 写成可验证的完成条件；不确定项写 TODO，不编造。
+      placeholder: |
+        ## 建议接受标准
+
+        - [ ]
+        - [ ]
+    validations:
+      required: true
+  - type: textarea
+    id: todo
+    attributes:
+      label: TODO / 不确定项
+      description: 只写尚未确认但必须保留的问题，不要补不存在的事实。
@@ -0,0 +1,20 @@
+## 摘要
+
+Fixes #。
+
+说明这个 PR 解决的单一目标。标题必须使用 `type(scope): 中文目标`，例如 `docs(infra): 补齐 Windows 构建说明`。
+
+## 修复 / 新增 / 改进
+
+- 
+
+## 兼容
+
+- 不包含：
+- 对现有用户 / 本地环境 / 构建流程的影响：
+
+## 测试计划
+
+- [ ] 命令：
+- [ ] 结果：
+- [ ] 证据路径：