terminal-quest 1.1.2 → 1.2.1

package/README.md

@@ -46,6 +46,7 @@ terminal-quest
 - **ふりかえり問題** - ミッション完了後に4択クイズで理解度チェック
 - **Tab補完** - コマンド名やファイルパスをTabキーで補完
 - **達成バッジ** - 学習の進捗に応じてバッジを獲得
+- **やりなおし機能** - 進捗のあるストーリーを「はじめから」やりなおせる
 
 ## コース一覧
 
@@ -53,15 +54,41 @@ terminal-quest
 
 ### ✨ 小学生向けコース
 
-冒険の世界を舞台に、はじめてのコマンドを楽しく学びます。
+冒険の世界を舞台に、はじめてのコマンドを楽しく学びます。ひらがな中心のガイダンスで小学生でも安心。
 
-- **宝探し冒険**（10ミッション）
+**たからさがし大冒険**（10ミッション）
+
+| # | ミッション | 学べるコマンド |
+|---|-----------|--------------|
+| 1 | 冒険のはじまり | `pwd` `ls` |
+| 2 | 森を冒険しよう | `cd` `cat` |
+| 3 | 秘密基地を作ろう | `mkdir` `touch` |
+| 4 | 宝物を集めよう | `cp` `mv` |
+| 5 | トラップを片付けよう | `rm` `find` |
+| 6 | 暗号を解読しよう | `grep` `echo` |
+| 7 | 古い書物を読もう | `head` `tail` `wc` |
+| 8 | 仲間リストを整理しよう | `sort` `uniq` `cut` |
+| 9 | 封印を解こう | `chmod` |
+| 10 | 冒険の記録をつけよう | `git` |
 
 ### 💻 はじめてコース
 
 自分のパソコンを探検しながら、基本操作を身につけます。
 
-- **はじめてのパソコン冒険**（10ミッション）
+**はじめてのパソコン冒険**（10ミッション）
+
+| # | ミッション | 学べるコマンド |
+|---|-----------|--------------|
+| 1 | ここはどこ？ | `pwd` `ls` |
+| 2 | フォルダの中を見て回ろう | `cd` `cat` |
+| 3 | 写真アルバムを作ろう | `mkdir` `touch` |
+| 4 | ファイルを整理しよう | `cp` `mv` |
+| 5 | いらないファイルを片付けよう | `rm` `find` |
+| 6 | 日記を書こう | `echo` `grep` |
+| 7 | 長いレポートを確認しよう | `head` `tail` `wc` |
+| 8 | 連絡先を整理しよう | `sort` `uniq` `cut` |
+| 9 | 共有ファイルの設定 | `chmod` |
+| 10 | 変更履歴を管理しよう | `git` |
 
 ### 🖥️ エンジニアコース
 
@@ -97,6 +124,7 @@ terminal-quest
 help        使えるコマンド一覧
 hint        ヒントを表示
 objectives  現在の目標を確認
+cmds        このミッションの新コマンドを確認
 man <cmd>   コマンドのマニュアル
 ```
 
@@ -128,7 +156,7 @@ git clone https://github.com/nasuda/terminal-quest.git
 cd terminal-quest
 npm install
 npm run dev       # 開発実行
-npm test          # テスト実行（183件）
+npm test          # テスト実行（184件）
 npm run build     # ビルド
 ```
 

package/dist/App.js

