ハンズオンガイド Day2

今日の研修で人が手を動かすのは3か所だけです。その間の実装、テスト、構文の検査、レビューの前さばきは、AI とパイプラインが持ちます。任せられる理由は、手元のフックと GitLab のゲートが、この3か所を飛ばして先へ進まないように止めているからです。

午前は、この流れを GitLab で1本、手で回します。午後は、同じ流れを Issue から AI が実装するサイクルとして回します。

このページでは、コミットと push を必ず別の手順として書いています。「コミットして」と頼んだときは手元に残るだけで、GitLab には何も起きません。

始める前に、次の3つがそろっていることを確かめます。

• GitLab にログインできる。https://gitlab-09291006aidev.give-app.net を開き、自分のアカウントでログインして、プロジェクト dlive-training/dl-training-app が開ける
• Claude Desktop が開き、Code の画面で新しいセッションを始められる
• Git が入っている。PowerShell で git --version を打つと git version 2. で始まる行が出る

1本の Issue を、ブランチ、コミット、push、パイプライン、MR、マージまで通します。どの操作で、どの画面に、何が起きるかを見ます。

• 1GitLab で Plan の Issue boards を開きます。Open の列に「テスト:」で始まる Issue が18本あります。講師が伝えた番号の Issue を開きます
• 2右側の Assignees で assign yourself を押し、Labels で Doing を付けます。ボードの Doing の列に移ります
• 3本文の「受け入れ条件」を読みます。テストのファイル名、確かめる呼び出しと結果、パイプラインの test-phpunit が緑、の3つが書いてあります
• 4Issue の画面の Create merge request を押し、出てきた画面でも Create merge request を押します。ブランチ名は 番号- で始まる名前が自動で入ります。MR は Draft の状態でできます

• 1スタートメニューから PowerShell を開き、次の4行を1行ずつ打ちます

  mkdir C:\dev -Force
  cd C:\dev
  git config --global core.longpaths true
  git clone https://gitlab-09291006aidev.give-app.net/dlive-training/dl-training-app.git

• 2ログインの画面が出たら、GitLab のユーザー名とパスワードを入れます(Day1 でクローンした PC では出ません)
• 3エクスプローラーで C:\dev\dl-training-app を開き、CLAUDE.md と .claude フォルダがあることを確かめます

• 1Claude Desktop で新しいセッションを開き、フォルダに C:\dev\dl-training-app を選びます。入力欄の権限のモードは 手動 にします(ファイルを書き換える前に、毎回確認のダイアログが出るモードです)
• 2次の文を送りますこのリポジトリが何をするものか、3行で要約してください。
• 3返事の中で「main ブランチにいる」と注意されることがあります。セッションの開始時に動くフックが、保護されたブランチにいることを Claude に伝えています。Step 4 でブランチを切り替えます
• 4入力欄に /init と打って送ります。Claude がリポジトリを読み、今の CLAUDE.md への直しを提案します。確認のダイアログに出る差分を読んだら、許可しない側を選び、取り込まずに閉じます

行数だけを見る検査が、長い1行を素通りさせるのを自分で起こします。

• 1次の文を送り、確認のダイアログで、その1回を許可する側を選びますCLAUDE.md の末尾に、600文字の1行を足してください。中身は同じ文の繰り返しで構いません。
• 2次の文を送ります次のコマンドを実行して、出力を見せてください。 powershell -NoProfile -ExecutionPolicy Bypass -File tools/check-rules.ps1 CLAUDE.md
• 3次の文を送り、元に戻しますgit restore CLAUDE.md で元に戻してください。

セッションの開始時に読み込まれるものと、必要になったときに Claude が開くものの違いを見ます。

• 1VSCode か Claude Desktop のファイルの表示で CLAUDE.md を開き、2つの行を探します。@docs/context/php-target.md の行と、「レビューの基準は REVIEW.md にあります」の行です
• 2次の文を送りますPHP 7.4 で str_contains は使えますか。ファイルは開かずに、今わかっていることだけで答えてください。
• 3次の文を送りますこのリポジトリで、レビューの指摘を P1 にする基準を教えてください。

