c3-search

name	c3-search
description	Search Construct 3 ACE definitions and explain plugin/behavior capabilities. 搜索 Construct 3 ACE 定义，解释插件/行为功能。
triggers	{"keywords":["search ace","what actions","what conditions","list expressions","explain behavior","how to use","plugin capabilities","find action","ACE 查询","有哪些动作","有哪些条件","怎么用","什么表达式","can c3 do","does c3 support","c3 feature","能不能做","支不支持","有没有","c3 3d"],"intents":["search_ace","explain_plugin","find_usage","check_capability"]}

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

# 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.