はじめかた

このページは、tuktukのアカウントを発行された方（オーナー）が、最初の設定をご自身で進めるための手引きです。設定はすべて画面から行えます。

1. 用語

アカウント — 会社・事業ごとの入れ物です。メンバー、Anthropic APIキーをここで管理します。URLは /account/（アカウントのslug） です。slugは、アカウント名とは別に決められた、URLに使う短い識別子です。
プロジェクト — アカウントの中の作業単位です。タスク・ドキュメント・Driveフォルダはプロジェクトごとに設定します。URLは /account/（アカウントのslug）/project/（プロジェクトのslug） です。
正本リポジトリ — そのプロジェクトのタスク（GitHubのIssue）とドキュメントを保存するGitHubリポジトリです。本サービスは業務データを自前で保有せず、正本は常にGitHubとGoogleドライブにあります（例外として、AIセッションでのやりとりは、あとから経緯をたどれるように本サービス側にも保存されます。会話は、依頼した本人が、セッションの画面からいつでも削除できます。公開範囲を「プロジェクトの全員」にしたセッションでは、アカウントのオーナーも削除できます。依頼文と更新の記録は残ります）。1つのプロジェクトにつき登録できるリポジトリは1つです（2つ目の別リポジトリは登録できません）。

2. 設定の流れ

GitHubリポジトリを紐づける（プロジェクト設定）
使う機能をONにする（プロジェクト設定）
メンバーを招待する（アカウント設定）
公開範囲を決める（プロジェクト設定）

1が終われば、タスクとドキュメントは利用できます。2以降は必要になった時点で構いません。

3. 各ステップ

ステップ1: GitHubリポジトリを紐づける

場所: プロジェクト設定（サイドバーのプロジェクト名の右にある歯車から開きます）→「GitHubリポジトリを紐づける」

「GitHubにインストールして紐づける」を押します。GitHubの画面で、インストール先（個人アカウントまたは組織）と、本サービスに使わせるリポジトリを選びます。ここで選んだリポジトリだけが本サービスから見えます。 本サービスに戻ると、選んだリポジトリの一覧が表示されるので、紐づけたいリポジトリの「このリポジトリを紐づける」を押します。これで、そのリポジトリのIssueがタスクとして、リポジトリ内のMarkdownファイルがドキュメントとして表示されるようになります。

すでにGitHub Appをインストール済みの場合は「すでにGitHub Appをインストール済みの場合はこちら」から、アクセスできるインストールを選んで「紐づける」を押します（確認には有効期限があり、切れた場合はもう一度押してください）。

一覧に目的のリポジトリが無いときは、画面内のリンクからGitHubのApp設定を開き、リポジトリを追加してください。

なお、本サービスはあなたがアクセス権を持つインストールしか紐付けられません（GitHub上で本人であることを確認します）。

ステップ2: 使う機能をONにする

場所: プロジェクト設定 →「公開範囲」の下にある機能の一覧（定期ジョブ台帳・AIチャット・Drive連携が並んでいる箇所）

定期ジョブ台帳 — 決まった間隔で繰り返す定型作業を登録し、実行の記録を残します。有効にすると、設定したスケジュールに従いAIが無人で実行され、対象の課題・ドキュメント・コミット履歴等の内容がAnthropic社のAPIに送信されます（APIキーの利用に伴う支払いは利用者の負担です）。実行時、AIは課題へのコメント投稿・ドキュメントの新規作成・課題本文の「サマリー」欄の更新に限り、承認なしで書き込みます。それ以外の変更は行われず、提案として実行結果に記録されます（利用規約第6条）。
AIチャット — アカウントにAnthropic APIキーを設定すると利用できます（アカウント設定 →「Anthropic APIキー」）。キーは暗号化して保存し、画面には末尾4文字のみ表示します。利用時は、チャットの入力内容と対象の課題・ドキュメントの本文がAnthropic社のAPIに送信されます（APIキーの利用に伴う支払いは利用者の負担です）。AIチャットでは、AIの提案は画面で承認したときにのみ実行されます。
AIセッション — アカウントにAnthropic APIキーを設定すると利用できます（AIチャットと同じキーです）。「◯◯を直して」のように依頼すると、AIが対象リポジトリを読んで変更案を作り、会話の最後に変更するファイルの一覧と差分を示します。内容を確認して「はい、更新する」を押すと、リポジトリへ反映されます（反映されるまでは何も書き換わりません）。会話の下部から追加の指示を送ることもできます。依頼の内容がはっきりしないときは、AIが変更案を作らずに質問を返すことがあります。その場合は「AIから質問があります」と表示されるので、同じ入力欄から返事を送ってください（答えずにやめるときは「やめる」を押します）。会話は保存され、依頼した本人がセッションの画面からいつでも削除できます（依頼文・状態・反映したコミットへのリンクは残ります）。1日あたりの依頼件数の上限はプロジェクト設定、月あたりの利用額の上限はアカウント設定から、オーナーが変更できます。
AIセッションへの添付 — 依頼を作るときに、Googleドライブ上のファイルを添付してAIに読ませられます。依頼画面の「Googleドライブから添付」から、連携フォルダの中のファイルを選んでください。読めるのは Excel（.xlsx・.xls）・Word（.docx）・PowerPoint（.pptx）・PDF・画像（png/jpeg/gif/webp）・テキスト系のファイル（.txt/.md/.csv/.tsv/.json）と、Googleドキュメント・スプレッドシート・スライドです（Google形式は自動でExcel・Word・PowerPoint形式に変換して渡します）。1回の依頼につき10件・1ファイル20MB・合計50MBまでで、添付した内容は本サービスには保存されません。この機能を使うには、オーナーがプロジェクト設定で「AIセッションへのDrive添付」を有効にし、あわせて「Drive連携」とフォルダの設定が済んでいる必要があります。なお、添付できるのは依頼を作るときだけで、会話を始めたあとから足すことはできません。
Drive連携 — Googleドライブのフォルダをサイドバーに表示します。利用にはDriveフォルダの設定（下記）が必要です。

