github-bot

Github robot

声明

该 仓库@xuexb/github-bot 是用来演示 github-bot 的基本功能，因为具体需要实现的功能，可能因项目而不同，如果你需要她，你可以 fork 并相应的添加、删除功能。以下功能是一些常用的 show case 。

功能 - Feature

Issue

• 没有使用 创建 issue 页面提交的 issue 将直接被关闭
• 根据 创建 issue 页面提交的 issue 类型自动打上对应 label
• 当 issue 标记 label 为 need demo 时，自动回复，需要相关demo
• issue 自动 assign 给指定人员，需要配置 package.json 中 config.github-bot.labelToAuthor 映射

Pull Request

• 发 PR 时根据打的 label 自动添加指定的 reviewer ，需要配置 package.json 中 config.github-bot.labelToAuthor 映射
• 发 PR 时标题不规范时提醒修改，需要配置 package.json 中 config.validate-commit-msg.type 功能关键字，标题必须以 功能关键字: 开头
• 发 PR 时自动根据标题的 PR 标题规则 前缀生成对应的 label ， feat->enhancement, fix->bug

Release

• 当往远程第一次推送新版本号时，自动列出最新版本距离上一版本的 commit log 并发布 release notes ，由于需要使用两个 tag 去对比，所以项目的第一个 tag 就不处理

规则 - Rules

issue 规则

必须使用 创建 issue 页面来提交 issue ，否则将直接被关闭

labels 规则

• invalid - 未定义, 内容 不规范
• need demo - 需要提供预览链接
• need update - 需要更新修复问题
• bug - bug
• duplicate - 重复
• enhancement - 新功能
• question - 提问
• wontfix - 不修复的问题

commit log 和 PR 标题规则

所有标题必须以 功能关键字: 开头

参考： http://www.ruanyifeng.com/blog/2016/01/commit_message_change_log.html

功能关键字介绍如下：

• feat - 新功能（feature）
• fix - 修补bug
• docs - 文档（documentation）
• style - 格式（不影响代码运行的变动）
• test - 增加测试
• chore - 构建过程或辅助工具的变动
• revert - 撤销
• close - 关闭 issue

示例：

close: #1, #3feat: 添加xx功能docs: update install info

如何使用

1. 创建 access tokens

https://github.com/settings/tokens （需要在 .env 里配置）

2. 创建 webhook

https://github.com/用户名/项目名/settings/hooks/new

• Payload URL: www.example.com:8000
• Content type: application/json
• trigger: Send me everything.
• Secret: xxx （需要在 .env 里配置）

3. run server

npm installcp env .envvim .envnpm start

contributors

用户贡献指南

• @yugasun
• @xuexb

Liscense

MIT