maestro/docs/tools/readtaskconversation.md
oss-sync b1292e34b2
Some checks failed
CI / build-and-test (push) Has been cancelled
sync: update from private repo (edc775f2)
2026-07-06 01:04:12 +00:00

1.5 KiB
Raw Permalink Blame History

ReadTaskConversation

SearchTaskConversation が返した ref の前後を数件だけ読み、当時の文脈を確認する META ツール(全 piece で常時利用可能)。検索を安価に保ちつつ、古い決定の周辺だけを覗くために使う。

パラメータ

名前 必須 説明
ref comment:<id> または transcript:<index>SearchTaskConversation の出力からコピーする)
before 前に含める件数。既定 2、上限 5
after 後に含める件数。既定 2、上限 5

挙動

  • comment:<id>: その id のコメントを中心に、コメント列の前後を返す
  • transcript:<index>: その行を中心に、transcript の前後行を返す
  • 現在タスクの会話だけを対象にする(別タスクは読めない)
  • 出力は常に上限付き。中心のエントリには マーカーが付く

出力例

## ReadTaskConversation — comment #17 (前 2 / 後 2)

- comment:15 user/comment 2026-06-30T09:58:00Z
  先に前提を共有します。
- comment:17 user/request 2026-06-30T10:00:00Z ←
  keep the existing auth flow unchanged.
- comment:18 agent/progress 2026-06-30T10:02:00Z
  了解しました。認証フローは触りません。

典型的な流れ: SearchTaskConversation でヒットを見つける → 気になる ref を ReadTaskConversation で開く → 恒久的な制約・判断なら MissionUpdate で pin する。