---

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)

1. Extract the current topic scope and exclusions.
2. Propose keyword expansions (synonyms, related terms, acronyms) and add explicit exclusions for common false positives.
3. 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.