build-context-site
Skill9 starsChanged 3 months agoMITView on GitHub
doc/input(確定)+ doc/draft(未合意)+ doc/generated + meta/adr-lite + history の最新を統合し、ローカル閲覧用の HTML サイト(要件・設計・ADR・図を横断)を生成する。確定と発酵中を状態バッジで区別して並べる。「ここ見れば全コンテキスト分かる」プロジェクト現状サイト。
In this repository57 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- accessibility-engineerSkill
- agent-browserSkill
- animation-principlesSkill
- architecture-expertSkill
- art-directionSkill
- auto-bugSkill
- auto-buildSkill
- auto-designSkill
- auto-taskSkill
- basic-reviewSkill
- biz-researcherSkill
- bug-fixSkill
- bug-investigateSkill
- bug-newSkill
- bug-proposeSkill
- creative-coderSkill
- deep-reviewSkill
- design-assembleSkill
- design-componentsSkill
- design-critiqueSkill
- design-htmlSkill
- design-mockSkill
- design-ssotSkill
- design-uiSkill
- developer-specialistSkill
- docs-reverseSkill
- experience-planSkill
- frontend-implementationSkill
- image-prepSkill
- judgment-harnessSkill
- keyboard-shortcutsSkill
- manual-genSkill
- manual-guideSkill
- official-source-firstSkill
- pairSkill
- persona-designerSkill
- project-design-languageSkill
- project-initSkill
- proposition-reviewerSkill
- proto-loopSkill
- proto-mediumSkill
- pr-respondSkill
- repo-tourSkill
- security-expertSkill
- sensory-designSkill
- session-endSkill
- session-startSkill
- setupSkill
- task-detailSkill
- task-listSkill
- task-runSkill
- template-feedbackSkill
- template-inboxSkill
- testingSkill
- ui-designerSkill
- usability-psychologistSkill
The file
Files
[ループ] 全コンテキスト HTML サイト /build-context-site
プロジェクトの全ドキュメントを横断できるローカル HTML サイトを生成する。要件・設計・ADR・履歴をブラウザ1つで把握できる場を作る。
設計根拠:
meta/adr-lite.mdの ADR-008 / ADR-011 / ADR-013
入力: $ARGUMENTS
- 省略時: 既定の対象範囲(後述)で全部生成
- 範囲指定する場合:
design/requirements/adr/allのいずれか
🎯 目的
- 散在する Markdown ドキュメント(
doc/input/*,doc/generated/*,meta/adr-lite.md)を一画面で横断できる HTML サイトにする - 図(drawio / mermaid)を埋め込みで構造を可視化
- 引き継ぎ・確認コストを下げる(人間も AI も同じサイトを参照可能)
- ローカルサーバで閲覧(外部公開はしない)
前提(必ず確認)
reviewable-html-workbenchプラグインが install 済みであること- 未 install の場合は手動でユーザーへ案内(後述)
- 対象ドキュメントが存在すること(空なら警告して生成スキップ)
- 出力先
doc/generated/context-site/の書き込み権限
reviewable-html-workbench の install 確認
claude plugin list | grep -i reviewable-html-workbench || echo "未install"未 install の場合、以下をユーザーへ案内して中断:
reviewable-html-workbench プラグインが必要です。以下を実行してください:
claude plugin marketplace add u-ichi/reviewable-html-workbench
claude plugin install reviewable-html-workbench
install 後に /build-context-site を再実行してください。対象ドキュメント
既定(all または引数省略時)
| カテゴリ | パス | 状態 | 用途 |
| 要件 | doc/input/rdd.md, doc/input/*.md | ✅ 確定 | プロジェクトのRDD・追加要件 |
| デザイン | doc/input/design/**/*.md, doc/input/design/**/*.json | ✅ 確定 | デザイン SSOT・モック |
| 発酵中 | doc/draft/**/*.md | 🧪 未合意 | プロトの学び・設定集・検討中の案 |
| 生成物 | doc/generated/**/*.md | — | マニュアル・自動生成ドキュメント |
| ADR | meta/adr-lite.md | ✅ 確定 | 設計決定ログ |
| 履歴(任意) | history/journal.md の最新7日分 | — | ローカル閲覧用、配布物には含まない |
⚠️ 状態はサイト上で必ず見えるようにする(次節)。 確定と未合意が並列に見えると、閲覧者が未合意のものを決定事項として読む。 ディレクトリを分けた意味が画面で消える。
引数による絞り込み
requirements: 要件のみdesign: デザインのみadr: ADR のみall: 全部(既定)
実行手順
1. 対象ドキュメントの収集
# 例: all の場合(draft も収集するが、状態を分けて保持する)
find doc/input doc/generated -type f \( -name "*.md" -o -name "*.json" \) 2>/dev/null
find doc/draft -type f -name "*.md" 2>/dev/null # ← 未合意として別扱い
cat meta/adr-lite.md
# history は最新7日分のみ2. 図の埋め込み準備(MCP)
ドキュメント中に以下のパターンがあれば、対応する MCP を呼び出して図を生成:
- mermaid コードブロック
```mermaid ... ```- そのままレンダリング可能(reviewable-html-workbench 側の
visual-html-rendererが対応)
- そのままレンダリング可能(reviewable-html-workbench 側の
- drawio リファレンス
<!-- drawio:path/to/file.drawio -->- MCP の drawio ツール(
mcp__drawio__open_drawio_xml)で XML をレンダリング
- MCP の drawio ツール(
- 構造説明テキスト(システム構成・データフロー等)
- 必要なら mermaid を新規生成して埋め込む(既存ドキュメントは改変しない、サイト側の overlay として)
⚠️ 既存ドキュメントは絶対に書き換えない。サイト生成時の overlay として図を足すだけ。
3. HTML 生成(reviewable-html-workbench の render)
# サイトのモデル定義(reviewable-html-workbench の build-model)
# 詳細は plugin の skill (reviewable-design-doc / visual-html-renderer) の指示に従う
python3 -m scripts.html_review_workbench.cli build-model \
--input-dir doc/ \
--input-file meta/adr-lite.md \
--output doc/generated/context-site/model.json
python3 -m scripts.html_review_workbench.cli render \
--model doc/generated/context-site/model.json \
--output-dir doc/generated/context-site/ \
--title "<プロジェクト名> プロジェクト全コンテキスト"実際のコマンド名・引数は reviewable-html-workbench の最新版に合わせる。バージョン不整合時はプラグインの README を参照。
4. ナビゲーション生成
doc/generated/context-site/index.html を起点に、確定と発酵中を分けた構造にする:
✅ 確定(合意済み・前提にしてよい)
📋 要件(rdd.md, 追加要件)
🎨 デザイン(SSOT, モック)
🏗 ADR(設計決定の歴史)
🧪 発酵中(未合意・参考) ← doc/draft/
検討中の案・プロトの学び・設定集
📚 生成物(マニュアル等)
📔 履歴(journal の最新分、ローカル閲覧時のみ)必須の表示ルール:
doc/draft/由来のページには、ページ上部に「未合意」バッジを出す (例:🧪 未合意 — 参考。決定事項ではありません)- 確定側のバッジ(
✅ 合意済み)も出し、どちらか分からない状態を作らない - トップの一覧でも、行ごとに状態が分かるようにする
- 昇格候補の印が付いているものは
⬆️ 昇格候補として区別する(人間が決める対象)
5. プレビューサーバ起動
# reviewable-html-workbench のプレビュー機能
python3 -m scripts.html_review_workbench.cli preview \
--dir doc/generated/context-site/
# または簡易サーバ(フォールバック)
cd doc/generated/context-site/ && python3 -m http.server 8765起動 URL をユーザーへ案内する。このとき、本文の最後に次の形式の1行を必ず出力する:
コンテキストサイト: http://localhost:8765/CLI のフッターがこの形式を拾ってリンクバッジを出す(
~/.claude/settings.jsonのfooterLinksRegexes)。 形式が崩れると拾われないので、ラベルとコロンの後に半角スペース1つを守る。 レポート一覧(レポート一覧: <URL>)と同じ仕組み。
6. インライン コメント機能の案内
reviewable-html-workbench のコメント機能が使える場合、ユーザーへ案内:
ブラウザでドキュメントを開いて、気になる箇所にコメントを付けられます。
コメントは JSON に保存され、AI が次回 /build-context-site --ingest-review で取り込めます。出力先
doc/generated/context-site/
├── index.html ← トップページ
├── model.json ← reviewable-html-workbench のモデル
├── pages/ ← 各ドキュメントの HTML
│ ├── requirements/
│ ├── design/
│ ├── adr/
│ └── generated/
├── assets/ ← 図・画像
└── comments/ ← ユーザーコメントの蓄積(あれば)⚠️
doc/generated/context-site/は配布物に含めない方針が筋(毎回生成される一時成果物)。.gitignoreへの追加を推奨
課金前停止ポイント
このスキルはローカル処理のみなので、課金発生ポイントは無い(外部 API を叩かない)。 MCP 経由の drawio / mermaid もローカルレンダリング。
やってはいけない
- 既存
doc/input/*やmeta/adr-lite.mdを書き換える(サイト生成は read-only) history/journal.mdを配布物として含める(gitignore 配下のローカル閲覧用に留める)- 生成サイトを外部公開する(個人情報・契約情報が含まれる可能性、ローカルのみ)
- ⚠️ 確定(
doc/input/)と発酵中(doc/draft/)を、状態表示なしに並べる。 分けた意味が画面で消え、未合意のものが決定事項として読まれる(ADR-026) - reviewable-html-workbench 未 install のまま強行(手動 install を案内)
/auto-task /auto-bug との関係
/auto-task/auto-bugの成果(PR、思考プロセス、レビュー履歴)は別途reviewable-html-workbenchのrenderでdoc/generated/loop-reports/に出力される(ADR-013)/build-context-siteはプロジェクト全体の現状を見るためのサイト- 両者は独立したコマンドだが、内部で同じ
reviewable-html-workbenchを使う
自己評価
- 成功自信度: (1-10)
- 一言理由: {対象ドキュメントの網羅度、図のレンダリング成否、ナビの分かりやすさを踏まえて記載}
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

