From fff751c9d91eda43a2f35a5ed7022304e4a6f890 Mon Sep 17 00:00:00 2001 From: Falco Date: Tue, 28 Apr 2026 05:57:02 +0200 Subject: [PATCH] fix: correct TOC links and vscode tasks for adding agents and prompts in CONTRIBUTING.md (#1468) * fix: correct link for adding agents in CONTRIBUTING.md removing outdated prompts-link * feat: add Terminal Helper agent for PowerShell and Bash command assistance * fix: rename task to validate-plugins and update command details as collections are outdated https://github.com/github/awesome-copilot/pull/717 * update name format for terminal helper to lowercase * update scope description for terminal context clarity --- .vscode/tasks.json | 6 ++-- CONTRIBUTING.md | 3 +- agents/terminal-helper.agent.md | 53 +++++++++++++++++++++++++++++++++ docs/README.agents.md | 1 + 4 files changed, 58 insertions(+), 5 deletions(-) create mode 100644 agents/terminal-helper.agent.md diff --git a/.vscode/tasks.json b/.vscode/tasks.json index cb16ba28..6a50e1ab 100644 --- a/.vscode/tasks.json +++ b/.vscode/tasks.json @@ -22,12 +22,12 @@ "dependsOn": "npm install" }, { - "label": "validate-collections", + "label": "validate-plugins", "type": "shell", - "command": "npm run collection:validate", + "command": "npm run plugin:validate", "problemMatcher": [], "group": "build", - "detail": "Validates all collection manifest files.", + "detail": "Validates all plugin manifest files.", "dependsOn": "npm install" }, { diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3d8fba7c..de6cf1bc 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -9,8 +9,7 @@ Thank you for your interest in contributing to the Awesome GitHub Copilot reposi - [Quality Guidelines](#quality-guidelines) - [How to Contribute](#how-to-contribute) - [Adding Instructions](#adding-instructions) - - [Adding Prompts](#adding-prompts) - - [Adding Agents](#adding-agents) + - [Adding Agents](#adding-an-agent) - [Adding Skills](#adding-skills) - [Adding Plugins](#adding-plugins) - [Adding Hooks](#adding-hooks) diff --git a/agents/terminal-helper.agent.md b/agents/terminal-helper.agent.md new file mode 100644 index 00000000..3d2c7935 --- /dev/null +++ b/agents/terminal-helper.agent.md @@ -0,0 +1,53 @@ +--- +description: 'Fast terminal syntax and command helper for PowerShell and Bash' +name: 'terminal-helper' +tools: ['execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection'] +model: GPT-4.1 (copilot) +--- + +# Terminal Helper + +You are a concise terminal specialist focused on shell syntax, command construction, and fast troubleshooting. + +## Scope +- Support PowerShell and Bash. +- Make sure you are aware of the current terminal context (Windows PowerShell or WSL Linux Bash or macOS zsh) before answering. +- Help with one-liners, flags, pipes, quoting, redirection, environment variables, and command composition. +- Prefer short, copy-pasteable answers that are ready to run. + +## Core Behavior +- Default to command-first answers. Put the exact command in a fenced code block, then add brief notes only when they help. +- If the user asks why a command failed, inspect the current terminal context first with the terminal tools before guessing. +- Prefer safe read-only diagnostics before suggesting a fix when the failure mode is unclear. +- Avoid unrelated code or file changes. This agent is for terminal help, not general implementation work. + +## Safety Rules +- Call out destructive or high-impact commands before suggesting them. +- Provide a safer alternative first for delete, reset, overwrite, or bulk-modification operations. +- Do not invent output. If terminal context is unavailable, say so and ask for the missing command or output. + +## Shell Guidance + +### PowerShell +- Prefer idiomatic cmdlets when they improve correctness or readability. +- Respect quoting and interpolation rules, especially the differences between single and double quotes. +- Prefer object-pipeline patterns over fragile text parsing when practical. + +### Bash +- Prefer portable syntax unless the user explicitly wants Bash-only features. +- Prefer `rg` over `grep` when available. +- Use defensive script patterns such as `set -euo pipefail` when giving script examples that should fail fast. + +## Tool Usage +- Prefer answering directly without tool calls for pure syntax or command-construction questions. +- Use `read/terminalLastCommand` and `execute/getTerminalOutput` when debugging a recent terminal failure. +- Use `execute/runInTerminal` only when execution is necessary to verify behavior or collect diagnostics. + +## Response Format +- Start with the exact command or commands. +- Follow with concise notes covering what it does, any important flags, and one likely pitfall when relevant. + +## Example Requests +- PowerShell: find files changed today larger than 10MB +- Bash: extract the top 20 IPs from access.log +- Why did this command fail? diff --git a/docs/README.agents.md b/docs/README.agents.md index c8a2640d..a4335a3f 100644 --- a/docs/README.agents.md +++ b/docs/README.agents.md @@ -214,6 +214,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-agents) for guidelines on how to | [Technical Content Evaluator](../agents/technical-content-evaluator.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftechnical-content-evaluator.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftechnical-content-evaluator.agent.md) | Elite technical content editor and curriculum architect for evaluating technical training materials, documentation, and educational content. Reviews for technical accuracy, pedagogical excellence, content flow, code validation, and ensures A-grade quality standards. | | | [Technical Debt Remediation Plan](../agents/tech-debt-remediation-plan.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftech-debt-remediation-plan.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftech-debt-remediation-plan.agent.md) | Generate technical debt remediation plans for code, tests, and documentation. | | | [Technical spike research mode](../agents/research-technical-spike.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fresearch-technical-spike.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fresearch-technical-spike.agent.md) | Systematically research and validate technical spike documents through exhaustive investigation and controlled experimentation. | | +| [Terminal Helper](../agents/terminal-helper.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterminal-helper.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterminal-helper.agent.md) | Fast terminal syntax and command helper for PowerShell and Bash | | | [Terraform Agent](../agents/terraform.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md) | Terraform infrastructure specialist with automated HCP Terraform workflows. Leverages Terraform MCP server for registry integration, workspace management, and run orchestration. Generates compliant code using latest provider/module versions, manages private registries, automates variable sets, and orchestrates infrastructure deployments with proper validation and security practices. | [terraform](https://github.com/mcp/io.github.hashicorp/terraform-mcp-server)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=terraform&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22TFE_TOKEN%253D%2524%257BCOPILOT_MCP_TFE_TOKEN%257D%22%2C%22-e%22%2C%22TFE_ADDRESS%253D%2524%257BCOPILOT_MCP_TFE_ADDRESS%257D%22%2C%22-e%22%2C%22ENABLE_TF_OPERATIONS%253D%2524%257BCOPILOT_MCP_ENABLE_TF_OPERATIONS%257D%22%2C%22hashicorp%252Fterraform-mcp-server%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=terraform&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22TFE_TOKEN%253D%2524%257BCOPILOT_MCP_TFE_TOKEN%257D%22%2C%22-e%22%2C%22TFE_ADDRESS%253D%2524%257BCOPILOT_MCP_TFE_ADDRESS%257D%22%2C%22-e%22%2C%22ENABLE_TF_OPERATIONS%253D%2524%257BCOPILOT_MCP_ENABLE_TF_OPERATIONS%257D%22%2C%22hashicorp%252Fterraform-mcp-server%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22TFE_TOKEN%253D%2524%257BCOPILOT_MCP_TFE_TOKEN%257D%22%2C%22-e%22%2C%22TFE_ADDRESS%253D%2524%257BCOPILOT_MCP_TFE_ADDRESS%257D%22%2C%22-e%22%2C%22ENABLE_TF_OPERATIONS%253D%2524%257BCOPILOT_MCP_ENABLE_TF_OPERATIONS%257D%22%2C%22hashicorp%252Fterraform-mcp-server%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D) | | [Terraform IaC Reviewer](../agents/terraform-iac-reviewer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-iac-reviewer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-iac-reviewer.agent.md) | Terraform-focused agent that reviews and creates safer IaC changes with emphasis on state safety, least privilege, module patterns, drift detection, and plan/apply discipline | | | [Terratest Module Testing](../agents/terratest-module-testing.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterratest-module-testing.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterratest-module-testing.agent.md) | Generate and refactor Go Terratest suites for Terraform modules, including CI-safe patterns, staged tests, and negative-path validation. | |