ima-copilot

1# IMA Copilot
2 
3One-command installer, troubleshooter, and personalization layer for the official Tencent IMA skill.
4 
5## Architectural principles (do not violate)
6 
7This skill is a **wrapper layer** around ima-skill. The wrapper contract is non-negotiable:
8 
9- **Never vendor upstream files.** This skill directory does not contain any copy, fork, or excerpt of ima-skill's own content. When ima-skill ships a new release, users get the new release without any interference from this wrapper.
10- **Repairs happen at runtime, not at ship time.** If an upstream bug needs patching, this skill carries the *instructions* for how to patch, not the patched files. Running a repair is idempotent: rerunning after an upstream update re-detects and re-fixes anything that came back.
11- **Always ask before touching upstream files.** Modifying `~/.claude/skills/ima-skill/**`, `~/.agents/skills/ima-skill/**`, or any other upstream install directory requires explicit user consent via AskUserQuestion. No silent patching.
12- **Teach rather than hide.** When a fix is applied, show the user exactly what changed and where the backup was saved. This is how users learn to maintain their own installs.
13 
14## What this skill does
15 
16| Capability | Entry point | Detail |
17|---|---|---|
18| 1. Install upstream ima-skill to supported agents | `scripts/install_ima_skill.sh` | See `references/installation_flow.md` |
19| 2. Configure API credentials (XDG style) | Inline workflow below | See `references/api_key_setup.md` |
20…