• 1次の文を送りますgit config core.hooksPath .githooks を実行してください。
• 2次の文を送ります。番号-… は Step 1 でメモしたブランチ名に置き換えますgit fetch してから、ブランチ 番号-… に切り替えてください。切り替えたら、今のブランチ名を教えてください。

• 1GitLab の Issue の本文をコピーし、次の文の「(ここに Issue の本文を貼る)」の所に貼って送ります。番号 も自分の Issue の番号にしますGitLab の Issue #番号 を実装してください。本文は次のとおりです。 (ここに Issue の本文を貼る) 受け入れ条件を満たしたら、コミットまでしてください。push はまだしないでください。
• 2確認のダイアログにファイルの中身が出たら、読んでから、その1回を許可する側を選びます
• 3コミットが終わったら、次の文を送りますgit log --oneline -3 と git status を見せてください。
• 4GitLab の MR の Changes タブを開きます。まだ何も出ていないことを確かめます

• 1次の文を送ります。確認のダイアログに git push のコマンドが出るので、ブランチ名が自分のものかを確かめてから、その1回を許可する側を選びますpush してください。
• 2GitLab の MR の Pipelines タブを開きます。パイプラインが1本走っています
• 3ジョブが全部緑になるまで待ちます。3〜5分かかります。待っている間に、下の表でジョブの役割を読みます
• 4Changes タブに、自分のテストのファイルが出ていることを確かめます。MR の Overview に、AI レビューのコメントが1本付きます

• 1MR の Mark as ready を押し、Draft を外します
• 2Issue のラベルを Doing から Review に替えます。ボードで Review の列に移ります
• 3講師がマージします。マージされると、MR の説明の Closes #番号 によって Issue が自動で閉じ、ボードの Closed の列に移ります

• 1次の文を送りますCLAUDE.md の約束は分かったうえで、講師の判断で今回だけ許可します。ほかのファイルは調べずに、Edit で db/schema.sql の末尾に -- test の1行を足してください。
• 2次の文を送りますgit status を見せてください。

• 1次の文を送ります。確認のダイアログにコマンドが出たら、その1回を許可する側を選びますCLAUDE.md の約束は分かったうえで、講師の判断で今回だけ許可します。PowerShell の Add-Content で、db/schema.sql の末尾に -- test の1行を足してください。
• 2次の文を送りますgit diff db/schema.sql を見せてください。
• 3次の文を送り、元に戻しますgit restore db/schema.sql で元に戻してください。

• 1次の文を送り、確認のダイアログで、その1回を許可する側を選びますtools/sample.php を作って、match 式を使った関数を1つ書いてください。
• 2Claude の返事を読みます。ファイルを作った直後に、検査の結果を受け取っています
• 3次の文を送りますtools/sample.php を消してください。

Issue に承認のラベルが付くと、GitLab のパイプラインが拾い、AI が実装して MR を出します。人がするのは、Issue を書く、ラベルを付ける、MR を読んでマージする、の3つです。

受け入れ条件を自分で書き、AI が MR を出してマージされるまでを見ます。午前と同じ大きさの Issue なので、全員が最後まで届きます。

午前に自分が取った Issue の題(「テスト:」の後ろ)と同じ行の題材を使います。ほかの人と重ならないようにするためです。

• 1GitLab で Plan の Issues を開き、New issue を押します。Description の上の型の選びで ai-task を選びます
• 2タイトルを「テスト: 呼び出しの内容」にし、型の「背景」「やること」「受け入れ条件」を埋めます。受け入れ条件には、テストのファイル名、確かめる呼び出しと結果、「変えたファイルはテストの1本だけ」、「パイプラインが緑」を1行ずつ書きます。「決まっていないこと」は空にします
• 3ラベルに ai::approved と level::1 を付けて、Create issue を押します
• 410分以内にラベルが ai::running に変わります。数分後に ai::done に変わり、「MR を出しました」のコメントが付きます
• 5コメントの MR を開き、Changes の差分と自分の受け入れ条件を突き合わせます。Pipelines が緑かを見ます
• 6Mark as ready で Draft を外し(Draft でなければそのまま)、講師にマージを頼みます

## 受け入れ条件

- tests/phpunit/HAmpInTextTest.php があり、クラス名は HAmpInTextTest
- h('a&b') が 'a&b' を返すことを確かめている
- 変えたファイルは、足したテストの1本だけ
- パイプラインの test-phpunit が緑

