Skip to content

EPIC: 日本語モードを、共通テスト用プログラム表記を読む力をつける機能へ切り替える #1731

Open
38 of 42 issues completed

Description

@smalruby3-editor-bot

目的

日本語モード(コードと docs では「DNCL モード」)の方針を、共通テスト「情報I」の 共通テスト用プログラム表記 を 読む力をつける ための機能へ切り替える。
方針の正本は docs/dncl/policy.md に置く(PR で追加中。AI と autopilot はここを先に読む)。

AI が理解したこと

対応する言語

  • スモウルビーが対応するのは、共通テスト「情報I」で使われる 共通テスト用プログラム表記 である。
    • まとまった仕様書は無く、文法ははっきり決まっていない。
    • 問題文の中で必要な補足をして、前提知識が無くても答えられるようにしている。
    • 大学入試センターも「問題文の記述を簡潔にするため、異なる形式で出題することがある」と断っている。
  • 試験で問われるのは、問題の前提文を含めて 読み解く力 である。
    • 問題は、穴埋め(空欄に入るものを選ぶ)や、ある入力で出力がどうなるかを答える形式。
    • 0 からプログラムを書く力は問われない(記述式の問題は出ない)。
  • 大学入試センターの「共通テスト手順記述標準言語(DNCL)の説明」(2022 年 1 月)は 情報関係基礎 のためのもので、情報I とは別物である。
    • 情報関係基礎は、主に専門学科・総合学科の受験者が受ける試験。
    • 情報I で DNCL の書き方が参考にされることはある。しかし、受験者が DNCL を知識として知っている前提の問題は出ない。
DNCL(情報関係基礎) 共通テスト用プログラム表記(情報I)
代入 kosu ← 3 kosu = 3
表示 kosu を表示する 表示する(kosu)
ブロックの終わり を実行する / を繰り返す の行 字下げと、行の左の罫線
配列を作る Tokuten ← {87, 45, 72} Tokuten = [87, 45, 72]
かつ / または / 否定 かつ / または / でない and / or / not
比較 =、≠、≧、≦ ==、!=、>=、<=
  • 共通している点もある。
    • 繰り返しの「〜から〜まで〜ずつ増やしながら」。
    • 変数名はローマ字で、配列は大文字で始め、すべて大文字なら定数。
    • 行番号と、ブロックを示す縦線。
    • 配列の添字が 0 から始まるか 1 から始まるかを、問題文で指定する。

実際の問題から読み取れること

引用は、記法を示すのに要る数行にとどめる(出典は各項の見出しと「資料」)。

例 1: 大学入試センター「試作問題『情報Ⅰ』」(令和 4 年 12 月 23 日一部修正版)第 3 問

(3) maisu = 0, nokori = kingaku
(4) i を 【キ】 ながら繰り返す:
(5) |  maisu = 【ク】 + 【ケ】
(6) └  nokori = 【コ】
(7) 表示する(maisu)

(図 1 の一部。空欄は【】で示す)

  • 行番号: (1) の形で、0 埋めはしない。本文は「(4)〜(6) 行目」のように行番号で指す。
  • ブロック: 繰り返しの見出しは : で終わる。中の行の左に縦線 | を引き、最後の行は L 字で閉じる(PDF の文字は ⎿ U+23BF。引用の └ は書き写しのときの置き換え)。
  • 代入と配列:
    • 1 行に複数の代入を , で並べる。
    • 配列は [1,5,10,50,100] の形で作る。
    • 添字が 0 から始まることは、本文で断っている。
  • 演算: 整数の商 ÷ と余り % の意味は、会話文の中で説明している。
  • 繰り返しの空欄の選択肢: 「0 から 4 まで 1 ずつ増やし」「4 から 0 まで 1 ずつ減らし」など。増やす方向も減らす方向も出る。
  • 関数:
    • 枚数(金額) のように、日本語の名前と日本語の引数名で、枠の中の「関数の説明と例」として示す。
    • 定義の書き方は出てこない。戻り値も「(7) 行目の代わりに変数 maisu の値を関数の戻り値とすれば」のように文章で説明している。
  • 問われ方: 空欄に入る式を選ぶ、表示される値を答える。

例 2: 東進「共通テスト 情報I」問題ページの第 3 問(来訪者の待ち時間)

出典: https://www.toshin.com/kyotsutest/jouhou1_question_0.html (問題冊子の 24〜29 ページ)

(07) i を 2 から kyakusu まで 1 ずつ増やしながら繰り返す:
(08) |  Kaishi[i] = 最大値(【カ】, 【キ】)
(09) |  Shuryou[i] = 【ク】
(10) |  表示する(i, "人目の待ち時間:",
     └         【ケ】 - 【コ】, "分間")

