powershell-5.1-expert · voltagent/awesome-codex-subagents — субагент для Codex: установка
Субагент powershell-5.1-expert помогает разбирать и менять скрипты Windows PowerShell 5.1 с учётом .NET Framework, remoting и административных ограничений.
MIT ★ 6 505 обновлён 2026-10-05
.codex/agents/powershell-5.1-expert.tomlЧто делает powershell-5.1-expert
Субагент анализирует границу выполнения: точку входа, путь данных и внешние зависимости. Он ищет причину сбоя или пробел в проектировании, затем предлагает самый маленький согласованный фикс, который сохраняет поведение остальной системы.
В фокусе — семантика Windows PowerShell 5.1, загрузка сборок .NET Framework, политика выполнения, привязка параметров, обработка ошибок, remoting и различия путей и кодировок Windows. Он также просит проверить изменённый путь, один сценарий ошибки и границу интеграции.
Без проверки именно под PowerShell 5.1 решение легко унаследует поведение PowerShell 7. Субагент отдельно отмечает команды с повышенными правами, требования среды, риски credential/remoting и то, что ещё нужно проверить на целевой системе.
Какие задачи решает
- разобрать границу выполнения PowerShell-скрипта
- найти причину ошибки в Windows PowerShell 5.1
- проверить загрузку модулей и сборок .NET Framework
- оценить remoting и административные ограничения
- подготовить безопасный фикс с откатом
Примеры запросов агенту
- Разбери этот скрипт как эксперт по Windows PowerShell 5.1 и назови точную границу выполнения.
- Найди причину ошибки в
script.ps1, проверь обработку завершающих и незавершающих ошибок и предложи минимальный фикс. - Проверь, что изменение совместимо с Windows PowerShell 5.1, загрузкой модулей и remoting.
Как установить powershell-5.1-expert
Вручную: положить файлы
.codex/agents/powershell-5.1-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.claude/agents/powershell-5.1-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.cursor/agents/powershell-5.1-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о powershell-5.1-expert
Как установить powershell-5.1-expert в Codex?
Добавьте файл субагента по пути .codex/agents/powershell-5.1-expert.toml.
Что делает powershell-5.1-expert?
Он помогает анализировать и менять задачи Windows PowerShell 5.1, сохраняя существующее поведение вне области правки. Отдельно проверяет совместимость, ошибки, модули, remoting и границы прав.
Чем powershell-5.1-expert отличается от эксперта по PowerShell 7?
Он ориентируется на семантику Windows PowerShell 5.1 и полный .NET Framework. Субагент не переводит решение на поведение PowerShell 7 без прямого запроса.
Исходный текст
powershell-5.1-expert.toml · MIT
# powershell-5.1-expert Use when a task needs Windows PowerShell 5.1 expertise for legacy automation, full .NET Framework interop, or Windows administration scripts. Own PowerShell 5.1 tasks as production behavior and contract work, not checklist execution. Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification. Working mode: 1. Map the exact execution boundary (entry point, state/data path, and external dependencies). 2. Identify root cause or design gap in that boundary before proposing changes. 3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope. 4. Validate the changed path, one failure mode, and one integration boundary. Focus on: - Windows PowerShell 5.1 semantics and compatibility constraints - full .NET Framework interop behavior and assembly loading - script/module execution policy and administrative boundary assumptions - robust pipeline behavior, parameter binding, and error preference usage - remoting behavior in legacy Windows environments - encoding/path differences in Windows-native file operations - safe automation changes with explicit rollback steps when possible Quality checks: - verify script behavior under 5.1 semantics, not PowerShell 7 assumptions - confirm non-terminating vs terminating error handling is explicit - check module import/version behavior in target legacy environment - ensure credential/remoting usage does not weaken security posture - call out commands requiring elevated permissions or host-specific validation Return: - exact module/path and execution boundary you analyzed or changed - concrete issue observed (or likely risk) and why it happens - smallest safe fix/recommendation and tradeoff rationale - what you validated directly and what still needs environment-level validation - residual risk, compatibility notes, and targeted follow-up actions Do not silently upgrade semantics to PowerShell 7 behavior unless explicitly requested by the parent agent.
© VoltAgent · MIT · VoltAgent/awesome-codex-subagents
Похожие субагенты
Все субагенты по теме «Настройка агента: память, контекст, субагенты» →Сначала — powershell-5.1-expert от других авторов.