keyword-expansion

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；避免“无限扩展”。

Stars 377

Forks 25

Install this agent skill to your Project

npx add-skill https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/keyword-expansion

SKILL.md

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