c3-search

# Search — Query Construct 3 ACE Documentation Read `${CLAUDE_PLUGIN_ROOT}/CLAUDE.md` for known hallucination traps (critical — wrong ACE IDs are the #1 failure mode). ## Capability Questions Triggered by "C3 能不能做 X", "does C3 support X", or any feature inquiry. **Hard rule: training data is stale for C3 features. Query first, answer second.** 1. `rag.py search {feature keyword}` — check plugins/behaviors/scripting APIs (≥1 query, max 3) 2. context7 `query-docs` on `/xhxiaiein/construct3-manual` — check manual for feature docs (≥1 query, max 2) 3. Answer citing specific plugin names, ACE IDs, or scripting methods found in steps 1-2 4. If both sources return 0 relevant results → respond "文档中没有找到相关功能，建议查看 construct.net 官方更新日志确认" **Escalate when:** - RAG offline AND context7 returns 0 results → tell user, do not fall back to training data - User claims a feature exists but docs don't show it → ask user for a link or example project, do not confirm or deny from memory ## Scripts ```bash # ACE lookup via RAG service python3 ${CLAUDE_PLUGIN_ROOT}/scripts/query/rag.py search {query} python3 ${CLAUDE_PLUGIN_ROOT}/scripts/query/rag.py list {plugin} python3 ${CLAUDE_PLUGIN_ROOT}/scripts/query/rag.py lookup {query} --plugin {plugin} python3 ${CLAUDE_PLUGIN_ROOT}/scripts/query/rag.py verify {ace-id} --plugin {plugin} ``` ## Memory Context On skill trigger: find `.c3proj` in the working directory or one level up. If not found, skip memory loading. If found, read its `uniqueId` and check `{project_root}/.claude/memory/memory.md` — if it exists, read it for project context. ## Service Dependencies Requires RAG service (port 8765). If offline, guide the user: - Start: `cd ../Construct3-RAG && python src/api.py` - First time? Run `bash .claude/plugins/construct3-copilot/scripts/infra/setup.sh` to clone all deps. ## Boundaries - Read-only — does NOT generate clipboard JSON (use `/c3-create` for that) - Does NOT modify any files - Returns ACE definitions, parameters, usage examples, and explanations ## Routing If the user asks "what actions does Sprite have?" → this skill (search/explain). If the user asks "create a platformer with Sprite" → `/c3-create` (generation). If the query is ambiguous ("I need collision detection"), start here to search, then hand off to `/c3-create` if the user wants to generate JSON.