القائمة
教材（curriculums/配下のMarkdown）の内容を修正・改善するときの標準ワークフロー。「Issue
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
| name | section-fix |
| description | 教材（curriculums/配下のMarkdown）の内容を修正・改善するときの標準ワークフロー。「Issue |
このスキルは、教材（curriculums/ 配下のMarkdown）を修正・加筆するときの進め方をまとめたものです。初学者向け教材なので、既存の文体・構成を壊さないことと、着手前にユーザーの承認を得ることを最優先にします。
教材は多くの受講生が読む公開物で、GitHub Actions 経由で LMS に同期されます。思い込みで直すと、正しい記述を壊したり、別Sectionとの前提がずれたりします。だから「何を・なぜ直すか」を先に共有し、合意してから手を動かします。
gh issue view {番号} で内容を確認する。gh api repos/coachtech-material/pj-ct-newtext/milestones でDescriptionを確認し、方針を把握する。{T}-{C}-{S}_{見出し名}.md で curriculums/ から対象ファイルを探す。必ず本文を読んでから判断します。あわせて種別に応じたガイドを読みます。
| 読むもの | いつ |
|---|---|
.claude/CLAUDE.md | 常に（プロジェクト全体のルール） |
guides/writing-rules.md | 常に（文体・表現） |
guides/section-structure.md | 通常Sectionのとき |
guides/handson-structure.md | ハンズオンSectionのとき |
guides/verification.md | 検証するとき |
quiz/ の対応ディレクトリ | そのSectionに確認問題があるとき |
最新の main から切ります。
git checkout main
git pull --ff-only origin main
milestone/{マイルストーン名} が無ければ作成、あればチェックアウト。git checkout -b fix/{Section番号}-{説明}（例: fix/10-2-4-middleware-handson）。.claude/CLAUDE.md の規約に合わせる。<img alt="{N}-{M}-{S}_{連番}.png" src="">（src は空）。実ファイルは image/ に置く。空の src は公開時に GitHub Actions が S3 URL へ自動置換する。/verify-handson で検証する。git add {変更ファイル}
git commit -m "{Tutorial番号}: {修正内容の要約}
Co-Authored-By: Claude <noreply@anthropic.com>"
git push -u origin {ブランチ名}
gh pr create --base main --title "{要約}" --body "修正概要 ...
Closes #{Issue番号}"
Closes #{番号} を必ず入れる。Co-Authored-By 行は不要。استنادا إلى تصنيف SOC المهني
教材をLMS（学習管理システム）に反映・公開するときの運用手順。「LMSに反映したい」「教材を公開／デプロイして」「stagingに同期して」「本番に反映して」「画像をS3にアップして」「GitHub Actionを回して教材を更新して」などで必ず使う。main=本番LMS / staging=Staging LMS の対応、GitHub Actions 4本（画像S3置換×2・教材同期×2）の実行順序・実行方法・確認方法を案内する。教材の反映・同期・公開・画像URL置換に関わる依頼なら、明示的にワークフロー名を言われなくても使うこと。
概念Sectionの確認問題（question.md）と模範解答（model-answer.md）を quiz/ 配下に追加・編集するときに使う。「確認問題を作って」「このSectionのquizを追加して」「模範解答を書いて」「概念チェック問題を用意して」などで使う。quiz/ は curriculums/ と同じ階層をミラーし、各Sectionをディレクトリで表す。1文の記述式問題・本文のみ（見出し行なし）・模範解答は別ファイル、という規約に従う。小テスト／確認問題／記述式クイズの作成・編集に関わる依頼なら使うこと。
ハンズオンSectionの検証。要件・手順の完全性をチェックし、問題点を報告。Use when verifying hands-on tutorial sections.