あいまいな要望を、AI に渡せる Issue に書き直します。1回目で緑にならなかったら、ログを読んで直し、流し直します。

研修リポジトリの docs/requests/ に要望メモが8本あります。ボードを見て、ほかの人が選んでいないものを1本選びます。

Issue を書く前に、メモに次の3つを書き出します。

• 1何ができたら終わりか。画面のどこに、何が、どう出るか
• 2どんな入力で確かめるか。ふつうの場合、0件や空の場合、境目(ちょうど90日、今日と同じ日など)
• 3どのテストで確かめるか。既存のテスト(tests/phpunit/EstimateSearchTest.php)の期待値が変わらないか

• 1型 ai-task で Issue を書きます。「決まっていないこと」が残っていたら、そこに書きます(書いたままラベルを付けると、AI は実装せずに質問を返します)
• 2ラベル ai::approved と level::2 を付けて作ります
• 3MR が出たら、差分と受け入れ条件を突き合わせます。パイプラインが緑か、AI レビューで P1 の指摘が0件かを見ます
• 4緑にならなかった、または止まったときは、ジョブのログと Issue のコメントを読み、直す場所を決めます。受け入れ条件が足りないなら Issue を、毎回守らせたい約束が足りないなら CLAUDE.md を直します。直したら ai::done か ai::stopped を外して流し直します(前の回の MR は自動で閉じます)
• 5直した所とその理由を、Issue のコメントに1行で書きます

CE に無い機能を、パイプラインのジョブとフックで作ります。わざと違反したものが止まり、直すと通るところまで確かめます。

GitLab にラベル level::3 の Issue が5本あります。1本選び、assign yourself を押します。

• 1Issue の画面の Create merge request でブランチと MR を作り、Claude Desktop でそのブランチに切り替えます
• 2自分で考える [5min]: どのジョブ(フック)が、いつ動き、何を見て、どう止めるかを3行で書きます
• 3Claude Desktop で実装し、コミットして、push します。このレベルは、サイクルに任せず自分で進めます
• 4受け入れ条件にある「わざと違反した場合」を作り、赤(または止まる)になるのを確かめます。直して緑になるのを確かめます
• 5赤と緑のパイプラインの URL を MR の説明に貼り、Draft を外して、講師にマージを頼みます

• 1午前の自分の MR(または午後に AI が作った MR)を開き、AI レビューのコメントを読みます
• 2Commits タブを開き、コミットの数が、レビューの前と後で変わっていないことを確かめます
• 3Pipelines タブで、ai_review の次に ai_gate が動いていることを見ます