@@ -9,13 +9,13 @@ import { MissionCompleteScreen } from './screens/MissionCompleteScreen.js';
 import { ProgressScreen } from './screens/ProgressScreen.js';
 import { SettingsScreen } from './screens/SettingsScreen.js';
 export function App() {
-    const { screen, progress, navigateTo, completeMission, completeStory, incrementCommands, resetAll, } = useGameState();
+    const { screen, progress, navigateTo, completeMission, completeStory, incrementCommands, resetStory, resetAll, } = useGameState();
     const renderScreen = () => {
         switch (screen.type) {
             case 'title':
                 return _jsx(TitleScreen, { onNavigate: navigateTo });
             case 'storySelect':
-                return _jsx(StorySelectScreen, { progress: progress, onNavigate: navigateTo });
+                return _jsx(StorySelectScreen, { progress: progress, onNavigate: navigateTo, onResetStory: resetStory });
             case 'missionBrief':
                 return (_jsx(MissionBriefScreen, { storyId: screen.storyId, missionIndex: screen.missionIndex, onNavigate: navigateTo }));
             case 'terminal':

package/dist/components/HintBar.js

@@ -4,8 +4,9 @@ import { colors } from '../utils/colors.js';
 export function HintBar({ hint, currentLevel, maxLevel }) {
     if (!hint)
         return null;
-    const levelColor = hint.level === 1 ? colors.hint1 : hint.level === 2 ? colors.hint2 : colors.hint3;
-    const levelLabel = `ヒント ${hint.level}/${maxLevel}`;
+    const isPreHint = hint.level === 0;
+    const levelColor = isPreHint ? colors.primary : hint.level === 1 ? colors.hint1 : hint.level === 2 ? colors.hint2 : colors.hint3;
+    const levelLabel = isPreHint ? 'ヒント' : `ヒント ${hint.level}/${maxLevel}`;
     return (_jsx(Box, { borderStyle: "round", borderColor: levelColor, paddingX: 1, marginTop: 1, children: _jsxs(Text, { children: [_jsxs(Text, { color: levelColor, bold: true, children: ["\uD83D\uDCA1 ", levelLabel, ":"] }), _jsxs(Text, { color: colors.file, children: [" ", hint.text] })] }) }));
 }
 //# sourceMappingURL=HintBar.js.map

package/dist/data/commands-meta.js

@@ -1,252 +1,258 @@
 export const commandsMeta = [
     {
         name: 'pwd',
-        description: '現在いる場所（ディレクトリ）を表示します。',
+        description: 'パソコンの中で「今どこにいるか」を教えてくれます。迷ったらまずこれ！',
         usage: 'pwd',
         examples: [
-            { cmd: 'pwd', desc: '今いるディレクトリのパスを表示' },
+            { cmd: 'pwd', desc: 'これだけでOK。今いる場所のパス（住所）が表示される' },
         ],
     },
     {
         name: 'ls',
-        description: '今いるディレクトリの中身を一覧表示します。',
-        usage: 'ls [パス]',
+        description: '今いるフォルダの中に何があるか一覧で見ます。引き出しを開けて中身を見るイメージです。',
+        usage: 'ls [フォルダ名]',
         examples: [
-            { cmd: 'ls', desc: '今いるフォルダの中身を表示' },
-            { cmd: 'ls /etc', desc: '/etc フォルダの中身を表示' },
-            { cmd: 'ls -la', desc: '隠しファイルも含めて詳しく表示' },
+            { cmd: 'ls', desc: 'これだけでOK。今いるフォルダの中身が表示される' },
+            { cmd: 'ls src', desc: 'ls のあとにフォルダ名を書くと、そのフォルダの中身が見える' },
+            { cmd: 'ls ..', desc: '1つ上のフォルダの中身を見る。.. は「上のフォルダ」の意味' },
+            { cmd: 'ls -la', desc: '-la をつけると隠しファイルも含めて詳しく見える' },
         ],
         options: [
-            { flag: '-a', description: '隠しファイルも表示' },
-            { flag: '-l', description: '詳細表示' },
+            { flag: '-a', description: '普段見えない隠しファイルも表示する' },
+            { flag: '-l', description: 'サイズや日付など詳しい情報も表示する' },
         ],
     },
     {
         name: 'cd',
-        description: '別のディレクトリに移動します。',
-        usage: 'cd <パス>',
+        description: '別のフォルダに移動します。パソコンの中を歩き回るイメージです。',
+        usage: 'cd <フォルダ名>',
         examples: [
-            { cmd: 'cd /home', desc: '/home に移動' },
-            { cmd: 'cd ..', desc: '1つ上のフォルダに戻る' },
-            { cmd: 'cd メモ', desc: 'メモ フォルダに入る' },
+            { cmd: 'cd src', desc: '今いるフォルダの中にある src に入る。名前だけ書けばOK' },
+            { cmd: 'cd ..', desc: '.. は「1つ上のフォルダ」の意味。/home/src にいたら /home に戻る' },
+            { cmd: 'cd ../docs', desc: '1つ上に戻ってから docs に入る。../ は「上のフォルダの」の意味' },
+            { cmd: 'cd /home', desc: '/ から始めるとフォルダの住所を直接指定できる（絶対パス）' },
         ],
     },
     {
         name: 'cat',
-        description: 'ファイルの中身を表示します。',
+        description: 'ファイルを開いて中身を読みます。メモ帳で開くようなイメージです。',
         usage: 'cat <ファイル名>',
         examples: [
-            { cmd: 'cat file.txt', desc: 'file.txt の中身を表示' },
-            { cmd: 'cat /var/log/app.log', desc: 'パスを指定して表示' },
+            { cmd: 'cat file.txt', desc: 'cat のあとにファイル名を書く。今いるフォルダの中のファイルが読める' },
+            { cmd: 'cat src/config.json', desc: 'src フォルダの中の config.json を読む。/ でフォルダを区切る' },
+            { cmd: 'cat ../memo.txt', desc: '1つ上のフォルダの memo.txt を読む。../ は「上のフォルダの」' },
         ],
     },
     {
         name: 'grep',
-        description: 'ファイルの中から指定した文字列を探します。',
-        usage: 'grep <探す文字> <ファイル名>',
+        description: 'ファイルの中から特定の言葉を検索します。ブラウザの Ctrl+F（文字検索）のようなものです。',
+        usage: 'grep <探す言葉> <ファイル名>',
         examples: [
-            { cmd: 'grep ERROR app.log', desc: 'app.log から "ERROR" を含む行を探す' },
-            { cmd: 'grep -n "port" config.json', desc: '行番号付きで "port" を探す' },
-            { cmd: 'grep -i hello file.txt', desc: '大文字小文字を区別せず探す' },
+            { cmd: 'grep ERROR app.log', desc: '実行すると app.log から ERROR を含む行だけが表示される' },
+            { cmd: 'grep -n "port" config.json', desc: '-n をつけると何行目に見つかったかもわかる' },
+            { cmd: 'grep -i hello file.txt', desc: '-i をつけると大文字・小文字を区別せずに探す' },
         ],
         options: [
-            { flag: '-i', description: '大文字小文字を区別しない' },
-            { flag: '-n', description: '行番号を表示' },
-            { flag: '-r', description: 'フォルダの中も全部探す' },
-            { flag: '-c', description: '見つかった行の数だけ表示' },
+            { flag: '-i', description: '大文字と小文字を同じものとして扱う' },
+            { flag: '-n', description: '見つかった行の行番号も表示する' },
+            { flag: '-r', description: 'フォルダの中のファイルも全部まとめて探す' },
+            { flag: '-c', description: '見つかった行の件数だけ表示する' },
         ],
     },
     {
         name: 'cp',
-        description: 'ファイルをコピーします。',
+        description: 'ファイルのコピーを作ります。右クリックの「コピー＆ペースト」と同じです。',
         usage: 'cp <コピー元> <コピー先>',
         examples: [
-            { cmd: 'cp file.txt file.bak', desc: 'file.txt のバックアップを作成' },
-            { cmd: 'cp memo.txt メモ/', desc: 'memo.txt を メモ/ フォルダにコピー' },
-            { cmd: 'cp -r src/ backup/', desc: 'src フォルダを丸ごとコピー' },
+            { cmd: 'cp file.txt file.bak', desc: '同じフォルダ内でコピー。file.bak という名前の控えができる' },
+            { cmd: 'cp file.txt src/', desc: 'file.txt を src フォルダの中にコピー。末尾の / は「中へ」の意味' },
+            { cmd: 'cp src/data.txt .', desc: 'src の中の data.txt を今いるフォルダにコピー。. は「ここ」の意味' },
+            { cmd: 'cp -r src/ backup/', desc: '-r をつけるとフォルダの中身ごとまるっとコピーできる' },
         ],
         options: [
-            { flag: '-r', description: 'フォルダの中身もまとめてコピー' },
+            { flag: '-r', description: 'フォルダの中身もまるごとコピーする' },
         ],
     },
     {
         name: 'echo',
-        description: '文字を表示したり、ファイルに書き込みます。',
-        usage: 'echo <文字列>',
+        description: '文字を画面に表示したり、ファイルに書き込みます。「おうむ返し」するコマンドです。',
+        usage: 'echo <文字>',
         examples: [
-            { cmd: 'echo "Hello"', desc: '画面に Hello と表示' },
-            { cmd: 'echo "data" > out.txt', desc: 'out.txt に "data" を書き込む（上書き）' },
-            { cmd: 'echo "追記" >> out.txt', desc: 'out.txt の末尾に追記' },
+            { cmd: 'echo "Hello"', desc: '実行すると Hello と画面に表示される。echo が文字をおうむ返しする' },
+            { cmd: 'echo "data" > out.txt', desc: '> をつけると画面ではなくファイルに書き込める。out.txt に data と保存される' },
+            { cmd: 'echo "追記" >> out.txt', desc: '>> にすると上書きせず末尾に書き足す。> だと中身が入れ替わるので注意' },
         ],
     },
     {
         name: 'mkdir',
-        description: '新しいフォルダを作ります。',
+        description: '新しいフォルダを作ります。「Make Directory（フォルダを作れ）」の略です。',
         usage: 'mkdir <フォルダ名>',
         examples: [
-            { cmd: 'mkdir src', desc: 'src フォルダを作成' },
-            { cmd: 'mkdir -p src/components/ui', desc: '途中のフォルダもまとめて作成' },
+            { cmd: 'mkdir src', desc: 'mkdir のあとに作りたいフォルダ名を書く。src フォルダができる' },
+            { cmd: 'mkdir -p src/components/ui', desc: '-p をつけると途中のフォルダもまとめて一気に作れる' },
         ],
         options: [
-            { flag: '-p', description: '途中のフォルダも一気に作成' },
+            { flag: '-p', description: '間のフォルダがなくても一気にまとめて作る' },
         ],
     },
     {
         name: 'mv',
-        description: 'ファイルを移動、または名前を変更します。',
-        usage: 'mv <移動元> <移動先>',
+        description: 'ファイルを別の場所に移動したり、名前を変えたりします。ドラッグ＆ドロップのイメージです。',
+        usage: 'mv <今の名前> <新しい名前 or 移動先>',
         examples: [
-            { cmd: 'mv old.txt new.txt', desc: 'ファイル名を old.txt → new.txt に変更' },
-            { cmd: 'mv file.txt src/', desc: 'file.txt を src/ フォルダに移動' },
+            { cmd: 'mv old.txt new.txt', desc: '同じフォルダ内で名前を変更する。old → new になる' },
+            { cmd: 'mv file.txt src/', desc: 'file.txt を src フォルダの中に移動。末尾の / は「中へ」の意味' },
+            { cmd: 'mv src/data.txt .', desc: 'src の中の data.txt を今いるフォルダに移動。. は「ここ」の意味' },
+            { cmd: 'mv ../memo.txt .', desc: '1つ上のフォルダの memo.txt をここに持ってくる' },
         ],
     },
     {
         name: 'rm',
-        description: 'ファイルやフォルダを削除します。',
+        description: 'ファイルやフォルダを削除します。ゴミ箱を通さず直接消えるので注意！',
         usage: 'rm <ファイル名>',
         examples: [
-            { cmd: 'rm file.txt', desc: 'ファイルを1つ削除' },
-            { cmd: 'rm -r old_dir', desc: 'フォルダごとまるっと削除' },
-            { cmd: 'rm -rf temp/', desc: '確認なしで強制的に削除' },
+            { cmd: 'rm file.txt', desc: 'rm のあとに消したいファイル名を書く' },
+            { cmd: 'rm -r old_dir', desc: '-r をつけるとフォルダの中身ごとまるっと削除できる' },
+            { cmd: 'rm -rf temp/', desc: '-rf で確認なし強制削除。取り消せないので注意！' },
         ],
         options: [
-            { flag: '-r', description: 'フォルダの中身もまとめて削除' },
-            { flag: '-f', description: '確認なしで強制削除' },
+            { flag: '-r', description: 'フォルダの中身もまとめて削除する' },
+            { flag: '-f', description: '確認メッセージなしで強制的に削除する' },
         ],
     },
     {
         name: 'find',
-        description: 'ファイルやフォルダを名前で探します。',
-        usage: 'find <場所> -name <名前>',
+        description: 'ファイルやフォルダを名前で探します。パソコンの中の「検索」機能です。',
+        usage: 'find <探す場所> -name <名前>',
         examples: [
-            { cmd: 'find .', desc: '今いるフォルダの中身をすべて表示' },
-            { cmd: 'find . -name "*.txt"', desc: '.txt で終わるファイルを探す' },
-            { cmd: 'find . -name "*.tmp"', desc: '.tmp ファイルを探す' },
-            { cmd: 'find /var -type f', desc: '/var の中のファイルだけ表示' },
+            { cmd: 'find .', desc: '実行すると今いるフォルダ以下のすべてのファイルが一覧表示される' },
+            { cmd: 'find . -name "*.txt"', desc: '実行すると .txt で終わるファイルだけが表示される。* は「何でもOK」の意味' },
+            { cmd: 'find . -name "*.tmp"', desc: '実行すると .tmp で終わるファイルが表示される。削除対象を探すのに便利' },
+            { cmd: 'find /var -type f', desc: '実行すると /var の中のファイルだけが表示される。-type f はファイル限定の意味' },
         ],
         options: [
-            { flag: '-name "パターン"', description: '名前のパターンで探す（* はワイルドカード）' },
-            { flag: '-type f', description: 'ファイルだけに絞る' },
-            { flag: '-type d', description: 'フォルダだけに絞る' },
+            { flag: '-name "パターン"', description: '名前で探す（* を使うと「何でもOK」の意味になる）' },
+            { flag: '-type f', description: 'ファイルだけに絞り込む' },
+            { flag: '-type d', description: 'フォルダだけに絞り込む' },
         ],
     },
     {
         name: 'touch',
-        description: '空のファイルを新しく作ります。',
+        description: '空っぽの新しいファイルを作ります。白紙のノートを用意するイメージです。',
         usage: 'touch <ファイル名>',
         examples: [
-            { cmd: 'touch new_file.txt', desc: '空の new_file.txt を作成' },
-            { cmd: 'touch README.md', desc: '空の README.md を作成' },
+            { cmd: 'touch new_file.txt', desc: 'touch のあとに作りたいファイル名を書く。空ファイルができる' },
+            { cmd: 'touch README.md', desc: '同じように README.md という空ファイルを作る例' },
         ],
     },
     {
         name: 'head',
-        description: 'ファイルの先頭部分だけ表示します。',
+        description: 'ファイルの最初のほうだけ読みます。長いファイルをちょっと覗きたいときに便利です。',
         usage: 'head <ファイル名>',
         examples: [
-            { cmd: 'head file.txt', desc: '先頭10行を表示（デフォルト）' },
-            { cmd: 'head -n 5 log.txt', desc: '先頭5行だけ表示' },
+            { cmd: 'head file.txt', desc: 'head のあとにファイル名を書く。最初の10行が表示される' },
+            { cmd: 'head -n 5 log.txt', desc: '-n のあとに数字を書いて行数を指定。ここでは5行' },
         ],
         options: [
-            { flag: '-n 数字', description: '表示する行数を指定' },
+            { flag: '-n 数字', description: '何行表示するか指定する' },
         ],
     },
     {
         name: 'tail',
-        description: 'ファイルの末尾部分だけ表示します。',
+        description: 'ファイルの最後のほうだけ読みます。最新のログを確認したいときに便利です。',
         usage: 'tail <ファイル名>',
         examples: [
-            { cmd: 'tail file.txt', desc: '末尾10行を表示（デフォルト）' },
-            { cmd: 'tail -n 20 log.txt', desc: '末尾20行だけ表示' },
+            { cmd: 'tail file.txt', desc: 'tail のあとにファイル名を書く。最後の10行が表示される' },
+            { cmd: 'tail -n 20 log.txt', desc: '-n のあとに数字を書いて行数を指定。ここでは20行' },
         ],
         options: [
-            { flag: '-n 数字', description: '表示する行数を指定' },
+            { flag: '-n 数字', description: '何行表示するか指定する' },
         ],
     },
     {
         name: 'wc',
-        description: 'ファイルの行数・単語数・バイト数を数えます。',
+        description: 'ファイルの行数や文字数を数えます。「Word Count（文字数カウント）」の略です。',
         usage: 'wc <ファイル名>',
         examples: [
-            { cmd: 'wc file.txt', desc: '行数・単語数・バイト数をすべて表示' },
-            { cmd: 'wc -l log.txt', desc: '行数だけ表示' },
-            { cmd: 'cat file.txt | wc -w', desc: 'パイプで受け取って単語数を表示' },
+            { cmd: 'wc file.txt', desc: '実行すると file.txt の行数・単語数・バイト数がまとめて表示される' },
+            { cmd: 'wc -l log.txt', desc: '実行すると log.txt の行数だけが表示される。-l は行数の意味' },
+            { cmd: 'cat file.txt | wc -w', desc: '実行すると file.txt の単語数が表示される。| で結果を次のコマンドに渡す' },
         ],
         options: [
-            { flag: '-l', description: '行数だけ表示' },
-            { flag: '-w', description: '単語数だけ表示' },
-            { flag: '-c', description: 'バイト数だけ表示' },
+            { flag: '-l', description: '行数だけ数える' },
+            { flag: '-w', description: '単語数だけ数える' },
+            { flag: '-c', description: 'バイト数だけ数える' },
         ],
     },
     {
         name: 'sort',
-        description: 'ファイルの中身を並び替えます。',
+        description: 'ファイルの中身を順番に並び替えます。あいうえお順や数字順にできます。',
         usage: 'sort <ファイル名>',
         examples: [
-            { cmd: 'sort names.txt', desc: 'あいうえお順に並び替え' },
-            { cmd: 'sort -n numbers.txt', desc: '数字の小さい順に並び替え' },
-            { cmd: 'sort -r data.txt', desc: '逆順に並び替え' },
+            { cmd: 'sort names.txt', desc: '実行すると names.txt の中身がアルファベット順に並んで表示される' },
+            { cmd: 'sort -n numbers.txt', desc: '-n をつけると数字の小さい順に並ぶ' },
+            { cmd: 'sort -r data.txt', desc: '-r をつけると逆順に並ぶ' },
         ],
         options: [
-            { flag: '-r', description: '逆順に並べる' },
-            { flag: '-n', description: '数字として並べる' },
-            { flag: '-t 文字', description: '区切り文字を指定' },
-            { flag: '-k 番号', description: '何番目の項目で並べるか指定' },
+            { flag: '-r', description: '逆順にする' },
+            { flag: '-n', description: '数字として比べて並べる（1, 2, 10 の順になる）' },
+            { flag: '-t 文字', description: 'データの区切り文字を指定する（, や : など）' },
+            { flag: '-k 番号', description: '何番目の項目を基準に並べるか指定する' },
         ],
     },
     {
         name: 'uniq',
-        description: '連続する同じ行をまとめます（重複削除）。',
+        description: '同じ内容が続いている行を1つにまとめます。sort と組み合わせて使うのが定番です。',
         usage: 'uniq <ファイル名>',
         examples: [
-            { cmd: 'sort data.txt | uniq', desc: 'まずsortしてから重複を削除' },
-            { cmd: 'sort data.txt | uniq -c', desc: '重複を削除して出現回数も表示' },
+            { cmd: 'sort data.txt | uniq', desc: '実行すると重複を消した一覧が表示される。| は左の結果を右に渡す記号' },
+            { cmd: 'sort data.txt | uniq -c', desc: '実行すると各行が何回出てきたか回数つきで表示される' },
         ],
         options: [
-            { flag: '-c', description: '何回出てきたか回数を表示' },
+            { flag: '-c', description: '同じ行が何回あったか回数も表示する' },
         ],
     },
     {
         name: 'cut',
-        description: '各行から特定の列だけ切り出します。',
+        description: '表のようなデータから欲しい列だけを取り出します。Excelの列選択のイメージです。',
         usage: 'cut -d <区切り文字> -f <列番号> <ファイル>',
         examples: [
-            { cmd: 'cut -d, -f1 data.csv', desc: 'CSVの1列目だけ取り出す' },
-            { cmd: 'cut -d: -f1,3 /etc/passwd', desc: ': 区切りの1列目と3列目を取り出す' },
+            { cmd: 'cut -d, -f1 data.csv', desc: '実行すると data.csv の1列目だけが表示される。-d, は区切り文字がコンマの意味' },
+            { cmd: 'cut -d: -f1,3 /etc/passwd', desc: '-f1,3 で1列目と3列目を一度に取り出せる' },
         ],
         options: [
-            { flag: '-d 文字', description: '区切り文字を指定（, や : など）' },
-            { flag: '-f 番号', description: '取り出す列の番号を指定' },
+            { flag: '-d 文字', description: 'データの区切り文字を指定する（, や : など）' },
+            { flag: '-f 番号', description: '取り出したい列の番号を指定する' },
         ],
     },
     {
         name: 'chmod',
-        description: 'ファイルの実行権限などを変更します。',
+        description: 'ファイルの「実行してもいいよ」という許可を設定します。スクリプトを動かすときに必要です。',
         usage: 'chmod <モード> <ファイル>',
         examples: [
-            { cmd: 'chmod 755 script.sh', desc: '実行可能にする（数字指定）' },
-            { cmd: 'chmod +x start.sh', desc: '実行権限を追加' },
+            { cmd: 'chmod 755 script.sh', desc: '実行すると script.sh に読み書き実行の権限がつく。755 は権限を表す数字' },
+            { cmd: 'chmod +x start.sh', desc: '+x は「実行を許可する」という意味' },
         ],
     },
     {
         name: 'git',
-        description: 'バージョン管理コマンド（シミュレーション）。',
+        description: 'ファイルの変更履歴を記録・管理するツールです。「いつ・何を変えたか」がわかります。',
         usage: 'git <サブコマンド>',
         examples: [
-            { cmd: 'git status', desc: '変更状態を確認' },
-            { cmd: 'git log', desc: '変更履歴を表示' },
-            { cmd: 'git branch', desc: 'ブランチ一覧を表示' },
-            { cmd: 'git checkout -b feature', desc: '新しいブランチを作って切り替え' },
+            { cmd: 'git status', desc: '実行すると変更されたファイルの一覧が表示される' },
+            { cmd: 'git log', desc: '実行するとこれまでの変更履歴が時系列で表示される' },
+            { cmd: 'git branch', desc: '実行するとブランチ（作業の分岐）の一覧が表示される' },
+            { cmd: 'git checkout -b feature', desc: '実行すると feature という名前の新しいブランチが作られ、そこに移動する' },
         ],
     },
     {
         name: 'man',
-        description: 'コマンドの使い方を表示します。',
+        description: 'コマンドの説明書を表示します。使い方がわからないときはこれで調べよう！',
         usage: 'man <コマンド名>',
         examples: [
-            { cmd: 'man', desc: '全コマンドの一覧を表示' },
-            { cmd: 'man ls', desc: 'ls の使い方を表示' },
-            { cmd: 'man grep', desc: 'grep の使い方を表示' },
+            { cmd: 'man', desc: '実行すると使えるコマンドの一覧が表示される' },
+            { cmd: 'man ls', desc: '実行すると ls の使い方・オプション・具体例が表示される' },
+            { cmd: 'man grep', desc: '実行すると grep の使い方・オプション・具体例が表示される' },
         ],
     },
 ];