mirror of https://github.com/obra/superpowers.git synced 2026-05-06 17:19:05 +08:00

Files

Jesse Vincent 56bb8bc2df Phase B: config-file refs + per-platform tool refs + spec

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.

2026-05-05 18:25:31 -07:00

2.6 KiB

Raw Blame History

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)

2.6 KiB Raw Blame History