使い方
リンクされたリポジトリでプルリクエストが開かれ、クロージングキーワードでWilletのタスクが参照されると、そのタスクは進行中に移動します。プルリクエストがマージされると、タスクは完了に移動します。この連携はタスクのステータスを前進させるだけで、完了済みまたはキャンセル済みのタスクは変更されず、再開またはリバートされたPRによってタスクがロールバックされることもありません。ステータスの変更は「Willet (GitHub)」に帰属し、PRのURLはタスクの履歴に記録されます。
セットアップ
リンクの設定はダッシュボードではなく、WilletのMCPツールを通じて行います。Willetに接続されているAIエージェントに依頼するか、ツールを直接実行してください。Willet組織の管理者またはオーナーのロール、およびGitHubリポジトリへの管理者アクセス権が必要です。
- GitHubでWilletにサインインします。リポジトリにWebhookを登録するために必要な権限をリクエストします。
- エージェントに `link_github_repo` ツールを呼び出すよう伝え、組織のスラッグ、プロジェクトのスラッグ、そして `owner/repo` 形式でリポジトリを指定してください。
- 保存されているGitHub認証にスコープが不足している場合、ツールはURLを返します。そのURLを開いて再認証し、link_github_repoを再度実行してください。
link_github_repo org_slug=<org> project_slug=<project> repo=<owner>/<repo>PRでのタスク参照
タスクを参照するには、人が読めるキー（プロジェクトのプレフィックスとタスク番号を組み合わせたもの、例：WD-42）か、26文字のULIDを使います。PRのタイトル、説明、またはブランチ名のどこにでも参照を記述し、クローズキーワードと組み合わせてください。1つのキーワードの後に、いくつでもタスクを並べられます。
Fixes WD-12, WD-13 and WD-14クローズキーワード
マッチングは大文字・小文字を区別せず、アクセント記号の有無も問いません。Willetがサポートするすべての言語で動作します。英語の標準キーワード（close/closes/closed、fix/fixes/fixed、resolve/resolves/resolved、complete/completes/completed）に加え、ドイツ語・スペイン語・フランス語・イタリア語・日本語・韓国語・トルコ語の自然な表現にも対応しています。動詞がタスクの前後どちらに来ても認識できるため（"fix <タスク>" でも "<タスク> fixed" でも）、語順が異なる言語にも対応しています。
セキュリティ
リンクされた各リポジトリには、マッピングごとに固有のHMAC Webhookシークレットが割り当てられるため、署名のないWebhookやリプレイされたWebhookによってタスクが移動されることはありません。Willetのマッピングが存在しないリポジトリからのWebhookイベントは破棄されます。この連携はリポジトリ↔プロジェクトのマッピング自体を信頼する仕組みです。リンクされたリポジトリでPRをマージできるユーザーは誰でもタスクのステータスを更新できるため、タスクを更新させたくないコントリビューターがいるリポジトリはリンクしないようにしてください。