ヘルプを言いかえたら、勝つたびにもらえるかいがらが「のこることがある」になっていた
『四十秒のオリ図鑑』は、町にひそむ不思議な生きもの「オリ」を集めて、図鑑を埋めていくブラウザのRPGです。オリは時間の「澱（よどみ）」が形になったものという設定で、戦って勝つと澱にもどります。ゲームの中のヘルプには「かいがらは オリが澱にもどるときに のこることがある」と書いてありました。かいがらはアイテムの1つで、港町のエリア「みなとまち」の市場「いちば」で、ほかのアイテムと交換できます。ヘルプを読むと、勝っても出ないときがあるように思えます。ところが実装では、みなとまちへ行けるようになったあとは、どの場所でも出ます。野生のオリや釣りで出てくるオリに勝てば、かならず1まい手に入っていました。
言いかえたときに「ことがある」が入った
見つけたのは、このゲームの別の制作ノート（このサイトに載せている開発の記録）を公開する前の読み直しでした。ヘルプの文と実装を並べると、確率で出るのか、毎回出るのかが食い違っています。このずれがあると、遊ぶ人の判断が変わるかもしれません。かいがらが確率でしか出ないと思えば、貴重なものだと考えて、いちばでの交換を控える人もいるでしょう。
履歴をさかのぼると、このヘルプの1文は、書いた時点では「かいがらは 戦いに勝つと ひろえる」でした。勝てば手に入る、という点では実装と合っています。その2分後、登場人物の台詞にあった「オリとの勝負のあとに」を、戦闘の画面でも使っている「澱にもどる」という言いかたにそろえたとき、ヘルプの1文も同じ言いかたに寄せました。そこで「オリが澱にもどるときに のこることがある」となり、毎回だったものが、たまにと読める文になりました。ゲームの仕様自体は変えていません。言いかえただけで、頻度の意味が変わっていました。
出かたは変えず、実装を正として、ヘルプを「みなとまちへ行けるようになってから 野生や つりのオリに勝つたびに 1まい ひろえる」に直しました。物語の地の文にも「足もとに 小さく光るものが のこることがある。」とあります。こちらは主人公がかいがらに気づく場面の語りで、遊びかたの説明ではないので、そのまま残しました。
説明文92項目を、実装と照らし合わせた
1件で終わらせず、ほかの説明文も調べました。ゲーム内のヘルプ、遊び方のページ、紹介ページ、アイテムの説明文に書いてある仕様を1項目ずつ数えると、92項目ありました。照らし合わせる作業はAIに任せました。かいがらのほかに8件のずれが見つかり、合わせて9件になりました。8件は、直すために6つのissueに分けました。
特に大きな問題だったのは、図鑑の「そだち」です。76種のオリが、「大器ばんせい」69種と「おそくそだつ」7種の2段階にしか分かれていませんでした。「そだち」は、オリごとの育ちかたを、早い順に「はやくそだつ」「ややはやい」「ふつう」「おそくそだつ」「大器ばんせい」の5段階で表示する機能です。オリがわざを覚えるレベルから決めていて、ヘルプも遊び方のページも、5段階に分かれる前提で書いていました。2段階に偏ったのは、レベルが上がって覚えるわざを3つから4つに増やしたあとです。判定に最後のわざのレベルを使っていて、4つ目のわざはどの種も遅いレベルで覚えるからでした。こちらは説明ではなく判定のほうを直し、3つ目のわざのレベルで決めるようにしました。
ほかの7件は、4つ目のわざを覚える条件、絵馬というアイテムの強化が頭打ちになるところ、主人公のクラスメイトの明日香に初めて勝ったときにもらえるもの、主（ぬし）と呼ぶボスのいる場所と数、紹介ページの見出しにある町と主の数、あるわざを覚えるオリについての説明、それに「手持ち」という語の使いかたです。このゲームの「手持ち」は戦いに出す3体のことなのに、連れているオリ全部の意味で使っている箇所がありました。
「そだち」のずれは、画面にエラーが出ないので、見ただけでは気づきません。2段階の表示が出るだけで、どちらの表示も正しそうに見えます。かいがらの1文だけを直して終わらせていたら、見逃していたと思います。
説明文は、実装を変えても、言いかえてもずれる
かいがら以外の8件の多くは、仕組みを変えたときに、それを説明している文を見直していませんでした。「そだち」も、わざを増やしたときに、最後のわざのレベルで決めていた判定を見直していませんでした。かいがらはその逆で、説明の言葉だけを変えて、実装と見比べていませんでした。向きは違っても、組になっているものの片方だけを変えた箇所に、ずれが入っています。
説明は、ゲーム内のヘルプ・遊び方のページ・紹介ページの3か所に別々に書いてあり、アイテムの説明はコードの中にまた別にあります。合わせて4か所です。どれも実装の値から作った文ではなく、人が書いた文です。コードを変えても、説明の文を見張るテストは無いので、説明だけが古いまま残ります。
文の意味を実装と見比べないと、ずれは見えません。そのため、コードを変えるたびに自動で走らせている検査には入れていません。代わりに、ゲームの仕様を変えたときの手順書で、4か所を見直す項目に加えて、「ことがある」「かならず」「ごとに」「たびに」を検索する項目を足しました。オリ図鑑の説明では「かならず」をひらがなで書いているので、検索語もひらがなです。検索で出るのは一覧までで、突き合わせは人が実装を開いて行います。
説明文は、仕組みを1つずつ質問にして実装と並べる
この手順書には、見落としが2つ残っています。まず、開くきっかけが仕様を変えたときなので、かいがらのように言葉だけを直したときには開かれないことです。次に、語の検索で見つかるのが、量や頻度のずれまでだということです。「そだち」のずれには、そうした語が出てきません。説明文を書いた場所ごとに読んでも、どれも文としては自然なので気づきません。
今回は、説明文の側から92項目を1つずつ実装と照らし合わせました。次からは、ゲームの仕組みを1つずつ質問の形にするのがよいと考えています。たとえば「かいがらはどんなときに手に入るか」「そだちは何段階に分かれるか」と書き、ヘルプ・遊び方のページ・紹介ページ・アイテムの説明文がそれぞれどう答えているかを書き出して、実装の動きと並べます。食い違う答えがあれば、そこがずれです。仕組みを変えたときは、変えた仕組みの分だけ書けば、92項目を毎回調べ直さずに済みます。説明の言葉だけを直したときに、この並べかたをするきっかけは、まだ手順書にありませんが、同じように並べるつもりです。
かいがらの1文のように、言いかえただけでも説明の意味は変わります。仕組みに触れていないから大丈夫、とは言えません。