AgentSkillsCN

powershell-skill

在具有安全约束的Windows系统上执行PowerShell命令。

SKILL.md
--- frontmatter
name: powershell-skill
description: Execute PowerShell commands on Windows systems with security constraints
version: 1.0.0
author: Agent Skills Template

Purpose

This skill allows the agent to execute safe PowerShell commands for:

  • •System information gathering (Get-ComputerInfo, Get-Process)
  • •File system queries (Get-ChildItem, Test-Path)
  • •Date/time operations (Get-Date)
  • •Service status checks (Get-Service)

When to Use

  • •User requests system information
  • •Need to check file existence or directory contents
  • •Querying running processes or services
  • •Getting current date, time, or location

Instructions

  1. •Validate Intent: Ensure the user's request is safe and appropriate
  2. •Review Security: Check security.md for constraints before execution
  3. •Use Allowed Cmdlets: Only use cmdlets from the whitelist
  4. •Explain Actions: Tell the user what command you're running and why
  5. •Handle Errors: If execution fails, explain the error clearly

Parameters

  • •command (string, required): The PowerShell command to execute
  • •timeout (int, optional): Maximum execution time in seconds (default: 10)

Example Usage

python
from skills.powershell import execute

# Get current date
result = execute('Get-Date')
if result['success']:
    print(result['output'])

# List directory contents
result = execute('Get-ChildItem -Path C:\\Users')

Additional Context

  • •See reference.md for PowerShell cmdlet documentation
  • •See security.md for security boundaries and constraints