(図 2 の一部)

  • 行番号: (01) の形で 0 埋めする。例 1 の (1) と違う(表記の揺れ)。
  • 1 つの文を 2 行に分ける: 表示する( の引数が次の行へ続き、続きの行には行番号が付かない。罫線の └ は続きの行に付く。
  • 添字が 1 から: 「すべての配列の添字は 1 から始まり」と本文で断っている(例 1 は 0 から)。添字の始まりは問題ごとに変わる。
  • 用意された関数:
    • 要素数(配列) と 最大値(x, y) を、【関数の説明】の枠で示す。
    • 枠には「例えば,最大値(1, 5) は 5 となり」のような例が付く。
    • 式の中で使う(kyakusu = 要素数(Touchaku))。
  • 表示する: 複数の値を , で並べ、つなげて表示する。実行結果は「体験時間 1 分間:最長待ち時間 0 分間」の形(図 4)。
  • 入れ子: 繰り返しの中の繰り返しや もし … ならば: は、縦線を重ねて示す。
  • 論理演算子の補足: and は「『and』は『かつ』を意味する論理演算子であり,左右の式がともに真のときにだけ真となる」と本文で説明している。
  • 条件の繰り返し: 「(03) 行目を『(taiken <= 15) and ( 【シ】 ) の間繰り返す:』に変更した」のように、プログラムの書きかえを文章で指示する。
  • 比較と代入: <=、<、> を使い、taiken = taiken + 1 のように代入する。
  • 問われ方:
    • 空欄に入る式・条件を選ぶ。
    • 行を差し込む位置を選ぶ(図の中の矢印 ⓪〜③)。
    • ある処理が何回実行されるかを答える(「修正後のプログラムでは【ソ】回となった」)。
    • 手で表を埋める(表 1 の待ち時間)。
  • 解答(東進の解答ページ): カ・キ = Touchaku[i] と Shuryou[i - 1]、ク = Kaishi[i] + taiken など。
    • 空欄を埋めたプログラムを動かせば図 4 の実行結果になるはずなので、スモウルビーで「読んで、動かして、確かめる」教材の題材になる(著作権の扱いは下の「資料の扱い」)。

2 つの例から分かること

  • 同じ試験の問題でも、行番号の形((1) と (01))、添字の始まり(0 と 1)が違う。決まっていないことは、問題文で毎回説明する。
  • 演算子・論理演算子・用意された関数の意味は、問題文の補足で説明する。読む力の練習には、プログラムと一緒に、その前提の説明文が読めることが大事。
  • 1 つの文が複数の行にまたがる書き方と、行を差し込む位置を問う形がある。スモウルビーで題材にするなら、行番号と罫線を残したまま読める・動かせることが要る。

人間が決めた改善の方針

  1. 日本語モードは、プログラムを読む力をつけるための機能とする。
    • 支える読み方(公式の問題に多い問われ方の順):
      1. 行番号と罫線を残したまま読めて動かせる。
      2. 行番号で行を指せる。
      3. トレース(1 行ずつ変数の変化を追う)ができる。
      4. 行の実行回数を数えられる。
      5. 空欄を埋めたり、行を差し込んだりして確かめられる。
  2. 文法を決める設定を選べるようにする。
    • 例: コメントは # にする、またはコメントは // にする(// をコメントにしたときは、// を整数の割り算には使えない)。
    • いくつかの設定をチェックボックスで選べる。
    • 選んだ設定は、プログラムの冒頭に説明文として書かれる。
    • 設定にするのは、意味が変わるもの、または問題文で約束されるもの(添字の始まり、コメントの記号など)。
    • 見た目だけの揺れ(行番号の形、罫線の文字、全角・半角、引き算の記号)は設定にしない。読むときは全部受け付け、書くときは 1 つにそろえる。
  3. 細かい設定が難しい、専門的ではない受験者のために、よくある設定のパターンをスモウルビーに用意する。
  4. プログラムは、設定に従った文法で表される。
  5. 文法の決め方(2026-11-12 人間が確定。2026-11-13 の見直しで足した。DNCL は困ったときに参照するもの):
    • 「例題」は公式の資料だけ(例示・サンプル問題・試作問題・本試験・追試験)。
      • 非公式の資料は、公式に無い記法の候補探しと、受け付ける揺れを知るためにだけ使う。
      • 意味が同じ揺れは、新しい年度の本試験・追試験に合わせる。
      • 例示は、問題文に約束が無いときの既定の解釈として使う。
    1. まず例題文から標準的な文法を見出す。実際の書き方(=、表示する(...)、罫線など)は例題に合わせる。
    2. 例題に記載が無いものは、DNCL に従う。言葉は DNCL から借り、見た目(:・罫線・=・( ... ))は例題に合わせる。
      • 例: 関数 名前(引数): と罫線で書き、と定義する の行は置かない。
    3. 例題に揺れがあって一意に決まらず(新しい年度でも決まらず)、DNCL に該当する記載があるときは、DNCL に記載があるものを採用する。
    4. 例題に揺れがあって、DNCL にも記載が無いときは、例題の書き方の中から、もっとも DNCL に近いもの、または Ruby の文法に近いものを採用する。
    5. 例題にも DNCL にも記載が無いもの(戻り値・要素の追加・繰り返しを抜ける文など)は、非公式の資料の多数派か、Ruby に近いものから選ぶ(例: 戻り値は 値 を返す)。
  6. 冒頭の説明文は、公式の問題文の約束の型に合わせる。
    • 常体で書き、読点は「,」を使う。
    • 例: 「すべての配列の添字は 1 から始まる。」「「and」は「かつ」を意味する論理演算子であり,…」
    • 問題の中で説明されない約束(罫線・表示する)は書かない。
  7. 呼び方と移り方:
    • 共通テスト用プログラム表記に合わせた書き方を「標準の形」と呼ぶ(旧「DNCLv2」)。
    • いまの書き方を「DNCL 風の形」と呼ぶ(旧「Smalruby DNCL」)。
    • 表示と書き出しは標準の形に切り替える。DNCL 風の形も、読み込みは続ける。

AI の確認したい点(基本設計で決める)

  • 冒頭の説明文の形(コメントにするか、専用の行にするか)と、設定をどこに保存するか(作品ごとか、利用者ごとか)。
  • 設定の項目と、よくある設定のパターン。
  • DNCL 風の形を、設定のパターンの 1 つとして残すか。
  • 書くときにそろえる 1 つの書き方。
    • 罫線の文字: 試作問題までは | と ⎿ が文字で書かれていた。R7 からは図形で描かれていて、文字の種類が分からない。
    • 行番号の形、空白など。
  • 関数の定義・後判定の繰り返し・2 次元配列・要素の追加を、決め方の ②・⑤ でどう書くか。
  • 移り方の手順。
    • 作品がブロックとして保存されていて、表示の形を変えても壊れないことを確かめる。
    • 生成AI に相談の答えの形と、教材・docs の書きかえ。

進め方

  1. スパイク: インターネットに自由にアクセスできる Claude で、共通テスト用プログラム表記の例題を集める(sub-issue)。
  2. 基本設計: 集めた例題をもとに、記法ごとに採用する書き方、設定の項目、よくある設定のパターン、冒頭の説明文の形を決める。
  3. 基本設計のあとで、実装の sub-issue に分ける。

範囲外

  • いま進めている日本語モードの不具合の Issue は、この方針で変える必要は無い(そのまま進める)。

資料

  • 大学入試センター「共通テスト手順記述標準言語(DNCL)の説明」2022 年 1 月(情報関係基礎)
  • 大学入試センター「試作問題『情報Ⅰ』」(令和 4 年 12 月 23 日一部修正)第 3 問
  • たいてっく「情報Iの擬似言語は DNCL ではない — 違いを整理する」
  • 突破口ドットコム「新 DNCL 文法解説〜情報Ⅰ共通テスト対策(共通テスト用プログラム表記)」
  • 東進「共通テスト 情報I」問題・解答ページ https://www.toshin.com/kyotsutest/jouhou1_question_0.html
  • 資料の写しは、人間の手元の tmp/to-ai-files/ にある(リポジトリには入れない)。

資料の扱い(著作権)

  • 大学入試センターの試験問題の著作権はセンターにある。二次利用(複写して配る、問題の一部または全部を使った問題集を作る。インターネット上も含む)には、センターへの「試験問題利用申請」が要る(試験問題のうち第三者に権利がある部分は、その第三者の許諾も要る)。
  • 東進のサイトで見つかった「データ利用について」は、閲覧者の情報の扱い(プライバシー)の説明で、掲載している問題の利用条件ではない。問題そのものの権利はセンターにあると考える。
  • このため、次のように扱う。
    • Issue・PR・docs では、記法を示すのに要る数行だけを、出典を付けて引用する。問題文の全文や図の全体は載せない。
    • 実際の問題を、そのままテストのデータや教材としてリポジトリ・スモウルビーに入れない。テストや教材には、記法をまねて自分で作ったプログラムを使う。
    • 実際の問題を教材として使いたくなったら、その時点で人間がセンターへの利用申請を判断する。

Activity

  1. smalruby3-editor-bot commented on Nov 14, 2026

    @smalruby3-editor-bot
    Author

    変換器の設計見直しの相談(EPIC #1826・https://claude.ai/artifact/9msQaw11Rqb7SzSKd4ZrHF 、2026-11-14 人間の答え)で、日本語 ⇔ Ruby の作りはこの EPIC で扱うことになりました(Q1)。決まったこと(Q7):

    順番(Q8): #1826 の構造の作り直しは、中 2「チャットをつくろう」(#1616)のあと、この EPIC の前。

  2. 14 remaining items

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions