- name
- phoenix-setup
- description
- Install the ATV-Phoenix self-healing harness into GitHub Copilot. Builds the Rust MCP server (if needed) and registers the phoenix agent plus its MCP server so Copilot can call phoenix_sense / phoenix_snapshot / phoenix_heal / phoenix_verify_trace. Use when the user types /phoenix-setup or asks to install or enable Phoenix.
# /phoenix-setup
This skill installs ATV-Phoenix into the GitHub Copilot CLI so the `phoenix` agent and its four
self-healing tools become available.
## What it does
1. Ensures the Rust binary `phoenix-mcp` exists (builds it with `cargo build --release` if missing).
2. Registers the `phoenix` MCP server in `~/.copilot/mcp-config.json` (so the tools auto-load).
3. Installs the `phoenix` agent definition to `~/.copilot/agents/phoenix.agent.md` (so
`copilot --agent phoenix` works after a restart).
4. Installs the **13 bundled skills** into `~/.copilot/skills`, then **self-checks them with
`phoenix-mcp doctor`** (the harness validates its own skills).
5. Installs the **bundled TokenMasterX** for token-efficient retrieval (best-effort; needs `graphify`).
## How to run it
The setup script ships in this skill's directory. Locate it, then run it with the repo root:
1. Run `/skills info phoenix-setup` and read the skill's directory path from the output.
2. Run the setup script, passing the skill dir and the repo root:
```
python <skill-dir>/setup.py --repo <ATV-Phoenix-repo-root>
```
If `--repo` is omitted, the script looks for the repo via the `PHOENIX_REPO` env var or the current
directory. It prints exactly what it registered and the restart command.
## After install
Restart Copilot (or start with `copilot --agent phoenix`). Then ask Copilot to verify and self-heal a
task — it will call `phoenix_sense` / `phoenix_heal` and only report success on objective evidence.
## Honesty
The tools report objective signals only (exit codes / hashes / regex). A fabricated "done" is the
failure mode Phoenix prevents; "I'm not sure it passed" is acceptable.
GitHub에서 보기