为工程类 skills 配置本仓库——设置它的 issue …

# GitHub 电商后端仓库：Issue Tracker + Triage 标签 + Docs 目录整理方案

一、配置 Issue Tracker

由于 GitHub 已内置 Issue 跟踪，重点在于启用与规范化：

• 启用入口：仓库 Settings → Features → 勾选 Issues（默认已开启），可选勾选 Projects 联动看板
• 建立 Issue 模板（Settings → Issues → Issue templates）：
• Bug 报告模板：复现步骤 / 期望结果 / 实际结果 / 环境版本
• 功能请求模板：背景 / 方案描述 / 替代方案
• 可选配置 .github/ISSUE_TEMPLATE/config.yml，引导用户先查文档或讨论区
• 配套自动化（可选）：用 GitHub Actions + stale 动作自动标记长期无回复的 issue

二、建立 Triage 标签体系

在仓库 Issues → Labels 中创建（保留 GitHub 自带标签，补充领域标签）：

• 类型类（颜色建议红/橙系）：
• bug（自带）、perf（性能问题）、docs（文档）、feature、refactor
• 优先级类：priority: high / medium / low
• 状态类：needs-triage（新 issue 待分诊）、awaiting-reply（等待提问者补充）、confirmed（已确认）、wontfix
• 模块类（按你的电商后端划分）：如 module: order / payment / inventory / user / cart
• Triage 流程约定：新 issue 打 needs-triage → 维护者确认类型+模块+优先级 → 移除 triage 标签、分配处理人

三、Docs 目录整理（后端领域布局）

在仓库根目录建 docs/，建议结构：

```

docs/

├── architecture/ # 系统架构、服务拆分、技术选型说明

├── api/ # API 设计规范、接口文档（可链接 OpenAPI/Swagger）

├── database/ # ER 图、表结构变更记录、索引规范

├── guides/ # 本地开发环境搭建、部署流程、调试技巧

├── operations/ # 运维手册：监控、告警、故障排查、回滚方案

└── adr/ # 架构决策记录（ADR-001 编号递增）

```

• 根目录保留 README.md（简介+快速上手），细节下沉到 docs/
• 每个目录放 index.md 或在 README 建目录导航链接
• 在仓库 Settings 建议开启 Wiki（可选），但推荐 docs 随代码走、走 PR 评审

四、执行顺序建议

1. 建标签 → 2. 配 Issue 模板 → 3. 批量为 42 个 open issue 打标签分诊 → 4. 搭 docs 骨架并补核心文档