メインコンテンツまでスキップ

TakumiのSlackコマンドを利用する

info

本チュートリアルで扱う機能は、Takumiをご契約いただいた組織でのみご利用いただけます。

コマンドの種類

TakumiをSlackに招待したのち、直接Takumiに対してタスクを依頼する他に、下記のSlackコマンドをご利用いただけます:

  1. takumi-scopes: Takumiがアクセス可能なコードベースの管理
  2. takumi-tasks: Takumiの現在の単発/定期タスクの管理
  3. takumi-knowledge: Takumiがタスクを跨いで保持する知識の管理

1. takumi-scopesでのアクセス可能なコードベースの管理

info

Takumiがアクセス可能なレポジトリはスコープによって制限されており、タスクを依頼する際にはその対象となるレポジトリをスコープへ設定いただく必要があります。

Slackチャンネルにて/takumi-scopesと入力いただくと、現状Takumiがアクセス可能なレポジトリの情報が表示されます。新しくレポジトリを追加する場合はEditを選択してください。

Enter takumi-scopes command

Takumiがその時点でアクセスを許可されているレポジトリが表示されるので、Takumiにアクセスさせたいレポジトリを選択してください。

Select from accessible repos

選択したのち、Submitで確定してください。

Submit and confirm scopes

再度/takumi-scopesコマンドを入力いただくと、追加されたスコープの確認およびその変更が可能です。

Select from accessible repos

2. takumi-tasksでのタスク管理

info

直近でTakumiへタスクを依頼したい場合は、直接Slackチャンネルにてメンションすることも可能です。

Directly mention Takumi with a request

Slackチャンネルにて/takumi-tasksと入力いただくと、現在Takumiにアサインされているタスク、及び定期タスク(Cron Task)、単発タスク(One-Shot Task)のアサインのボタンが表示されます。

Enter takumi-tasks command

単発タスク(One-shot Task)の登録

Add One-Shot Taskを選択することで単発タスクアサイン用のフォームが表示されます。タスクのタイトル、実行日時、タスクの依頼内容、及びタスクに関する報告先(チャンネル及びメンション先のユーザー)を入力し、Submitで登録してください。

Assign a one-shot task

設定後、/takumi-tasksコマンドを再度実行いただくと、現在予定されている単発タスクが確認でき、必要に応じてそれらの変更・キャンセルが可能です。

指定の時間にTakumiがスレッドをチャンネル内に作成し、タスクを実行します。

One-shot task is run

警告

One-Shotタスクの実行日時をSubmitで登録した同時刻、あるいはその前の時間に設定した場合、タスクは追加されません。

定期タスク(Cron Task)の登録

Add Cron Taskを選択することで定期タスクアサイン用のフォームが表示されます。単発タスク同様、必要な項目を記入し、Submitで登録してください。タスクの実行時間はcron表現での指定となります。

Assign a cron task

設定後、再度/takumi-tasksコマンドを実行いただくことで、現状設定されている定期タスクの確認・修正が可能です。

See cron task

指定の時間になる都度、Takumiによってチャンネル内でスレッドが作成され、指定のタスクが実行されます。

3. takumi-knowledgeでの知識の管理

Slackチャンネルにて/takumi-knowledgeを入力いただくと、現段階でTakumiがタスクを跨いで保持する知識の確認及び登録が可能です。

Run takumi-knowledge command

Addを選択することで、手動で知識を登録いただけます。

Add knowledge

再度/takumi-knowledgeコマンドを実行いただくと、追加されたナレッジが表示され、その修正が可能です。

View knowledge

Deleteを選択することで登録された知識の削除が可能です。

Delete knowledge