keyword-expansion

扩展并优化搜索关键词（包括同义词、缩写、排除词），同时更新 `queries.md`。 **触发条件**：关键词扩展、同义词、排除词、queries.md、关键词扩展、同义词、排除词。 **适用场景**：当检索覆盖不足或噪声过大，或者主题别名众多时，需要系统化地扩展与收敛检索词。 **若跳过**：如果 `queries.md` 已能稳定覆盖所需范围（无需盲目扩大范围导致后续成本激增）。 **网络环境**：无需联网。 **行为准则**：保持查询数量可控；明确排除词；避免“无限扩展”。

SKILL.md

--- frontmatter

name: keyword-expansion
description: |
  Expand and refine search keywords (synonyms, acronyms, exclusions) and update `queries.md`.
  **Trigger**: keyword expansion, synonyms, exclusions, queries.md, 关键词扩展, 同义词, 排除词.
  **Use when**: 检索覆盖不足/噪声过大，或主题别名很多，需要系统化扩展与收敛检索词。
  **Skip if**: `queries.md` 已经能稳定检出覆盖面（无需扩大范围导致后续成本爆炸）。
  **Network**: none.
  **Guardrail**: 保持可控的 query 数量；明确 exclusions；避免“无限扩展”。

Skill: keyword-expansion

Goal

•Improve recall/precision of queries.md without drifting scope.

Inputs

•queries.md
•Optional: DECISIONS.md scope notes

Outputs

•Updated queries.md

Procedure (MUST FOLLOW)

•Extract the current topic scope and exclusions.
•Propose keyword expansions (synonyms, related terms, acronyms) and add explicit exclusions for common false positives.
•Update queries.md with a clear “why” note for each change.

Acceptance criteria (MUST CHECK)

• queries.md contains updated keywords and excludes.
• Changes do not contradict DECISIONS.md scope constraints.

Troubleshooting

Issue: keyword expansion causes scope drift

Fix:

•Re-read DECISIONS.md scope notes and add explicit exclusions in queries.md for common false positives.

Issue: query count explodes and becomes unmanageable

Fix:

•Keep a small set of high-signal queries; merge synonyms into the same query where possible instead of adding many near-duplicates.