Skip to content

docs: 新增 issue 模版与类型标签约定 - #328

Merged
miaobyte merged 2 commits into
masterfrom
docs/issue-templates
Sep 13, 2026
Merged

docs: 新增 issue 模版与类型标签约定#328
miaobyte merged 2 commits into
masterfrom
docs/issue-templates

Conversation

@miaobyte

Copy link
Copy Markdown
Contributor

变更

参考主流开源实践(epic / rfc / bug / feature / perf)规范 kvlang 的 issue 形态。

约定

  • 类型标签EPICRFCBUGFEATPERFDOCS
  • 标题前缀[TYPE] <layer>: <描述>,layer 沿用既有层级名(0-kvspace / 1-layout / 2-runtime / 3-compiler / 5-formal / 6-internet 等)

模版(GitHub issue forms)

文件 用途 自动打标
bug.yml 现象 / 复现 / 对应 spec 条款 / 后端 / 版本 BUG
rfc.yml 动机 / 提案 / 影响面 / 备选方案 / 裁决记录(收敛后回填) RFC
epic.yml 目标 / 子任务清单 / 验收标准 / 依赖顺序 EPIC
feature.yml 需求 / 动机 / 落点 / 备选方案 FEAT
perf.yml 实测数据 / 后端 / 瓶颈分析 / 目标与代价 PERF
config.yml 禁空白 issue,引导先查 stdlib/kvlang/spec/

模版里固化了本项目的两条硬约束:spec 为准(实现是缺陷)语言行为改动先落 spec 条款

🤖 Generated with Claude Code

miaobyte and others added 2 commits September 13, 2026 17:55
参考主流开源实践(epic / rfc / bug / feature / perf),把 issue 分类
收敛为六个类型标签 + 统一标题前缀格式 `[TYPE] <layer>: <描述>`。

- .github/ISSUE_TEMPLATE/config.yml    禁空白 issue,指向 spec
- bug.yml   现象 / 复现 / 对应 spec 条款 / 后端 / 版本
- rfc.yml   动机 / 提案 / 影响面 / 备选方案 / 裁决记录
- epic.yml  目标 / 子任务清单 / 验收标准 / 依赖顺序
- feature.yml 需求 / 动机 / 落点 / 备选方案
- perf.yml  测量数据 / 后端 / 瓶颈分析 / 目标与代价

类型标签:EPIC、RFC、BUG、FEAT、PERF、DOCS。

Co-Authored-By: Claude Code <noreply@anthropic.com>
顶层追踪:主题 / 里程碑与 Epic / 完成判据 / 明确不做。

Co-Authored-By: Claude Code <noreply@anthropic.com>
@miaobyte
miaobyte merged commit 99874f3 into master Sep 13, 2026
6 checks passed
@miaobyte
miaobyte deleted the docs/issue-templates branch September 13, 2026 10:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant