carbon-language

Carbonの`file_test`基盤を使い、toolchainのテストを作成・分割し、期待出力を自動更新する手順や命名規則を確認できます。

• toolchainのfile_testを書きたいとき
• テストケースを分割したいとき
• 失敗を検証するテストを作りたいとき

AIアシスタントがCarbonのコードベースを扱う際に、専用ツールでファイルを閲覧・検索・編集し、一時ファイルを管理するためのルールを示します。

• Carbonのファイルを規則に沿って検索したいとき
• 専用ツールを使ったファイル編集を確認したいとき
• 一時ファイルの置き場所と削除ルールを確認したいとき

Bazeliskを使ったCarbonプロジェクトのビルド、テスト、実行、デバッグの基本手順を確認し、対象を絞った検証やASanの利用方法も把握できます。

• Carbonのコードをビルドしたいとき
• 変更箇所に関係するテストを実行したいとき
• Bazelで作ったバイナリを起動したいとき

CarbonリポジトリでJujutsu（jj）を使い、変更の確認やコミット、リモートとの同期、変更スタックの管理を行うための基本操作を案内します。

• jjで状態や履歴を確認したいとき
• リモートから変更を取得したいとき
• 変更スタックの基点を調べたいとき

Carbonの`toolchain/*/testdata`の差分をコード変更と結び付け、入力・診断・出力の変更を漏れなく分類した報告にまとめる手順を示します。

• testdataの差分を報告したいとき
• 変更をテーマごとに分類したいとき
• 入力や診断出力の変更を列挙したいとき

コマンドラインからGitHub issueの本文やコメントを読み取り専用で確認し、URLや番号から対象リポジトリを指定する手順を案内します。

• issueの本文とコメントを読みたいとき
• URLからissueの内容を確認したいとき
• 別リポジトリのissueを参照したいとき

Carbonの提出前チェックツール`prek`の実行方法を案内します。対象ファイルの指定、Jujutsuでの実行、ファイルを自動修正した後の再確認にも対応します。

• 提出前に全ファイルをチェックしたいとき
• 変更したファイルだけ検査したいとき
• Jujutsu環境でチェックを実行したいとき

Carbonコンパイラのエラーや警告を定義し、書式やソース位置のラベルを整え、テストで網羅性を確かめる方法を案内します。

• 診断メッセージを追加したいとき
• エラー位置にラベルを付けたいとき
• 診断文の表記を統一したいとき

`gh`でGitHubのIssue、プルリクエスト、リポジトリを読み取り専用で検索・確認し、必要な情報を絞り込む方法を案内します。

• Issueの内容や状態を確認したいとき
• PRの差分やチェック状況を見たいとき
• GitHub上のコードやリポジトリを検索したいとき

コンパイラのテスト出力差分を、意図した変更と隠れた不具合に分けて確認します。診断メッセージと内部出力を別々に評価し、更新後のテスト結果まで点検する手順を示します。

• 自動更新後のテスト出力差分をレビューしたいとき
• 診断メッセージの変更が妥当か確かめたいとき
• 内部出力の差分に原因を割り当てたいとき

CarbonのLanguage ServerとVS Code拡張の構成、LSPリクエストの処理、file_test形式のテスト作成・更新方法を説明します。

• LSPハンドラーの追加場所を調べたいとき
• Language Serverのテストを書きたいとき
• テストの期待値を更新したいとき

Carbonのコンパイラ基盤を調べ、ビルドやテスト、デバッグを進めるための構成・実装パターン・診断やエラー処理の指針を確認できます。

• toolchainの構成を調べたいとき
• コンパイラをビルド・テストしたいとき
• コンパイラの不具合をデバッグしたいとき

Carbonの進化提案を作成・提出・管理するための手順を案内し、既存の設計方針や議論を踏まえた提案文とPR説明の整合を支援します。

• Carbonの言語進化提案を作成したいとき
• 決定済みの課題を提案文書にまとめたいとき
• 設計案の代替案とトレードオフを整理したいとき

Carbonコンパイラに組み込み関数を追加する際の登録、型シグネチャ検証、定数評価、LLVMコード生成、テスト方法を案内します。

• 組み込み関数を登録したいとき
• 定数評価の処理を実装したいとき
• LLVM IRへの変換を追加したいとき

Carbonツールチェーンのコードを書く際に、言語ごとの整形方法やコメント、命名、ドキュメント、コミットメッセージの基準を確認できます。

• Carbonコードの書式を整えたいとき
• コメントやドキュメントを見直したいとき
• コードの名前が意味に合うか確認したいとき