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

34 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ReadTaskConversation
`SearchTaskConversation` が返した ref の**前後を数件だけ**読み、当時の文脈を確認する META ツール(全 piece で常時利用可能)。検索を安価に保ちつつ、古い決定の周辺だけを覗くために使う。
## パラメータ
| 名前 | 必須 | 説明 |
|------|------|------|
| `ref` | ○ | `comment:<id>` または `transcript:<index>``SearchTaskConversation` の出力からコピーする) |
| `before` | | 前に含める件数。既定 2、上限 5 |
| `after` | | 後に含める件数。既定 2、上限 5 |
## 挙動
- `comment:<id>`: その id のコメントを中心に、コメント列の前後を返す
- `transcript:<index>`: その行を中心に、transcript の前後行を返す
- 現在タスクの会話だけを対象にする(別タスクは読めない)
- 出力は常に上限付き。中心のエントリには `←` マーカーが付く
## 出力例
```md
## 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 する。