GitHub Action
Issues Helper
简体中文 | English
- 完全免费
- 全自动操作
- 托管于 GitHub 服务器,只要 GitHub 不宕机,它就不受影响
Private 项目每月有 2000 次的限制,具体查看。Public 项目无限制。
欢迎在 这里 留言。
如果觉得 actions-cool 能帮到你,欢迎复制到 README 中支持,推广给更多的项目:,更多样式。
[![actions-cool](https://img.shields.io/badge/using-actions--cool-blue?style=flat-square)](https://github.com/actions-cool)
非常欢迎你来尝试使用,并提出意见,你可以通过以下方式:
- 通过 Issue 报告 bug 或进行咨询
- 通过 Discussions 进行讨论
- 提交 Pull Request 改进
issues-helper
的代码
也欢迎加入 钉钉交流群
当以下列表没有你想要的功能时,可以在 issues 中提出。
- ⭐ 基 础
- 🌟 进 阶
为了更好的展示功能,下面以实际场景举例,请灵活参考。
当一个 issue 新增或修改时,将这个 issue 指定某人或多人。
name: Add Assigness
on:
issues:
types: [opened, edited]
jobs:
add-assigness:
runs-on: ubuntu-latest
steps:
- name: Add assigness
uses: actions-cool/issues-helper@v3
with:
actions: 'add-assignees'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: ${{ github.event.issue.number }}
assignees: 'xxx' or 'xx1,xx2'
random-to: 1
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
assignees | 指定人。当不填或者为空字符时,不操作 | string | ✖ |
random-to | 当设置时,会在 assignees 中随机选择 | number | ✖ |
actions
支持多个,需用逗号隔开。如:add-assignees, add-labels
- 其中的
name
可根据自行根据实际情况修改 - on 参考
${{ github.event.issue.number }}
表示当前 issue 编号,更多参考assignees
支持多个,需用逗号隔开- assign 最多只能设定 10 个
⏫ 返回列表
当一个新增的 issue 内容不包含指定格式时,为这个 issue 添加 labels。
name: Add Labels
on:
issues:
types: [opened]
jobs:
add-labels:
runs-on: ubuntu-latest
if: contains(github.event.issue.body, 'xxx') == false
steps:
- name: Add labels
uses: actions-cool/issues-helper@v3
with:
actions: 'add-labels'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: ${{ github.event.issue.number }}
labels: 'bug' or 'bug1, bug2'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
labels | 新增的 labels。当不填或者为空字符时,不新增 | string | ✖ |
labels
支持多个,需用逗号隔开
⏫ 返回列表
关闭指定 issue。
- name: Close issue
uses: actions-cool/issues-helper@v3
with:
actions: 'close-issue'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: xxx
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
close-reason | 关闭原因。默认not_planned 未计划,completed 完成 |
string | ✖ |
⏫ 返回列表
当新增一个指定 label 时,对该 issue 进行评论。
name: Create Comment
on:
issues:
types: [labeled]
jobs:
create-comment:
runs-on: ubuntu-latest
if: github.event.label.name == 'xxx'
steps:
- name: Create comment
uses: actions-cool/issues-helper@v3
with:
actions: 'create-comment'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: ${{ github.event.issue.number }}
body: |
Hello ${{ github.event.issue.user.login }}. Add some comments.
你好 ${{ github.event.issue.user.login }}。巴拉巴拉。
emoji: '+1' or '+1,heart'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
body | 新增评论的内容 | string | ✔ |
emoji | 为新增评论的增加 emoji | string | ✖ |
body
为空时,无操作- 返回
comment-id
,可用于之后操作。用法参考 ${{ github.event.issue.user.login }}
表示该 issue 的创建者emoji
支持多个,需用逗号隔开
⏫ 返回列表
感觉新增 issue 使用场景不多。这里举例,每月 1 号 UTC 00:00 新增一个 issue。
name: Create Issue
on:
schedule:
- cron: "0 0 1 * *"
jobs:
create-issue:
runs-on: ubuntu-latest
steps:
- name: Create issue
uses: actions-cool/issues-helper@v3
with:
actions: 'create-issue'
token: ${{ secrets.GITHUB_TOKEN }}
title: 'xxxx'
body: 'xxxx'
labels: 'xx'
assignees: 'xxx'
emoji: '+1'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
title | 新增 issue 的标题 | string | ✔ |
body | 新增 issue 的内容 | string | ✖ |
labels | 为新增 issue 添加 labels | string | ✖ |
assignees | 为新增 issue 添加 assignees | string | ✖ |
random-to | 当设置时,会在 assignees 中随机选择 | number | ✖ |
emoji | 为新增 issue 增加 emoji | string | ✖ |
title
为空时,无操作- 返回
issue-number
,用法参考
⏫ 返回列表
新增 label。若想批量维护 labels,可查看。
- name: Create label
uses: actions-cool/issues-helper@v3
with:
actions: 'create-label'
token: ${{ secrets.GITHUB_TOKEN }}
label-name: 'xx'
label-color: '0095b3'
label-desc: 'xx'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
label-name | 标签名称,支持 emoji | string | ✔ |
label-color | 标签颜色,格式为 16 进制色码,不加 # |
string | ✖ |
label-desc | 标签描述 | string | ✖ |
label-name
:若已存在,则无操作label-color
:默认为ededed
⏫ 返回列表
根据 comment-id
删除指定评论。
- name: Delete comment
uses: actions-cool/issues-helper@v3
with:
actions: 'delete-comment'
token: ${{ secrets.GITHUB_TOKEN }}
comment-id: xxx
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
comment-id | 指定的 comment | number | ✔ |
⏫ 返回列表
当新增 invalid
label 时,对该 issue 进行锁定。
name: Lock Issue
on:
issues:
types: [labeled]
jobs:
lock-issue:
runs-on: ubuntu-latest
if: github.event.label.name == 'invalid'
steps:
- name: Lock issue
uses: actions-cool/issues-helper@v3
with:
actions: 'lock-issue'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: ${{ github.event.issue.number }}
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
lock-reason | 锁定 issue 的原因 | string | ✖ |
lock-reason
:可选值有off-topic
too heated
resolved
spam
⏫ 返回列表
打开指定 issue。
- name: Open issue
uses: actions-cool/issues-helper@v3
with:
actions: 'open-issue'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: xxx
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
⏫ 返回列表
移除 issue 指定人员。
- name: Remove assignees
uses: actions-cool/issues-helper@v3
with:
actions: 'remove-assignees'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: ${{ github.event.issue.number }}
assignees: 'xx'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
assignees | 移除的指定人。当为空字符时,不进行移除 | string | ✔ |
⏫ 返回列表
移除指定 labels。
- name: Remove labels
uses: actions-cool/issues-helper@v3
with:
actions: 'remove-labels'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: ${{ github.event.issue.number }}
labels: 'xx'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
labels | 移除的 labels。当为空字符时,不进行移除 | string | ✔ |
labels
支持多个,如x1,x2,x3
,只会移除 issue 已添加的 labels
⏫ 返回列表
替换 issue 的 labels。
- name: Set labels
uses: actions-cool/issues-helper@v3
with:
actions: 'set-labels'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: ${{ github.event.issue.number }}
labels: 'xx'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
labels | labels 设置。当空字符时,会移除所有 | string | ✔ |
⏫ 返回列表
解锁指定 issue。
- name: Unlock issue
uses: actions-cool/issues-helper@v3
with:
actions: 'unlock-issue'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: ${{ github.event.issue.number }}
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
⏫ 返回列表
根据 comment-id
更新指定评论。
下面的例子展示的是,为每个新增的 comment 增加 👀 。
name: Add eyes to each comment
on:
issue_comment:
types: [created]
jobs:
update-comment:
runs-on: ubuntu-latest
steps:
- name: Update comment
uses: actions-cool/issues-helper@v3
with:
actions: 'update-comment'
token: ${{ secrets.GITHUB_TOKEN }}
comment-id: ${{ github.event.comment.id }}
emoji: 'eyes'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
comment-id | 指定的 comment | number | ✔ |
body | 更新 comment 的内容 | string | ✖ |
update-mode | 更新模式。默认 replace 替换,append 附加 |
string | ✖ |
emoji | 增加 emoji | string | ✖ |
body
不填时,会保持原有update-mode
为append
时,会进行附加操作。非append
都会进行替换。仅对body
生效
⏫ 返回列表
根据 issue-number
更新指定 issue。
- name: Update issue
uses: actions-cool/issues-helper@v3
with:
actions: 'update-issue'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: ${{ github.event.issue.number }}
state: 'open'
title: 'xxx'
body: 'xxxx'
update-mode: 'replace'
labels: 'xx'
assignees: 'xxx'
emoji: '+1'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
state | 修改 issue 的状态,可选值 open closed |
string | ✖ |
title | 修改 issue 的标题 | string | ✖ |
body | 修改 issue 的内容 | string | ✖ |
update-mode | 更新模式。默认 replace 替换,append 附加 |
string | ✖ |
labels | 替换 issue 的 labels | string | ✖ |
assignees | 替换 issue 的 assignees | string | ✖ |
emoji | 增加 emoji | string | ✖ |
state
默认为open
- 当可选项不填时,会保持原有
⏫ 返回列表
进阶用法不建议 actions 多个一次同时使用。
每月 1 号 UTC 0 时,对所有 30 天以上未活跃的 issues 增加 inactive
标签。
name: Check inactive
on:
schedule:
- cron: "0 0 1 * *"
jobs:
check-inactive:
runs-on: ubuntu-latest
steps:
- name: check-inactive
uses: actions-cool/issues-helper@v3
with:
actions: 'check-inactive'
token: ${{ secrets.GITHUB_TOKEN }}
inactive-day: 30
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
body | 操作 issue 时,可进行评论。不填时,不评论 | string | ✖ |
emoji | 为该评论增加 emoji | string | ✖ |
labels | 标签筛选 | string | ✖ |
issue-state | 状态筛选 | string | ✖ |
issue-assignee | 指定人筛选 | string | ✖ |
issue-creator | 创建人筛选 | string | ✖ |
issue-mentioned | 提及人筛选 | string | ✖ |
body-includes | 包含内容筛选 | string | ✖ |
title-includes | 包含标题筛选 | string | ✖ |
inactive-day | 非活跃天数筛选 | number | ✖ |
inactive-label | 新增标签名称 | string | ✖ |
exclude-labels | 排除标签筛选 | string | ✖ |
labels
:为多个时,会查询同时拥有多个。不填时,会查询所有issue-state
:默认为open
。可选值all
closed
,非这 2 项时,均为open
issue-assignee
:不支持多人。不填或输入 * 时,查询所有。输入none
会查询未添加指定人的 issuesinactive-day
:当输入时,会筛选 issue 更新时间早于当前时间减去非活跃天数。不填时,会查询所有inactive-label
:默认为inactive
,可自定义其他。当项目未包含该 label 时,会自动新建exclude-labels
:设置包含$exclude-empty
时,可排除无 label issue
⏫ 返回列表
根据传入的参数和 issue-number
来检查该 issue 是否满足条件,返回一个布尔值。
下面的例子效果是:当 issue 新开时,校验当前 issue 指定人是否包含 x1
或者 x2
,满足一个指定人即可校验通过,同时校验标题是否满足条件,校验规则。
name: Check Issue
on:
issues:
types: [edited]
jobs:
check-issue:
runs-on: ubuntu-latest
steps:
- name: check-issue
uses: actions-cool/issues-helper@v3
with:
actions: 'check-issue'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: ${{ github.event.issue.number }}
assignee-includes: 'x1,x2'
title-includes: 'x1,x2/y1,y2'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
assignee-includes | 是否包含指定人 | string | ✖ |
title-includes | 标题包含校验 | string | ✖ |
title-excludes | 检测标题移除默认 title 后是否为空 | string | ✖ |
body-includes | 内容包含校验 | string | ✖ |
title-includes
body-includes
支持格式x1,x2
或者x1,x2/y1,y2
。只支持两个层级- 返回
check-result
,由于 yml 原因,判断条件为if: steps.xxid.outputs.check-result == 'true'
⏫ 返回列表
每 7 天 UTC 0 时,关闭已填加 need info
label 且 7 天以上未活跃的 issues。
name: Check need info
on:
schedule:
- cron: "0 0 */7 * *"
jobs:
check-need-info:
runs-on: ubuntu-latest
steps:
- name: close-issues
uses: actions-cool/issues-helper@v3
with:
actions: 'close-issues'
token: ${{ secrets.GITHUB_TOKEN }}
labels: 'need info'
inactive-day: 7
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
body | 操作 issue 时,可进行评论。不填时,不评论 | string | ✖ |
emoji | 为该评论增加 emoji | string | ✖ |
labels | 标签筛选 | string | ✖ |
issue-assignee | 指定人筛选 | string | ✖ |
issue-creator | 创建人筛选 | string | ✖ |
issue-mentioned | 提及人筛选 | string | ✖ |
body-includes | 包含内容筛选 | string | ✖ |
title-includes | 包含标题筛选 | string | ✖ |
inactive-day | 非活跃天数筛选 | number | ✖ |
exclude-labels | 排除标签筛选 | string | ✖ |
close-reason | 关闭原因。默认not_planned 未计划,completed 完成 |
string | ✖ |
labels
:为多个时,会查询同时拥有多个。不填时,会查询所有issue-assignee
:不支持多人。不填或输入 * 时,查询所有。输入none
会查询未添加指定人的 issuesinactive-day
:当输入时,会筛选 issue 更新时间早于当前时间减去非活跃天数。不填时,会查询所有exclude-labels
:设置包含$exclude-empty
时,可排除无 label issue
⏫ 返回列表
查找当前仓库 1 号 issue 中,创建者是 k ,内容包含 this
的评论列表。
- name: Find comments
uses: actions-cool/issues-helper@v3
with:
actions: 'find-comments'
token: ${{ secrets.GITHUB_TOKEN }}
issue-number: 1
comment-auth: 'k'
body-includes: 'this'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-number | 指定的 issue,当不传时会从触发事件中获取 | number | ✖ |
comment-auth | 评论创建者,不填时会查询所有 | string | ✖ |
body-includes | 评论内容包含过滤,不填时无校验 | string | ✖ |
direction | 返回 comments 排序 |
string | ✖ |
- 返回
comments
,格式如下:
[
{id: 1, auth: 'x', body: 'xxx', created: '', updated: ''},
{id: 2, auth: 'x', body: 'xxx', created: '', updated: ''},
]
direction
默认为升序,只有设置desc
时,会返回降序- 返回数组中
created
updated
,由所处环境决定,会是 UTC +0
⏫ 返回列表
查找当前仓库,创建者是 k ,title 包含 this
,body 包含 that
,打开状态的 issues 列表。
- name: Find issues
uses: actions-cool/issues-helper@v3
with:
actions: 'find-issues'
token: ${{ secrets.GITHUB_TOKEN }}
issue-creator: 'k'
issue-state: 'open'
title-includes: 'this'
body-includes: 'that'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
issue-state | 状态筛选 | string | ✖ |
issue-creator | 创建者筛选 | string | ✖ |
title-includes | 标题包含过滤,不填时无校验 | string | ✖ |
body-includes | 内容包含过滤,不填时无校验 | string | ✖ |
exclude-labels | 排除标签筛选 | string | ✖ |
inactive-day | 非活跃天数筛选 | number | ✖ |
direction | 返回 issues 排序 |
string | ✖ |
- 返回
issues
,格式如下:
[
{number: 1, auth: 'x', body: 'xxx', body: 'xxx', state: 'open', created: '', updated: ''},
{number: 2, auth: 'x', body: 'xxx', body: 'xxx', state: 'closed', created: '', updated: ''},
]
direction
默认为升序,只有设置desc
时,会返回降序- 返回数组中
created
updated
,由所处环境决定,会是 UTC +0 exclude-labels
:设置包含$exclude-empty
时,可排除无 label issue
⏫ 返回列表
每 3 个月 1 号 UTC 0 时,锁定已填加 inactive
label 且 128 天以上未活跃的所有 issues。
name: Lock inactive issues
on:
schedule:
- cron: "0 0 1 */3 *"
jobs:
lock-issues:
runs-on: ubuntu-latest
steps:
- name: lock-issues
uses: actions-cool/issues-helper@v3
with:
actions: 'lock-issues'
token: ${{ secrets.GITHUB_TOKEN }}
labels: 'inactive'
inactive-day: 128
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
body | 操作 issue 时,可进行评论。不填时,不评论 | string | ✖ |
emoji | 为该评论增加 emoji | string | ✖ |
labels | 标签筛选 | string | ✖ |
issue-state | 状态筛选 | string | ✖ |
issue-assignee | 指定人筛选 | string | ✖ |
issue-creator | 创建人筛选 | string | ✖ |
issue-mentioned | 提及人筛选 | string | ✖ |
body-includes | 包含内容筛选 | string | ✖ |
title-includes | 包含标题筛选 | string | ✖ |
inactive-day | 非活跃天数筛选 | number | ✖ |
lock-reason | 锁定 issue 的原因 | string | ✖ |
exclude-labels | 排除标签筛选 | string | ✖ |
labels
:为多个时,会查询同时拥有多个。不填时,会查询所有issue-state
:默认为open
。可选值all
closed
,非这 2 项时,均为open
issue-assignee
:不支持多人。不填或输入 * 时,查询所有。输入none
会查询未添加指定人的 issuesinactive-day
:当输入时,会筛选 issue 更新时间早于当前时间减去非活跃天数。不填时,会查询所有exclude-labels
:设置包含$exclude-empty
时,可排除无 label issue
⏫ 返回列表
快捷加指定人,仅作用于 issue 新增编辑评论。
name: Issue Mark Assignees
on:
issue_comment:
types: [created, edited]
jobs:
mark-assignees:
runs-on: ubuntu-latest
steps:
- name: mark-assignees
uses: actions-cool/issues-helper@v3
with:
actions: 'mark-assignees'
token: ${{ secrets.GITHUB_TOKEN }}
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
assign-command | 可设置简洁命令,如:/a |
string | ✖ |
require-permission | 要求权限,默认为 write |
string | ✖ |
assign-command
:可设置简洁命令。默认:/assign
require-permission
:可选值有admin
,write
,read
,none
- 团队成员若设置
read
权限,则为read
- 外部 Collaborator 若设置
read
权限,则为read
- 普通用户为
read
权限 - 当设置
write
后,admin
和write
满足条件
- 团队成员若设置
⏫ 返回列表
快捷标记重复问题,仅作用于 issue 新增编辑评论。
name: Issue Mark Duplicate
on:
issue_comment:
types: [created, edited]
jobs:
mark-duplicate:
runs-on: ubuntu-latest
steps:
- name: mark-duplicate
uses: actions-cool/issues-helper@v3
with:
actions: 'mark-duplicate'
token: ${{ secrets.GITHUB_TOKEN }}
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
duplicate-command | 可设置简洁命令,如:/d |
string | ✖ |
duplicate-labels | 为该 issue 额外增加 labels | string | ✖ |
remove-labels | 设置可移除的 labels | string | ✖ |
labels | 替换该 issue 的 labels | string | ✖ |
emoji | 为该评论的增加 emoji | string | ✖ |
close-issue | 是否同时关闭该 issue | string | ✖ |
require-permission | 要求权限,默认为 write |
string | ✖ |
close-reason | 关闭原因。默认not_planned 未计划,completed 完成 |
string | ✖ |
duplicate-command
:当设置简洁命令时,同时仍支持原有Duplicate of
。屏蔽内容包含?
labels
:优先级最高close-issue
:true
或'true'
均可生效require-permission
:可选值有admin
,write
,read
,none
- 团队成员若设置
read
权限,则为read
- 外部 Collaborator 若设置
read
权限,则为read
- 普通用户为
read
权限 - 当设置
write
后,admin
和write
满足条件
- 团队成员若设置
⏫ 返回列表
当一个 issue 新建时,对首次新建 issue 的用户进行欢迎。若用户非首次新建,则无操作。
name: Issue Welcome
on:
issues:
types: [opened]
jobs:
issue-welcome:
runs-on: ubuntu-latest
steps:
- name: welcome
uses: actions-cool/issues-helper@v3
with:
actions: 'welcome'
token: ${{ secrets.GITHUB_TOKEN }}
body: hi @${{ github.event.issue.user.login }}, welcome!
labels: 'welcome1, welcome2'
assignees: 'xx1'
issue-emoji: '+1, -1, eyes'
参数 | 描述 | 类型 | 必填 |
---|---|---|---|
actions | 操作类型 | string | ✔ |
token | token 说明 | string | ✖ |
body | 评论欢迎的内容,不填则不评论 | string | ✖ |
emoji | 为该评论的增加 emoji | string | ✖ |
labels | 为该 issue 增加 labels | string | ✖ |
assignees | 为该 issue 增加 assignees | string | ✖ |
issue-emoji | 为该 issue 增加 emoji | string | ✖ |
- 若这 4 个可选项都不填,则无操作
⏫ 返回列表
需拥有 push 权限的人员 token。
- 个人 token 申请
- 需勾选
Full control of private repositories
- 需勾选
- 项目添加 secrets
- 选择 settings,选择 secrets,选择
New repository secret
Name
与 actions 中保持一致Value
填写刚才个人申请的 token
- 选择 settings,选择 secrets,选择
当 actions 不填写 token 时,或填写 ${{ secrets.GITHUB_TOKEN }}
,会默认为 github-actions-bot
。更多查看。
⏫ 返回列表
⏫ 返回列表
- name: Create issue
uses: actions-cool/issues-helper@v3
id: createissue
with:
actions: 'create-issue'
token: ${{ secrets.GITHUB_TOKEN }}
- name: Check outputs
run: echo "Outputs issue_number is ${{ steps.createissue.outputs.issue-number }}"
更多查看:
- https://docs.github.com/en/free-pro-team@latest/actions/creating-actions/metadata-syntax-for-github-actions#outputs
- https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idoutputs
⏫ 返回列表
"title-includes": 'x1,x2'
x1
x2
"x1y3y2" true
"y2 x1" true
"x2" true
"x3" false
"title-includes": 'x1,x2/y1,y2'
x1 + y1
x2 + y1
x1 + y2
x2 + y2
"x1y3y2" true
"y2 x1" true
"1x2y" false
"x1" false
⏫ 返回列表
content | emoji |
---|---|
+1 |
👍 |
-1 |
👎 |
laugh |
😄 |
confused |
😕 |
heart |
❤️ |
hooray |
🎉 |
rocket |
🚀 |
eyes |
👀 |
⏫ 返回列表
点击某个评论右上角 ···
图标,选择 Copy link
,url 末尾数字即是 comment_id
。
⏫ 返回列表
- 可直接使用这个 GitHub Actions workflow template 仓库的模板
- 个人练习和测试 Actions 的仓库
- 也可以来 线上使用者 的仓库参照