| name | raw-to-wiki |
| description | raw/ フォルダに置かれた一次資料（PDF・MD・テキスト・Web 等）を読み、適切な層（60_Laws / 61_Guidelines / 62_Frameworks / 63_Disorders / 64_Methods / 65_Assessments / 66_Services / 67_Orgs / 30_Insights）のテンプレートに沿った wiki ページを生成する。frontmatter の必須フィールドを自動で埋め、本文を要約・構造化し、既存ページとの relations を提案する。 |
raw-to-wiki skill
🪷 合言葉（事前自問）
「いつか必要」は「今は不要」と同義
ingest を始める前に必ず自問する。詳細な判断基準は [[90_Meta/page-creation-principles]] §2 の 3 関門（Q1 今日の実務で助かったか／Q2 raw/ に原典があるか／Q3 作らなかったら誰がいつ困るか）を通すこと。投機的な ingest は禁止。
用途
raw/ に置かれた一次資料を、wiki の適切な層に 要約・構造化された ノート として取り込む。
取り込みの主なケース
- 法令の改正: e-Gov の最新 PDF を
raw/laws/ に → 60_Laws/ を更新
- 新ガイドライン: 厚労省 PDF を
raw/guidelines/ に → 61_Guidelines/ に新規作成
- 判例・事件: Wikipedia 記事や判決文を
raw/insights/ に → 30_Insights/ に取り込み
- 報酬告示:
raw/services/ に → 66_Services/ を更新
- 学会報告:
raw/reports/ に → 30_Insights/ または 90_Meta/ に
入力
- raw/ 内のファイルパス（必須）
- 取り込み先層（任意・自動判定可能）
- 取り込み先ファイル名（任意・自動推定可能）
出力フォーマット
取り込み先ファイル（60_Laws/xxx.md など）に以下の構造で書き込む:
<!-- allow-realname -->
---
type: {law / guideline / framework / disorder / method / assessment / service / org / insight}
{各層の必須 frontmatter}
source: "raw/{subfolder}/{filename}"
cssclasses: [layer-{type}]
created: {YYYY-MM-DD}
updated: {YYYY-MM-DD}
tags: [{適切なタグ}]
relations:
- to: "[[既存ページ]]"
type: {applies-to / complements / informs / ...}
weight: {0.0-1.0}
rationale: "{なぜこの関係があるか}"
---
# {タイトル}
## 概要
（1-3 段落で要旨）
## {内容に応じた章立て}
...
## 出典
- raw/ 元ファイル: `raw/{subfolder}/{filename}`
- 一次情報: {URL or 書籍 ISBN}
実行手順（Claude 向け）
1. raw/ ファイルを読む
ファイル形式により異なる:
.md / .txt: Read ツールでそのまま読込.pdf: Read ツールに pages 引数で範囲指定可能.docx: 必要に応じて Bash で pandoc 等で md 化- URL: WebFetch で取得
2. 内容を分析し、層を判定
ファイル内容と raw/ サブフォルダから取り込み先層を推定:
| raw/ サブフォルダ | デフォルト層 | 例外（内容で判断） |
|---|
raw/laws/ | 60_Laws/ | 通知・告示なら 61_Guidelines/ |
raw/guidelines/ | 61_Guidelines/ | サービス報酬なら 66_Services/ |
raw/services/ | 66_Services/ | — |
raw/insights/ | 30_Insights/ | 学術的な理論なら 62_Frameworks/ |
raw/reports/ | 30_Insights/ | 統計データなら 90_Meta/ |
複数層に跨る場合は 主たる層 に取り込み、関連層に relations を張る。
3. ファイル名・タイトルを決定
- 既存 wiki ページと 重複しない 命名
- 検索しやすい日本語名（例:
七生養護学校事件_性教育とバックラッシュ.md）
- 法令・サービスは正式名（例:
障害者総合支援法.md）
4. テンプレートを選択し frontmatter を生成
90_Meta/templates/{type}.md を参考に必須フィールドを埋める:
共通必須
type: 層に対応する typecreated: 今日updated: 今日tags: 適切なタグ配列cssclasses: [layer-{type}]
層別必須（[[90_Meta/SCHEMA]] 参照）
- law: source_url, version, effective_date, review_due, issuer
- guideline: issuer, source_url, version, effective_date, review_due
- service: law_basis, target, version, review_due
- framework: origin, year, domain
- disorder: icd11_code または dsm5_code
- method: evidence_level, target_disorder
- assessment: administrator, time_required, purpose
- org: role, mandate
- insight: applies_to_disorders, applies_to_methods, evidence_level
追加（取り込み元情報）
source: raw/ への相対パス- 元の raw ファイルが残ることで、後で原文確認が可能
5. 本文を要約・構造化
要約の方針
- A4 1-2 ページ程度（2000-4000 文字）を目安
- 一次情報の構造を保ちつつ、相談支援業務での使い方を明確に
- 章立てはテンプレートに沿うが、内容に応じて調整可
必ず含める章
- 概要: 1-3 段落で要旨
- 計画相談での論点 / 活用 または 相談支援との関係
- 関連法令 / ガイドライン / 技法 等（既存ページへの wikilink）
- 出典: raw/ 元ファイル + 一次情報 URL
章立て例（事件・判例の場合）
## 概要
## 事件の経緯
## 裁判の結果
## 計画相談支援との関係
## 関連する制度・概念の変化
## 関連ページ
## 参考文献・出典
6. relations を提案
raw/ の内容を分析し、既存 wiki ページとの関係を 3-10 個提案:
relations:
- to: "[[64_Methods/知的障害のある人への性教育]]"
type: complements
weight: 0.9
rationale: "本事件は知的障害児向け性教育の実践事例"
- to: "[[62_Frameworks/包括的性教育]]"
type: informs
weight: 0.8
- to: "[[60_Laws/旧優生保護法]]"
type: complements
weight: 0.7
rationale: "障害者の性に対する社会の認識史の文脈"
7. 実名混入チェック
raw/ に実在の氏名が含まれている場合の処理:
- 公人（議員・首長・公報情報）: 引用 OK（
<!-- allow-realname --> を付与）
- 当事者（生徒・利用者・職員）: 役割で表現 に置換
- 「校長 X」→「元校長」
- 「教員 Y」→「原告教員」
- 「生徒 Z」→「在校生」
判決文の当事者名は基本的に役割表現で記述。
8. ユーザーに確認
書き込み前に、以下をユーザーに提示し承認を得る:
取り込み先: 30_Insights/七生養護学校事件_性教育とバックラッシュ.md
推定 type: insight
relations 候補: 7 個（[[64_Methods/...]] 等）
本文の書き出し:
> 七生養護学校事件は、2003年に東京都立七生養護学校で行われていた
> 知的障害児への性教育「こころとからだの学習」が...
このまま保存してよいですか？
9. 書き込み
承認後、Write ツールで書き込み。
書き込み後、以下を実施:
- 既存ページにも back-link を追加（任意・推奨）
- vault-health-check の「壊れリンク」が増えていないか確認
10. 完了報告
ユーザーに以下を報告:
✅ 取り込み完了
新規ページ: 30_Insights/七生養護学校事件_性教育とバックラッシュ.md
relations: 7 個
要約: A4 約 2 ページ
出典: raw/insights/2003_七生養護学校事件.md（原本保管）
次のステップ:
- Obsidian で開いて内容確認
- 必要に応じて手修正
- Neo4j に再同期: python3 90_Meta/scripts/sync_to_neo4j.py
禁忌・注意事項
取り込んではいけないケース
- 原本に著作権上の問題がある（PDF 全文転載等）→ 引用範囲内の要約に限定
- 個人情報を含む生データ（実在の利用者情報）→ 仮名化してから取り込み
一次情報の改変禁止
- raw/ の元ファイルは 絶対に改変しない（原本として保管）
- 取り込み後の wiki ページが「要約」であることを明示
実名の取扱い
- ノート本文中の 当事者名は役割表現に置換
- frontmatter の
source で raw/ 原本へのリンクを残し、必要時に原文参照可
既存ページの上書き
- 同名の既存ページがある場合、ユーザーに確認 してから上書き
- 古い版は git 履歴で残るので、慎重に判断
著作権配慮（公開リポジトリ）
- 法令の原文 PDF は
.gitignore で除外済み
- ガイドライン・告示の原本も基本的にローカル保管
- wiki ページ側には 要約と出典 URL のみ（全文転載しない）
引用範囲の目安
著作権法 32 条に基づく適法な引用:
- ✅ 原文の 数行〜数段落 を「」付きで引用、出典明示
- ✅ 全体の構造を 要約 で示す
- ❌ 原文の 大部分（数ページ）をそのまま転記
- ❌ 元の表現の 改変なき転載 が大きな割合を占める
迷う場合は要約寄りに判断。
関連スキル
vault-health-check: 取り込み後の健全性確認support-hypothesis: 取り込んだ知識を利用者ノートで活用wiki-ingest（外部・anthropic-skills）: 類似機能の汎用版wiki-integrate（外部）: 既存 wiki への統合特化
関連ドキュメント
- [[raw/README]]: raw/ 全体の運用ルール
- [[90_Meta/SCHEMA]]: frontmatter 仕様・リンク型辞書
- [[docs/USER_GUIDE]]: ユーザー向け取り込み手順
将来拡張
- OCR 対応: スキャン PDF からのテキスト抽出
- Word 文書対応: pandoc 経由での変換
- 動画書き起こし: 研修動画→テキスト→wiki
- バッチ取り込み: raw/ の複数ファイルを一括処理
- 差分取り込み: 既存ページの法改正反映（diff 表示・部分更新）
