| name | sync-chapters |
| description | 各章（ch1〜ch5_fin）の共有ファイルが正しく同期されているか検証し、不整合があれば修正する |
| allowed-tools | Bash, Read, Edit, Glob, Grep |
各章間の共有ファイルの同期を検証し、不整合があれば修正してください。本スキルの対象は claude-code/ 配下の各章のみで、kiro/ 配下は対象外。
claude-code/chN/ ディレクトリは章Nの演習の開始時点のファイルを含むclaude-code/ch(N+1)/ の開始時点に含まれるclaude-code/ch5_fin/ はch5の完成形（演習の出力結果）db/schema.sql / db/seed.py / db/connection.py の ソースオブトゥルース となる。下流章 (ch2〜ch5_fin) はこのスキーマ・実装を起点に増分する以下の各ペアで、記載されたファイルは完全に同一でなければならない。
| 比較 | 同一であるべきファイル |
|---|---|
| ch1 → ch2 | db/__init__.py, db/schema.sql, db/seed.py, db/connection.py (最小実装), sample_data.xlsx |
| ch2 → ch3-playwright / ch3-skill-creator | db/__init__.py, db/schema.sql, db/seed.py, sample_data.xlsx, tests/__init__.py, tests/test_seed.py (db/connection.py は ch3 以降で拡張版に切替) |
| ch3-playwright ↔ ch3-skill-creator (Python側) | app.py, db/connection.py, pages/01_equipment_dashboard.py, tests/__init__.py, tests/test_seed.py, db/schema.sql, db/seed.py |
| ch3-playwright / ch3-skill-creator → ch4 | 上記 + app.py, db/connection.py, pages/01_equipment_dashboard.py |
| ch4 → ch5 | sample_data.xlsx, db/__init__.py, db/schema.sql, tests/__init__.py は同一。その他のPythonファイルはruff適用済みで差分あり |
| ch5 → ch5_fin | db/seed.py, db/connection.py, pages/01_equipment_dashboard.py, tests/test_app.py, tests/test_connection.py, tests/test_seed.py |
注: ch1 の db/connection.py は 最小実装 (connect / apply_schema / DB_PATH のみ)、ch3 以降の db/connection.py はそれを 拡張 したもの (THRESHOLDS / PARAM_LABELS / get_connection / query_df を追加) で、両者は同一にはならない。ch1 → ch2 の db/connection.py は同期対象だが、ch2 → ch3 で拡張版に切り替わる。
ch4の演習（ruff check --fix + ruff format）により、ch5では以下のファイルにフォーマット・lint修正が適用されている。
app.py — ruff format適用db/connection.py — import順序修正 (I001)db/seed.py — 行長修正 (E501)pages/01_equipment_dashboard.py — import順序修正、zip() に strict=True 追加tests/test_seed.py — zip() に strict=True 追加tests/test_app.py — ruff format適用tests/test_connection.py — ruff format適用（変更なしの場合もある）ch5とch5_finで以下のファイルは差分があって正しい（ch5の演習の成果物）。
app.py — セマンティック検索ページのエントリ追加db/schema.sql — status_log_embeddings テーブル追加db/embed.py — 新規（Embedding生成スクリプト）pages/02_semantic_search.py — 新規（意味類似検索ページ）tests/test_semantic_search.py — 新規（セマンティック検索のテスト）pyproject.toml — torch, transformers, sentencepiece 追加| ディレクトリ | 含むべきファイル（README.md, pyproject.toml, data/factory.db 以外） |
|---|---|
| ch1 | db/__init__.py, db/schema.sql, db/seed.py, db/connection.py, sample_data.xlsx, CLAUDE.md, .gitignore, .claude/settings.json, .specify/ 一式, specs/001-monitoring-data-foundation/ 一式 |
| ch2 | dashboard.png, db/__init__.py, db/schema.sql, db/seed.py, db/connection.py (ch1 と同一の最小実装), sample_data.xlsx, tests/__init__.py, tests/test_seed.py, CLAUDE.md, .gitignore, .claude/settings.json |
| ch3-playwright / ch3-skill-creator | ch2のファイル（dashboard.png除く） + app.py, pages/01_equipment_dashboard.py。db/connection.py は ch1/ch2 の最小実装 + dashboard helper (THRESHOLDS / PARAM_LABELS / query_df) の 拡張版。ch3-skill-creator には加えて package.json, .npmrc, pnpm-lock.yaml, .gitignore |
| ch4 | ch3のファイル + tests/test_app.py, tests/test_connection.py |
| ch5 | ch4と同じファイル構成（ソースはruff適用済み） |
| ch5_fin | ch5のファイル + db/embed.py, pages/02_semantic_search.py, tests/test_semantic_search.py（schema.sql は status_log_embeddings 追加版、app.py はセマンティック検索ページエントリ追加版） |
各チャプターの pyproject.toml は name と description 以外、以下の期待差分に従う。
| ライブラリ | ch1 | ch2 | ch3 | ch4 | ch5 / ch5_fin |
|---|---|---|---|---|---|
| streamlit | ✓ | ✓ | ✓ | ✓ | ✓ |
| pandas | ✓ | ✓ | ✓ | ✓ | ✓ |
| plotly | ✓ | ✓ | ✓ | ✓ | ✓ |
| openpyxl | ✓ | ✓ | ✓ | ✓ | ✓ |
| pytest | dev | dev | dev | dev | dev |
| ruff | dev | dev | |||
| torch | ✓ | ||||
| transformers | ✓ | ||||
| sentencepiece | ✓ |
✓ = [project] dependencies、dev = [dependency-groups] dev
| セクション | ch1 | ch2 | ch3 | ch4 | ch5 / ch5_fin |
|---|---|---|---|---|---|
[tool.pytest.ini_options] | ✓ | ✓ | ✓ | ✓ | ✓ |
[tool.ruff] | ✓ | ✓ | |||
[tool.ruff.lint] | ✓ | ✓ |
pyproject.toml の内容が一致することname, description 以外の依存・設定が同一であることdiff で比較するpyproject.toml を上記マトリクスと照合するdb/schema.sql / db/seed.py の スキーマ整合性 を ch1 ベースに揃えた上で、各章のアプリ層は当該章の状態を維持する。ch5_fin 固有の差分は除く比較時に以下は無視する。
.venv/, __pycache__/, .pytest_cache/, .playwright-cli/*.lock, *.db, .DS_StoreREADME.md
[HINT] Download the complete skill directory including SKILL.md and all related files