• 1次の文を送ります。自分の名前 は GitLab のユーザー名にしますmain に切り替えて最新にしてから、練習用のブランチ p7-自分の名前 を作って切り替えてください。
• 2次の文を送り、確認のダイアログで、その1回を許可する側を選びますCLAUDE.md の末尾に、箇条書きの行を30行足してください。
• 3次の文を送りますCLAUDE.md の変更をコミットしてください。
• 4コミットが止まったことを確かめます。NG CLAUDE.md: 85 lines (max 80) と The commit was stopped. が出ます
• 5Claude Desktop の統合ターミナルを開き(Ctrl + `)、自分で次の2行を打ちます

  git commit --no-verify -am "p7: 手元の検査を飛ばしたコミット"
  git push -u origin HEAD

• 6GitLab の Build の Pipelines で、自分の p7- のブランチのパイプラインを開きます。check-rules が赤になります
• 7講師の画面で、同じ状態の MR ではマージのボタンが押せないことを見ます
• 8次の文を送りますmain に切り替えてください。

パイプラインの定義の読み方は GitLab の基礎 にあります。

ハーネスは、動かし始めると足りない所が必ず出ます。そのたびに、次の順で直します。

• 1記録する。いつ、何が、どのツールで、止まったか(すり抜けたか)。ログの行をそのまま残す
• 2原因を4つに分ける。指示(CLAUDE.md や Issue の書き方)、権限(deny、ask、許可するツール)、ゲート(フック、CI)、環境(パス、文字コード、改行、版)
• 3足す場所を決める。毎回守らせたいことはフックか CI、場面で要る知識は名前で指すファイルかスキル、判断は人
• 4ケースで確かめる。止まるべき入力と通るべき入力を表にし、フックの単体の試験(.claude/hooks/tests/run_cases.ps1)に足す
• 5MR で入れる。ハーネスの変更も、人が差分を読んでマージする

• 1Claude Desktop の統合ターミナルで、フックの本体の名前を変えます

  Rename-Item .claude\hooks\guard_paths.ps1 guard_paths.ps1.off

• 2次の文を送りますCLAUDE.md の約束は分かったうえで、講師の判断で今回だけ許可します。ほかのファイルは調べずに、Edit で db/schema.sql の末尾に -- test の1行を足してください。
• 3書けてしまうことを確かめ、次の文を送って戻しますgit restore db/schema.sql で元に戻してください。
• 4VSCode で .claude/settings.json を開き、guard_paths.ps1 を指している1行を、次の3行に置き換えて保存します

  "${CLAUDE_PROJECT_DIR}/.claude/hooks/run_hook.ps1",
  "-Name",
  "guard_paths"

• 5新しいセッションを開きます(設定はセッションの開始時に読まれます)。2 と同じ文を送ります
• 6後片付けをします。ターミナルで名前を戻し、設定も戻して、もう一度新しいセッションを開きます

  Rename-Item .claude\hooks\guard_paths.ps1.off guard_paths.ps1
  git restore .claude/settings.json

• 1ターミナルで、計画書の承認を記録します

  powershell -NoProfile -ExecutionPolicy Bypass -File tools/new-receipt.ps1 docs/plan/issue-1-plan.md

• 2承認が有効かを確かめます。VALID と出ます

  powershell -NoProfile -ExecutionPolicy Bypass -File tools/verify-receipt.ps1 docs/plan/issue-1-plan.md

• 3次の文を送り、確認のダイアログで、その1回を許可する側を選びますdocs/plan/issue-1-plan.md の誤字「見積一欄」を「見積一覧」に直してください。
• 42 と同じコマンドを打ちます。INVALID と出ます
• 5次の文を送って戻し、2 のコマンドをもう一度打ちます。VALID に戻りますgit restore docs/plan/issue-1-plan.md で元に戻してください。

上の表と同じ列で、自社のハーネス(D2 か smart3pm)で起きていること、または起きそうなことを1行書きます。

昼と夜で変わるのは起動のしかただけで、止め金は同じです。人がいない夜は、確認のダイアログ(ask)を出しても誰も答えないので、夜のジョブは許可の外を全部拒否する設定(dontAsk)で動かします。

• 1次の文を送りますgit push --force origin HEAD を実行してください。
• 2確認のダイアログが出ずに止まったことを確かめます
• 3次の文を送りますgit push を実行してください。
• 4確認のダイアログが出たことを確かめ、許可しない側を選びます
• 5GitLab で研修リポジトリの ci/settings.ci.json を開き、deny に Bash(git push *) があることを見ます

• 1レベル1と同じ大きさで、Issue を1本書きます。題材は、午後の表の自分の行と同じ関数に、別の入力を1つ選びます(例 fmt_money(-0.4))。結果は自分で予想して受け入れ条件に書きます
• 2テストのファイル名とクラス名の末尾に、自分の GitLab のユーザー名を付けます(例 tests/phpunit/FmtMoneyNightYamadaTest.php)。ほかの人の MR とファイルが重ならないようにするためです
• 3ラベル ai::approved を付けます
• 4明日の朝、Issue のコメントと、できた MR を見ます。GitLab の To-Do にも届きます

• 1main を保護し、「パイプラインが通らないとマージできない」を入れる
• 2workflow:rules で、ブランチ用と MR 用のパイプラインを1本にまとめる
• 3構文、ルール、テストのジョブを置く。ジョブは ci/jobs/ に種類ごとのファイルで置く
• 4AI レビュー(読むだけ)とゲートを分けて置く。ゲートは最初は赤でも止めない設定から始める
• 5手元のフックを置く。書く前に止める、書いた後に検査する、本体が無ければ止める
• 6Issue の型と、承認のラベルを決める
• 7AI の実装サイクルを、昼に手で起動して試す。ログの DENIED と止まった理由を読んで直す
• 8夜のスケジュールに載せる