mirror of
https://github.com/obra/superpowers.git
synced 2026-05-10 02:59:04 +08:00
56bb8bc2df
Two structural changes:
1. Generalize CLAUDE.md-specific guidance:
- "Project-specific conventions (put in CLAUDE.md)" → "(put in
your instructions file)" in writing-skills/SKILL.md
- "(explicit CLAUDE.md violation)" → "(explicit instruction-file
violation)" in receiving-code-review/SKILL.md
- The instruction-priority list in using-superpowers/SKILL.md
stays inclusive (CLAUDE.md, GEMINI.md, AGENTS.md) — that's
load-bearing, not a substitution opportunity.
2. Per-platform tool reference files at skills/using-superpowers/
references/{claude-code,codex,copilot,gemini}-tools.md. Each ref
documents:
- The runtime's preferred instructions file (CLAUDE.md, AGENTS.md,
GEMINI.md, etc.) and how it loads
- The runtime's personal-skills directory + cross-runtime
~/.agents/skills/ path where applicable
- Action-language → tool-name mapping table
Tool names and table content reflect the source-verified state from
direct inspection of openai/codex, google-gemini/gemini-cli,
sst/opencode, and the installed @github/copilot package. Filenames
and behaviors are sourced from each runtime's official docs.
Files in this commit also pick up later-phase changes that
accumulated on the same files (using-superpowers/SKILL.md "How to
Access Skills" overhaul, action-language flowchart, refs' final
table content). The bundled spec records original scope.
50 lines
2.6 KiB
Markdown
50 lines
2.6 KiB
Markdown
# Copilot CLI Tool Mapping
|
|
|
|
Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Copilot CLI these resolve to the tools below.
|
|
|
|
| Action skills request | Copilot CLI equivalent |
|
|
|----------------------|----------------------|
|
|
| Read a file | `view` |
|
|
| Create / edit / delete a file | `apply_patch` (Copilot CLI has no separate create/edit/write tools) |
|
|
| Run a shell command | `bash` |
|
|
| Search file contents | `rg` (ripgrep; Copilot CLI does not expose a `grep` tool) |
|
|
| Find files by name | `glob` |
|
|
| Fetch a URL | `web_fetch` |
|
|
| Search the web | `web_search` |
|
|
| Invoke a skill | `skill` |
|
|
| Dispatch a subagent (`Subagent (general-purpose):` template) | `task` with `agent_type: "general-purpose"` (other accepted types: `explore`, `task`, `code-review`, `research`, `configure-copilot`) |
|
|
| Multiple parallel dispatches | Multiple `task` calls in one response (or wrap with the `parallel` tool) |
|
|
| Subagent status/output/control | `read_agent`, `list_agents`, `write_agent` |
|
|
| Task tracking ("create a todo", "mark complete") | `sql` with the built-in `todos` table |
|
|
| Enter / exit plan mode | No equivalent — stay in the main session |
|
|
|
|
## Instructions file
|
|
|
|
When a skill mentions "your instructions file", on Copilot CLI this is **`AGENTS.md`** at the repository root. If both `AGENTS.md` and `.github/copilot-instructions.md` are present, Copilot reads both.
|
|
|
|
## Personal skills directory
|
|
|
|
User-level skills live at **`~/.copilot/skills/`**. Copilot CLI also recognizes the cross-runtime alias **`~/.agents/skills/`**, which is shared with Codex and Gemini CLI. Each skill is a subdirectory containing a `SKILL.md` (with `name` and `description` frontmatter).
|
|
|
|
## Async shell sessions
|
|
|
|
Copilot CLI supports persistent async shell sessions:
|
|
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `bash` with `mode: "async"` (and optionally `detach: true`) | Start a long-running command in the background; returns a `shellId` |
|
|
| `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) |
|