2026-03-25 14:06:04 -07:00
|
|
|
# Copilot CLI Tool Mapping
|
|
|
|
|
|
|
|
|
|
Skills use Claude Code tool names. When you encounter these in a skill, use your platform equivalent:
|
|
|
|
|
|
|
|
|
|
| Skill references | Copilot CLI equivalent |
|
|
|
|
|
|-----------------|----------------------|
|
|
|
|
|
| `Read` (file reading) | `view` |
|
|
|
|
|
| `Write` (file creation) | `create` |
|
|
|
|
|
| `Edit` (file editing) | `edit` |
|
|
|
|
|
| `Bash` (run commands) | `bash` |
|
|
|
|
|
| `Grep` (search file content) | `grep` |
|
|
|
|
|
| `Glob` (search files by name) | `glob` |
|
|
|
|
|
| `Skill` tool (invoke a skill) | `skill` |
|
|
|
|
|
| `WebFetch` | `web_fetch` |
|
Lift superpowers:code-reviewer agent into the requesting-code-review skill
The plugin had a single named agent (`agents/code-reviewer.md`) used by
two skills, while every other reviewer/implementer subagent in the repo
is dispatched as `general-purpose` with the prompt template living
alongside its skill. That asymmetry had no upside and several costs:
- Two sources of truth for the code review checklist (the agent file
and `requesting-code-review/code-reviewer.md`), both drifting
independently.
- `Codex` users could not use the named agent directly; the codex-tools
reference doc had a workaround section explaining how to flatten the
named agent into a `worker` dispatch.
- No third-party reliance on `superpowers:code-reviewer` inside this
repo.
Changes:
- Merge `agents/code-reviewer.md` (persona + checklist) and
`skills/requesting-code-review/code-reviewer.md` (placeholder
template) into a single self-contained Task-dispatch template,
matching the shape of `implementer-prompt.md`,
`spec-reviewer-prompt.md`, etc.
- Update `skills/requesting-code-review/SKILL.md` and
`skills/subagent-driven-development/code-quality-reviewer-prompt.md`
to dispatch `Task (general-purpose)` instead of the named agent.
- Drop the now-obsolete "Named agent dispatch" workaround sections from
`codex-tools.md` and `copilot-tools.md` — superpowers no longer ships
any named agents, so those instructions documented nothing.
- Delete `agents/code-reviewer.md` and the empty `agents/` directory.
Tier 3 coverage for the change: a new behavioral test
`tests/claude-code/test-requesting-code-review.sh` plants real bugs
(SQL injection, plaintext password handling, credential logging) into
a tiny project, runs the actual `requesting-code-review` skill against
the working tree, and asserts the dispatched reviewer flags every
planted issue at Critical/Important severity and refuses to approve
the diff.
Verified end-to-end on this branch:
- The new test passes (5/5 assertions; reviewer caught all planted
bugs and several others).
- The existing SDD integration test still passes (7/7 subagents
dispatched, all as `general-purpose`; spec compliance still
rejects extra features; produced code is correct).
- Session JSONLs confirm zero remaining `superpowers:code-reviewer`
dispatches anywhere in the SDD pipeline.
2026-04-28 11:59:36 -07:00
|
|
|
| `Task` tool (dispatch subagent) | `task` with `agent_type: "general-purpose"` or `"explore"` |
|
2026-03-25 14:06:04 -07:00
|
|
|
| Multiple `Task` calls (parallel) | Multiple `task` calls |
|
|
|
|
|
| Task status/output | `read_agent`, `list_agents` |
|
|
|
|
|
| `TodoWrite` (task tracking) | `sql` with built-in `todos` table |
|
|
|
|
|
| `WebSearch` | No equivalent — use `web_fetch` with a search engine URL |
|
|
|
|
|
| `EnterPlanMode` / `ExitPlanMode` | No equivalent — stay in the main session |
|
|
|
|
|
|
|
|
|
|
## Async shell sessions
|
|
|
|
|
|
|
|
|
|
Copilot CLI supports persistent async shell sessions, which have no direct Claude Code equivalent:
|
|
|
|
|
|
|
|
|
|
| Tool | Purpose |
|
|
|
|
|
|------|---------|
|
|
|
|
|
| `bash` with `async: true` | Start a long-running command in the background |
|
|
|
|
|
| `write_bash` | Send input to a running async session |
|
|
|
|
|
| `read_bash` | Read output from an async session |
|
|
|
|
|
| `stop_bash` | Terminate an async session |
|
|
|
|
|
| `list_bash` | List all active shell sessions |
|
|
|
|
|
|
|
|
|
|
## Additional Copilot CLI tools
|
|
|
|
|
|
|
|
|
|
| Tool | Purpose |
|
|
|
|
|
|------|---------|
|
|
|
|
|
| `store_memory` | Persist facts about the codebase for future sessions |
|
|
|
|
|
| `report_intent` | Update the UI status line with current intent |
|
|
|
|
|
| `sql` | Query the session's SQLite database (todos, metadata) |
|
|
|
|
|
| `fetch_copilot_cli_documentation` | Look up Copilot CLI documentation |
|
|
|
|
|
| GitHub MCP tools (`github-mcp-server-*`) | Native GitHub API access (issues, PRs, code search) |
|