explainer-book
Installation
SKILL.md
explainer-book
explainer の本版。
1 本の速習資料(20 分以内・例 1 つずつ)で足りないとき、章に分けて、手を動かして身につける資料にする。
ペルソナ・図・検証の仕組みは explainer をそのまま使う。先に ../explainer/SKILL.md を読むこと。
このスキルが足すのは、本全体の設計と検査。
スクリプトは、このスキルのディレクトリ(以下 <skill>)の scripts/ にあります。
verify-book.mjs は、隣の explainer スキルの scripts/verify-doc.mjs を呼びます。2 つのスキルは同じ場所に入れてください。
依存の入れ方は explainer の「準備」と同じです。
いつ本にするか
次のどれかに当てはまったら本にする。1 つも当てはまらなければ、explainer の 1 本で書く。
- 読了が 20 分を超える
- 読み手が手を動かす演習が要る(読むだけでは「判定できる」ようにならない)
- 概念に順序がある(A を知らないと B が読めない)