AIチャットと定期ジョブがDriveで読める形式: Googleドキュメント・スプレッドシート・スライド、テキスト（.txt/.md/.csv/.tsv/.json/.yml/.xml）に加え、Excel（.xlsx）・Word（.docx）・PowerPoint（.pptx）・PDF・画像（png/jpeg/gif/webp）を読めます。Excelは数式の欄に「保存されたときの計算結果」が入り、日付はExcel内部の数値のまま表示されます。文字が入っていないPDF（写真をPDFにしたもの等）は文字を取り出せません。旧形式のExcel（.xls）と、これら以外の形式（動画・音声・zip等）は、一覧には出ますが中身は読めません。

ファイルの保存（アップロード）には、個人設定（サイドバー下部の「設定」）またはアカウント設定・プロジェクト設定の「Googleに接続」でGoogleアカウントを接続してください。この接続は接続した本人のものです。アップロードする人はそれぞれ自分のGoogleアカウントを接続してください。接続したGoogleアカウントのメールアドレスのみを保存します。

タスク・ドキュメント・ロードマップは常に利用できます（ON/OFFの設定はありません）。

Driveフォルダの設定（プロジェクト設定 →「Driveフォルダ」）には、そのフォルダの持ち主であることの確認が必要です。

「Driveフォルダを選択」を押し、Googleの選択画面（Picker）で対象のフォルダを選びます
画面に表示されるサービスアカウントのアドレスに、そのフォルダを共有します（閲覧者で構いません）
「共有できたか確認」を押します

確認の有効期限は発行から24時間です。

ステップ3: メンバーを招待する

場所: アカウント設定 →「メンバー」

GitHubのユーザー名を入力して「招待」を押します。招待された方は、同じGitHubアカウントでログインページからログインできます（招待メールは送信されません。ログインページのURLはご自身で共有してください）。

owner — 設定画面の操作、メンバーの追加・削除、公開範囲の設定ができます。
member — 通常の利用者です。

メンバーの追加は、原則としてそのアカウント配下のすべてのプロジェクトを見せることを意味します（利用規約第3条）。

ステップ4: 公開範囲を決める

場所: プロジェクト設定 →「公開範囲」

既定は「全メンバー公開」で、アカウントのメンバー全員が閲覧できます。「限定公開」に変更すると、指定したメンバーとオーナーだけが閲覧できます。閲覧できないプロジェクトは、URLを直接開いても存在しないものとして扱われます。

この制限は本サービスの画面上のものです。 GitHubやGoogleドライブ側で対象のリポジトリ・フォルダへのアクセス権を持つ方は、それらのサービスから直接内容を閲覧できます（利用規約第3条）。

4. 知っておいていただきたいこと

業務データの正本はGitHubとGoogleドライブにあります。本サービスは閲覧と編集の窓口であり、本サービスが停止してもデータは残ります。
GitHub連携の共有 — 同じGitHubインストールを複数のアカウントで共有できます。共有した場合、共有先の各アカウントのオーナーは、そのインストールがアクセスできるすべてのリポジトリの名称を閲覧でき、そのうち任意のリポジトリを自分のアカウントに登録して内容を閲覧できます。また、GitHub APIの利用枠も共有されます。会社間で閲覧範囲を厳密に分離したい場合は、会社ごとにGitHubの組織を分けてインストールしてください（利用規約第5条）。
本サービスからの書き込み（Issueへのコメント等）はGitHub App名義で行われるため、本文に操作者の名前を自動で付記します。
詳しい条件は「利用規約」と「プライバシーポリシー」をご確認ください。

5. うまくいかないとき

リポジトリの一覧が空、または「停止中」と表示される — GitHub側でAppのインストール状態と、選択しているリポジトリを確認してください。
タスクやドキュメントが表示されない — ステップ1の紐づけが済んでいるかを確認してください。
AIチャットが表示されない — プロジェクトでAIチャットの機能がONになっているかを確認してください。表示されるのに応答しない場合は、アカウントにAnthropic APIキーが設定されているかを確認してください。
「本日の依頼上限に達しています」と表示される — そのプロジェクトの1日あたりのAIセッション件数が上限に達しています。オーナーがプロジェクト設定で上限を変更できます。
「今月のAIセッションの利用額が上限に達しています」と表示される — そのアカウントの今月のAIセッション利用額が上限に達しています。オーナーがアカウント設定で上限を変更できます。
解決しない場合は、運営者（山下将大 masahiro11g@gmail.com）までご連絡ください。

ログインページへ戻る