仕組みの動画
この研修で使う動画を48本まとめています。長さは1本26秒から107秒で、効果音と字幕だけで進みます。
ハルシネーションの起き方学習していない事柄でも確率で1つ選ぶため、根拠のない内容を言い切る
AIの答えの確かめ方数字と固有名詞と出典を、元の資料で1つずつ確かめる
段階に分けて頼む1回で全部頼まず、段階に分けて前の結果を次に渡す
出典つきの答え答えの文ごとに根拠の資料を示させると、確かめやすくなる
開発工程とAIの入れどころ要件、設計、実装、テストの各工程に、AIに任せる作業と人が決める作業がある
仕様駆動開発の流れ要求、仕様、設計、タスク、実装の各段で人が確かめてから進む
要件をAIと詰めるAIに問いを返させると、要件の抜けや曖昧さが見つかる
個人情報にあたる3種類単独で特定できる情報、ほかの情報と照らして特定できる情報、個人識別符号の3つが個人情報にあたる
モードと許可のボタンClaudeはモードによって確かめを出す操作が変わり、[常に許可]を押すと同じ形のコマンドが次から確かめなしで動く
渡す資料で変わるAIの出力AIは渡されていない会社の事情を知らないので、資料を渡さなければ一般的な知識で要件を埋める
CLAUDE.mdの約束ごとと設定の違いCLAUDE.mdの約束ごとは会話の最初に読み込まれるが強制ではないので、必ず止めたい書き込みは設定で止める
根拠の行を開いて確かめる手順要件に根拠のファイル名と行番号を付けさせると、人がその行を開いて同じことが書いてあるかを1件ずつ確かめられる
要件の4分類要件は機能、非機能、制約、課題の4つに分けられ、課題は誰のどの作業がどう変わればよいかまで書けて初めて要件になる
確かめられる要件の書き方要件は誰が・どの条件で・何をするかを1件に1つだけ書くと、読んだ人が同じ確かめ方を思い浮かべられる
要件が隠れる4つの書かれ方ヒアリングメモの要件は、雑談の前置き、「ちなみに」の一言、否定の形、別の話題の途中の数字の中に隠れやすく、AIも拾い損ねやすい
食い違いを要確認にする理由2人の発言が食い違う所は、AIにも書く人にも正しいほうを決められないので、両方の行番号を並べて要確認にする
あいまいな言葉を問いに直すAIはあいまいな言葉や空欄を一般的な数字で埋めることがあるので、数字を足さずに問いの形で要確認に書く
自分の候補を先に見せない理由自分の要件候補を先にAIに見せるとAIの抽出がそれに寄るので、別々に作ってから突き合わせると互いの抜けが見つかる
要件IDでつなぐ3回の成果物メモの行、要件ID、画面の項目、レビュー記録を同じ番号でつなぐと、あとの工程から元の発言までたどれる
MarkdownからWordへの変換AIには見出しと表を記号で書くMarkdownで書かせ、変換ツールでWordにすると、差分を確かめながら決まった書式の文書を作れる
抜け漏れを探す4つの観点要件定義書の抜けは、例外、運用、権限、データ移行の4つの観点で、書いていないことを自分に問うと見つかる
非機能をレベルで選んでもらう「止まると困る」のような非機能の要望は、非機能要求グレードのレベルから相手に1つ選んでもらうと数字になる
根拠のある指摘と一般論の見分けAIの抜け漏れの指摘には、どのシステムにも当てはまる一般論が混ざるので、データの行を根拠に示せる指摘だけを採る
画面一覧の4つの区分設計者は、直さない画面も画面一覧に並べ、影響なしと判断した理由を1行書いて残す。
画面遷移の図と状態の図画面遷移の図は画面の流れを描き、状態の図は1つの月の締め状態の変化を描くので、同じ画面が状態で見え方を変える場合は状態の図を1枚足す。
文字で書く図とMermaid遷移の図をMermaidの文字で残すとClaudeが読み直して直せるが、ブラウザはそのままでは図にしないので、見るためのHTMLを別に作らせる。
項目とチェックとメッセージをつなぐID画面設計書は項目、チェック、メッセージのそれぞれにIDを振り、チェックの行にメッセージIDを書くと、製造の担当がシートをまたいで同じものをたどれる。
入力チェックの3つの種類入力チェックは、画面の外を見ないと決まらなければ業務ロジック、複数の項目を比べないと決まらなければ相関、どちらでもなければ単項目に分ける。
システム例外の書き方システム例外は利用者が入力を直しても解消しないので、設計書には画面ごとの文言を書かず、共通エラー画面の方式に従うと1行で書く。
止めるエラーと知らせる警告エラーは保存を止め、警告は保存して知らせるので、警告を選ぶなら誰がいつ見直すかまで設計書に書く。
設計書の書き漏らしが見えるモック設計書に書いていない初期値、並び順、エラーの出る位置、確かめる時点はAIが決めて画面にするので、モックと設計書を見比べると書き漏らしが差として見える。
設計書とモックの往復モックで見つけた差は、書き足す、モックを直す、要確認の3つから番号ごとに人が選び、設計書をv0.2に直してからモックを合わせる。
決まりを1つずつ破る入力モックに入れる誤った入力は、1つの値で決まりを1つだけ破るように作ると、どのチェックがどのメッセージIDで動いたかを確かめられる。
As-Isに重ねる変わる箇所As-Isの図はメモにある作業だけで描いて箱に行番号を添え、改修で変わる箇所は同じ1枚に色で重ねると、今のやり方との違いを見比べられる。
請求と入金の消し込み消し込みは請求と入金を何対何で結ぶかの判定で、1対1、差額のある1対1、1対多、多対1の4つの形を分けると、一致しない入金の扱いを設計に書ける。
観点を分けたレビューの頼み方設計書のレビューは観点を1つに絞って1回ずつ頼むと、AIはその観点の見るところに沿った指摘を根拠の行つきで返す
レビューの6観点と読み方レビューの6観点は見るところと読み方がそれぞれ違うので、読む人は観点ごとに設計書をたどる向きを変える
指摘の4要素1件の指摘は場所、事実、根拠、影響の4つで書くと、読んだ人が設計書のどこをなぜ直すのかを聞き返さずに判断できる
指摘の重さの決め方指摘の重さは直さなかったときの影響で高、中、低に分け、AIが付けた並びは見立てなので、判定する人が自分で付け直す
採用・不採用・保留の判定レビュー記録の判定は採用、不採用、保留の3つで、不採用にも理由を書き、根拠の行を開いていないAIの指摘は保留と未確認にする
対応表を読む2つの向き要件と設計の対応表は、要件から設計へ読むと対応先のない要件が見つかり、設計から要件へ読むと根拠のない項目が見つかる
要件の変更と対応表要件が変わったときは、対応表を要件IDで引くと、直す設計の項目と確かめ直すテスト観点を件数で数えられる
等級の単価で出す原価社員の原価は、作業時間に等級ごとの単価を掛けて出す標準原価で、人ごとの給与は使わない
日単位と週単位のそろえ方日単位で分のデータと週単位で時間のデータは、月と時間にそろえてから足さないと、月の合計がずれる
画面を見る前の検算検算は画面の数字を見る前に自分の手で出してメモに書き、同じAIに確かめさせずに、表計算ソフトで出した数字と画面を比べる
縦と横の合計での確かめ社員ごとの合計を縦に足した数と、日ごとの合計を横に足した数が同じ総計になれば、集計から漏れた行は少ないと判断できる
数字がずれたときの切り分け手で出した原価と画面の原価がずれたら、工数、単価、式の順に比べると、どの段でずれたかを1つに決められる
禁止と条件付きの分け方AIに渡す情報は、置き換えれば渡せるかで分け、パスワードやAPIキーのような認証の情報は置き換えても渡さない