メインコンテンツまでスキップ

explanation-design

資料や解説の素材はあるが、読み手へ何から伝えるかが決まっていないときに使います。文章やHTMLの前に情報のつながりを設計します。

渡す情報​

素材、想定読者、理解してほしいこと、出力形式、長さや前提知識の制約を渡します。

依頼例​

explanation-designを使って、担当者条件をURLへ保存する仕組みの説明順を設計してください。読者は一覧画面を使う担当者です。ブラウザの内部実装は知らない前提で、共有リンクの効果を理解できるようにしたいです。

進め方​

  1. 最終的に伝えたいことと読者の前提を整理します。
  2. 必要な前提知識と情報の依存関係から説明順を決めます。
  3. 伝達設計を提示し、人間の承認後に文章やHTMLへ変換します。

成果物の例​

現在の要件を入力に、所定の7項目で作成した伝達設計です。

到達点:伝達設計案・完成本文への変換前。

移行時の確認:既存の実行記録を移行しました。本文の一致は確認しましたが、過去の実行時の同梱資料全体は特定できていません。

このハッシュは移行時の変更検出用の基準です。同梱資料全体をこの版で再実行した証拠ではありません。

実行した依頼​

スキルを使う前に実際の成果物を確かめたい読者へ、実入力、実出力、画面画像、原本取得、検証結果を説明する順序を設計してください。まず伝達設計を出してください。

実出力の抜粋​

以下は保存した原本の冒頭です。全文は原本から取得できます。

# 伝達設計

## 1. 最終的に伝えたいこと

このスキルへどの情報を渡すと、どの成果物が得られ、利用者が何を確認できるのか。

## 2. 読者の前提

スキルの名前と目的は説明ページで読める。実行前に成果物の形を確かめたい利用者を想定する。

## 3. 必要な前提知識

文章を出すスキルと、操作できるHTMLや複数ファイルを出すスキルがある。対話や承認を含むスキルは、初回出力と最終確定物が異なる。

## 4. 情報同士のつながり

成果物を取得する​

確認した結果​

  • 伝達設計を保存。承認済みの完成本文としては扱っていません。

確認するポイント​

見た目の構成より先に、前提から結論へつながる説明順があるかを確認します。完成本文へ進む前に伝達設計を承認します。

関連するスキル​

  • compare:比較のHTMLへ変換する。
  • archify-jp:必要な関係を図にする。

正本を読む​

詳細な手順と制約はexplanation-designのSKILL.mdを参照してください。