| name | doc-diff |
| description | 「前回から何が変わった」「この資料の差分」「<doc> はどこが更新された」「仕様のどこが変わったか」と頼まれたら、Suasor MCP の source.history で対象 source の本文版を event log から引き、直近 2 版(または期間指定の前後版)を突き合わせて変更点を要約する。read-only、persist なし。 |
| readOnly | true |
| category | review |
| triggers | ["前回から何が変わった","この資料の差分","<doc> はどこが更新された","仕様のどこが変わったか"] |
| pairs | [] |
| mcp_tools_read | ["source.history","graph.related"] |
| mcp_tools_write | [] |
doc-diff
取り込み済み source(設計書 / 仕様 / PDF / スプレッドシート等)の「前回から何が変わったか」を本文版の突き合わせで返す read-only skill。SourceObserved / SourceBodyUpdated event が全文 body を保持する(ADR-0002)ため、source.history で過去版を引いて真の before/after 差分を組める(projection は現本文のみ保持)。
いつ発火するか
- 「前回から何が変わった」「この資料の差分」「どこが更新された」
- 「仕様のどこが変わったか」「
<doc> の変更点」
何をするか(MCP tool flow)
read tool のみ(ADR-0004)。
- 対象 source を特定する。漠然としていれば
search / recall.search / source.list(observedAfter で期間絞り)で当たりを付ける
source.history(externalId、limit?)で本文版を新しい順に引く。各版は observedAt / fingerprint / body / recordedAt
- 直近 2 版(最新 =
versions[0] と前版 = versions[1])、または期間指定なら該当前後版を突き合わせ、変更点を host LLM が要約する(追加/削除/変更の要旨)。版が 1 つだけなら「更新履歴なし(初版のみ)」と返す
- 必要なら
graph.related で関連 decision / task を添える
制約
- read-only。persist しない。差分は本文版の比較で、外部 diff ツールは使わない
source.history は event log(SourceObserved / SourceBodyUpdated)由来で全文版を返す。projection(source.get)は現本文のみなので差分には使えない
- ADR-0023 系で本文未抽出(name-only)の Office/PDF は、本文抽出(epic #124 / #120)が入るまで「名前のみ」の差分になる
- 本 skill は手順書のみで実処理を持たない