diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
new file mode 100644
index 0000000..4bc5683
--- /dev/null
+++ b/.github/CONTRIBUTING.md
@@ -0,0 +1,89 @@
+# 用户贡献指南
+
+非常感谢您关注 [@xuexb/github-bot](https://github.com/xuexb/github-bot) 项目，在提交您的贡献之前，请务必认真阅读以下准则。
+
+1. [问题反馈](#issue)
+1. [开发指南](#develop)
+ 1. [本地调试](#debug)
+ 1. [常用脚本命令（ npm scripts ）](#npm-scripts)
+ 1. [代码风格](#code-spec)
+ 1. [项目结构](#dir-spec)
+ 1. [提交请求（pull request）](#pull-request)
+1. [提交信息规范](#commit-message-spec)
+1. [后记](#open-source)
+
+
+## 问题反馈
+
+1. 请避免提交重复的 issue，在提交之前搜索现有的 issue 。
+1. 请使用 [创建 issue](https://xuexb.github.io/github-bot/create-issue.html) 页面反馈问题，否则将直接被关闭。
+
+
+## 开发设置
+
+需要安装 [nodejs](https://nodejs.org) 版本7.8.0+ ，下载项目到本地后安装依赖 `npm install` ，安装完成后将自动添加 git commit 提交信息格式检查和提交前代码格式验证。
+
+
+### 本地调试
+
+目前是基于 [github api](https://developer.github.com/v3/) + 接口说明 + 在线 github webhook 实时触发调试，计划添加一个 mock 服务，支持在本地实时的调试代码功能。
+
+
+### 常用脚本命令（ npm scripts ）
+
+``` bash
+# 基于 koa 启动本地服务器接口
+$ npm run start
+
+# 使用 eslint 验证代码风格
+$ npm run lint
+```
+
+
+### 代码风格
+
+使用 es6 开发，基于 编写代码，基于 [eslint](https://eslint.org/) 验证代码格式。
+
+
+### 项目结构
+
+```
+.
+├── create-issue.html - 创建 issue 页面，会往内容里注入一些特殊的标识用来让 bot 判断是否规范
+├── env - 环境配置模板
+└── src
+ ├── app.js - 服务启动入口
+ ├── github.js - 基于 https://github.com/octokit/node-github + async 完成接口对外统一
+ ├── modules - 以功能为目录区分形成模块
+ │ ├── issues - issue
+ │ │ ├── autoAssign.js - 根据配置自动 assign 给指定的人
+ │ │ ├── autoLabel.js - 根据 create-issue.html 页面注入的标记自动给 issue 打对应的 label
+ │ │ ├── replyInvalid.js - 判断是否有 create-issue.html 页面注入的标记，不存在则自动关闭
+ │ │ └── replyNeedDemo.js - 回复需要相关 demo 链接
+ │ ├── pull_request - PR
+ │ │ ├── autoReviewRequest.js - 根据配置自动 reviewer 给指定的人
+ │ │ ├── replyInvalidTitle.js - 根据标题规范自动提醒需要修改
+ │ │ └── titlePrefixToLabel.js - 根据标题规范化前缀和配置，自动打上 label
+ │ └── releases - releases
+ │ └── autoReleaseNote.js - 添加新 tag 时自动根据距离上一个 tag 的 commit log 自动归类，发布 releases notes
+ └── utils.js - 常用工具方法
+```
+
+
+### 提交请求（pull request）
+
+1. fork mipengine/www.mipengine.org
+1. 把个人仓库（repository）克隆到电脑上，并安装所依赖的插件。
+1. 开始编辑，并自测通过（后续Todo: 添加测试用例）后提前代码。
+1. 推送（push）分支。
+1. 建立一个新的合并申请（pull request）并描述变动。
+
+
+## 提交信息规范
+
+git commit 信息和 pull request 标题必须遵循 [commit-log-和-pr-标题规则](https://github.com/xuexb/github-bot#commit-log-和-pr-标题规则) ，否则不予合入。
+
+
+## 后记
+
+感谢您的贡献， github-bot 因您而更完善。
diff --git a/README.md b/README.md
index f0e9a76..e6a6fe9 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,10 @@ Github robot
[](https://travis-ci.org/xuexb/github-bot)
+## 声明
+
+该 [仓库@xuexb/github-bot](https://github.com/xuexb/github-bot/) 是用来演示 github-bot 的基本功能，因为具体需要实现的功能，可能因项目而不同，如果你需要她，你可以 fork 并相应的添加、删除功能。以下功能是一些常用的 show case 。
+
## 功能 - Feature
### Issue
@@ -89,10 +93,10 @@ vim .env
npm start
```
-###
-
## contributors
+> [用户贡献指南](.github/CONTRIBUTING.md)
+
- [@yugasun](https://github.com/yugasun/)
- [@xuexb](https://github.com/xuexb/)
diff --git a/package.json b/package.json
index e41e48a..3c336c1 100644
--- a/package.json
+++ b/package.json
@@ -55,10 +55,6 @@
}
}
},
- "os": [
- "darwin",
- "linux"
- ],
"devDependencies": {
"eslint": "^4.9.0",
"eslint-config-standard": "^10.2.1",