ba-bot 利用ガイド

このチャンネルに登録されている「GitHubリポジトリ ↔ Asanaプロジェクト（またはセクション）」の組み合わせを表示します。

別名・Asanaの対象範囲・既定かどうかが分かります。まず状況を確認したいときに使ってください。

1つのAsanaプロジェクトをセクションで分けて複数リポジトリを運用する場合に、紐付けで指定するセクションIDを調べるために使います。

結果はそのまま /ba-link の第2引数に貼り付けられる形（プロジェクトID/セクションID）で表示されます。

AsanaプロジェクトのURLをそのまま貼っても構いません。

実行するたびに紐付けが「追加」されます。既存の紐付けは消えません（同じリポジトリを再登録したときだけ内容が更新されます）。

Asanaの分け方は2通りに対応しています。リポジトリごとにプロジェクトを分けている場合はプロジェクトIDだけを、1つのプロジェクトをセクションで分けている場合は プロジェクトID/セクションID を指定します。

別名は、Slackで対象を明示するときの短い名前です（@ba-bot [chick] … のように使います）。省略するとリポジトリ名がそのまま別名になります。

そのチャンネルで最初の紐付けは、自動的に「既定」になります。

既定が使われるのは「調査・質問」のときだけです。

起票・実装・修正・一括削除は、対象が確定しない限り既定にフォールバックせず、候補を提示して聞き返します。誤ったリポジトリにPRを作ったり、別のセクションにチケットを溜めたりしないための仕様です。

紐付けを解除しても、GitHubのリポジトリやAsanaのタスクには一切影響しません。ボットが対象として扱わなくなるだけです。

解除した紐付けが「既定」だった場合は、残っている紐付けのいずれかが自動的に既定になります。

依頼文がそのままチケットのタイトルになり、本文は登録済みのテンプレート（概要・背景・受入基準）に沿って整形されます。

複数の紐付けがあるチャンネルでは、起票は手掛かりが無いため対象を自動判別できません。[別名] を付けて、どのプロジェクトに作るか指定してください。

セクション単位で紐付けている場合は、そのセクションに入った状態で作成されます。

別名を付けなければ、このチャンネルに紐付いた全てのプロジェクト／セクションを横断して表示します。

「未完了」「完了済み」といった語を含めると、その状態だけに絞り込めます。

タスク番号（gid）だけで特定できるため、別名の指定は不要です。

タイトルや本文を変更する場合は、新しい内容を「かぎかっこ」で囲んでください。

細かい編集は Asana の画面で行うほうが確実です。

1件だけの削除は、タスク番号を指定すればすぐ実行されます。

まとめて削除する場合は、いきなり消さずに対象一覧を提示して確認します。本当に削除するときだけ「確定」を付けて送り直してください。

一括削除は範囲を横断しません。セクション単位で紐付けている場合、削除されるのはそのセクション内のチケットだけです。対象が確定しない場合は実行せず候補を提示します。

Asana の削除はゴミ箱への移動なので、一定期間は復元できます。

対象リポジトリを取得し、Claude が実際にファイルを編集して、新しいブランチに Pull Request を作成します。

対象リポジトリは、タスクが属するAsanaのセクション（またはプロジェクト）から自動で判別されます。通常は別名の指定は不要です。

変更が1つも生成されなかった場合は、PRを作らずにその旨を返します。タスクの説明が具体的なほど結果が良くなります。

main ブランチへ直接 push することはありません。PR のマージは人が行います。

流れは「実装」と同じですが、原因の特定と最小限の変更を優先し、可能であれば再発防止のテストも追加します。

バグ・設計・可読性・テストの観点で指摘し、それぞれに重大度（高／中／低）を付けます。

結果は GitHub の PR にコメントとして投稿され、同じ内容が Slack にも返ります。

PRのURLを貼れば対象リポジトリが確定するため、別名の指定は不要です。

対象PRのブランチに直接コミットを積むため、新しいPRは作られず、そのPRが更新されます。レビュー → 修正 → 再レビューが1つのPRの中で完結します。

PRに付いているコメント（レビュー本文・ファイル単位のインラインコメント）を読み取り、その内容に基づいて修正します。

依頼文で対象を絞ることもできます（例:「パスワード例の指摘だけ修正して」）。

対象リポジトリを取得したうえで実際のコードを読み、紐付いたAsanaのタスク一覧も踏まえて回答します。推測ではなく実データに基づいて答えます。

PRのURLを含めれば、そのPRの説明や差分も踏まえて回答します。

「〜できますか？」のような質問で、勝手に実行されることはありません。