diff --git a/changes/docs-skill-example-reply.md b/changes/docs-skill-example-reply.md new file mode 100644 index 00000000..4e9ba38f --- /dev/null +++ b/changes/docs-skill-example-reply.md @@ -0,0 +1,5 @@ +### Fixed + +- **The agent skill searches by meaning twice: with the question, then with a one-sentence example of the reply that + would answer it.** A reply reads closer to the answer than a question does. On 10 test questions the question + found the answer in the top 20 for 8, the example reply for 9, and both together for 10. diff --git a/skills/tg-cli/SKILL.md b/skills/tg-cli/SKILL.md index 1ba478d5..59ef120b 100644 --- a/skills/tg-cli/SKILL.md +++ b/skills/tg-cli/SKILL.md @@ -34,7 +34,8 @@ Choose a path from the user's task rather than reading recent messages by defaul 1. **Start with `tg personal search conversations "" --json`**: it searches by meaning and words. Pass the question as the owner wrote it (a sentence, unsure wording, a misspelled name, no chat - named); do not cut it to one word. When the owner says "I advised / I wrote", add `from:me`. + named); do not cut it to one word. When the owner says "I advised / I wrote", add `from:me`. Then search once + more with a one-sentence example of the reply that would answer it, and read both lists. 2. Then `tg personal search messages "" --discover --json`, then key words with `tg personal search messages ""` (this machine's copy plus Telegram's own search). Add `--backend archive` when the owner wants nothing to leave the machine. Every word must match; unsure which diff --git a/skills/tg-cli/references/search.md b/skills/tg-cli/references/search.md index 554bedaa..53a0845c 100644 --- a/skills/tg-cli/references/search.md +++ b/skills/tg-cli/references/search.md @@ -8,6 +8,8 @@ Read when a first search found nothing useful, the owner gave known words, a dat advised or sent what; a sentence, unsure wording, a name that may be misspelled, no chat named): it searches by meaning and words; `conversations status` shows which chats have vectors. Then `tg personal search messages '' --discover`, then key words. Pass the question as the owner wrote it; do not cut it to one word first. + Search by meaning a second time with a one-sentence example of the reply that would answer it, and read both lists: + on 10 test questions the question found the answer in the top 20 for 8, the example reply for 9, both for 10. Never filter the results yourself (`grep -v`, `jq select`) by chat or sender: a hit in a chat you did not expect is often the answer. When the owner says "I advised / I wrote", add `from:me`. A search that stops at its time limit answers `query.time-limit`: run it again with `--timeout 60s` before trying other words.