MENU
bekichi
小中高生向けのプログラミング情報を発信しております。本ブログがプログラミングの勉強を始めるきっかけになると嬉しいです。どうぞ、お気軽にお付き合いください!
アーカイブ
カテゴリー


「Excelの壁」を乗り越え、AIと「ツーカーの仲」に!ドキュメントMarkdown化で開発現場が劇的に変わった話

  • URLをコピーしました!


目次

AI活用を阻む「Excelの壁」って?

オーエムネットワーク株式会社(OMN)の開発現場でも、最新の生成AI「Claude Code」を導入して、コード生成や仕様確認のスピードアップを図っていました。でも、使ってみると、AIがExcelで作成された仕様書の内容を誤解したり、情報の階層をうまく読み取れなかったりするケースが稀に発生したそうです。最初はプロンプト(AIへの指示)を工夫して対応しようとしたものの、指示が複雑になりすぎて、かえって運用が難しくなるという本末転倒な状況に陥ってしまいました。「何か根本的にAIと噛み合っていない…」そんなモヤモヤがチーム内に漂っていたといいます。

問い直す「当たり前」が変革の第一歩

この状況を打開するため、OMNの開発チームは社内のAI専門チームに相談を持ちかけました。当初の目的は「複雑なExcelファイルをAIに正しく解析させる技術的な解決策」を見つけること。ところが、AI専門チームから返ってきたのは、予想外の、でも本質的な問いかけでした。

「そもそも、ドキュメントをExcelで作成している理由って何ですか?」

この一言は、開発チームにとってまさに「目から鱗」の体験だったそうです。「仕様書はExcelで作るもの」という長年の固定観念に縛られ、人間用のフォーマットをAIに無理やり理解させようとしていたことに気づかされた瞬間でした。AIにとって最適なのは、人間用のレイアウトではなく、情報の構造が明確な形式であるはず。「AIに合わせさせるのではなく、AIが最も力を発揮できる形をこちらが用意すればいいんだ!」この視点の転換こそが、OMNの新たなドキュメントDXの始まりとなりました。

AI解析トークン量削減の図

Markdown化でAIとの距離がぐっと縮まる!

検証の結果、AI(Claude Code)が最も正確かつ高速に解析できる形式は、シンプルな階層構造を持つ「Markdown(md)」であることが判明しました。Excelファイルは書式やセル位置などのメタデータを大量に含むため、AIが読み込む際に多くのトークン(AIが情報を処理する単位)を消費しがちです。しかし、Markdownでは冗長な情報がほとんどなく、構造が明確なため、同等内容のドキュメントを処理する際のトークン消費量は、Excel経由と比較しておよそ10分の1程度に抑えられているそうです(OMNの試験運用に基づく推計値)。

AIとまるで「ツーカーの仲」のように意図が通じるようになったことで、AIへの無駄な修正指示(プロンプトのやり直し)が激減。開発の手を止めることなく、最速で実装まで進めるようになったといいます。この成果を受けて、OMNの開発チームは2026年4月までに、主要な設計書や開発資料の大部分をMarkdown形式に刷新しました。

この刷新は、正式な仕様書だけでなく、技術メモやナレッジベースなど、これまで散逸しがちだった情報にも及びました。結果として、AIへの文脈共有がスムーズになり、エンジニア間の情報共有における認識の齟齬も減少しています。情報の形をAIに合わせて整えるという一つの決断が、現場の知恵を「AIを最も賢く動かすための強力な資産」へと変えたのです。

開発フローの変化図

現場のエンジニアからは「以前のExcelベースの設計書では、AIに仕様を理解させること自体が最大の難所でした。開発本体よりも、『仕様を解釈させるための前準備』に膨大な時間とトークンを費やしていたのが実情です。それが今では、Markdownという共通言語を得たことで、AIとツーカーの仲になれました。AIがドキュメントを即座に正確に読み解いてくれるため、本来注力すべき『システム実装』と『品質向上』に、開発リソースのすべてを投入できています。仕様変更時の修正スピードも圧倒的に向上しましたね。」という声が聞かれています。

工数削減効果の表

このMarkdown化によって、コーディング工数は約30%削減、チーム内コミュニケーション(共有事項のMarkdown化を含む)も約20%削減されたと推計されています(OMNの運用に基づく推計値)。

AIと人が共存する未来のドキュメント管理

もちろん、Markdownだけでは人間にとって見づらい場合もありますよね。Markdownはデータ構造の記述には優れていますが、直感的に内容を把握するには、やはり適切なレイアウトや視覚的な整理が欠かせません。

そこでOMNの開発チームでは、Markdownを情報の「マスターデータ」とし、人間が閲覧する際には、Claude CodeなどのAIツールを使って即座に「HTML形式」へと書き出す運用フローを確立しました。AIには解析効率の高い「構造」を渡し、人間には、AIを活用して生成された直感的な「レイアウト」を提供する。変換作業に手間をかけることなく、AIの力を借りて『人間にとっての最適な表示』を一瞬で用意する。この工夫こそが、OMNが追求する、AIと人が共存するためのDXの形なのです。

「当たり前」を疑い、新しい自分に出会う一歩を

今回のOMNの取り組みは、単なるファイル形式の変更に留まりません。ドキュメントを「AIと一緒に未来を創るための共通言語」として再定義する試みです。情報の形をAIに合わせて最適化することで、エンジニアはより本質的な設計や品質向上にリソースを割くことが可能になりました。

この知見は全社的な標準ナレッジとして展開され始めており、組織全体のDXを加速させる一助となっています。私たちも、最新技術を柔軟に取り入れながら、現場の知恵で最適解を導き出し、お客様へ最速で最高の価値を届けられるよう挑戦を続けていくことでしょう。

皆さんの職場や学習においても、「これは当たり前」と思っていることに、実はもっと良い方法が隠されているかもしれません。少し立ち止まって、「そもそも、これってどうしてこうなっているんだろう?」と問い直してみる勇気が、新しい発見や大きな変化を生み出すきっかけになるはずです。AIが身近になった今だからこそ、私たち人間が「当たり前」を疑い、新しい技術とどう共創していくかを考えることが、より良い未来を拓く鍵になるでしょう。ぜひ、一歩踏み出してみてくださいね。

OMNのウェブサイトはこちらです。

OMNが提供するシフト管理システム「R-Shift」に関する情報はこちらです。


ロボット・プログラミング教室へ通うことのすすめ

プログラミングを勉強するだけなら、本ブログでも十分ですが、できればロボットプログラミング教室に通うことをお勧めします。ロボットプログラミング教室に通うことで早い段階から以下のことが身につくためです。

  • 論理思考の向上: プログラミングを学ぶことで、問題を分析し、段階的に解決する論理的思考力が身につきます。
  • コミュニケーション能力の発展: 毎回異なるペアとの協力を通じ、自分の考えを伝え、他者の意見を理解することで、表現力と協同作業のスキルが向上します。
  • 創造力の刺激: ロボットをレゴブロックで作る活動は、子どもたちの創造力を鍛え、想像力を広げる素晴らしい機会を提供します。
  • 自己成長の実感: 競技会を通して、クラス外の生徒や他の教室と競争することで、自らの成長を実感し、自信を育む機会を得られます。
  • 実践的なスキルの習得: カリキュラムが進むにつれ、実社会で活用されるプログラミング言語Pythonの学習が可能になります。
  • 社会的スキルの発展: 様々な人との良好な関係を築くことの重要性を学び、社会生活において必要なスキルを身につけます。
よかったらシェアしてね!
  • URLをコピーしました!
目次