К основному содержанию
субагент CX Codex

powershell-module-architect · voltagent/awesome-codex-subagents — субагент Codex: что делает и установка

Субагент powershell-module-architect проектирует структуру модулей PowerShell, проверяет контракты команд Verb-Noun и организует упаковку без лишней переделки API.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/powershell-module-architect.toml
Открыть на GitHub

Что делает powershell-module-architect

Субагент подключается, когда нужно спроектировать структуру PowerShell-модуля, настроить профиль или подготовить пакет к публикации. Вместо масштабного рефакторинга агент ищет первопричину проблемы и предлагает минимальное безопасное изменение. Без прямого указания родительского агента он не станет переписывать публичный API целиком.

В работе агент проверяет контракты команд на соблюдение схемы Verb-Noun, поведение конвейера (pipeline), информативность ошибок и соответствие документации коду. Также анализируются манифест модуля, совместимость между редакциями PowerShell и требования к подписи скриптов при корпоративном распространении.

Какие задачи решает

  • спроектировать структуру манифеста и публичный API модуля PowerShell
  • исправить контракты команд под именование Verb-Noun и работу с pipeline
  • настроить безопасное версионирование и упаковку для публикации
  • проверить совместимость скрипта между разными версиями PowerShell

Примеры запросов агенту

  • Проверь структуру модуля в каталоге Tools и настрой правильный экспорт команд
  • Сделай ревью параметров командлета Send-Alert под работу через конвейер
  • Помоги обновить манифест модуля и настроить проверку цифровой подписи

Как установить powershell-module-architect

Вручную: положить файлы

.codex/agents/powershell-module-architect.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о powershell-module-architect

Как установить powershell-module-architect в Codex?

Создайте конфигурационный файл субагента по пути .codex/agents/powershell-module-architect.toml.

Что делает powershell-module-architect?

Субагент анализирует структуру модулей PowerShell, соглашения об именовании команд, обработку ошибок, упаковку и совместимость версий.

Перепишет ли субагент весь код модуля при локальной ошибке?

Нет, правила запрещают агенту переделывать весь API модуля ради точечной правки, если родительский агент явно этого не потребовал.

Исходный текст

powershell-module-architect.toml · MIT
# powershell-module-architect

Use when a task needs PowerShell module structure, command design, packaging, or profile architecture work.

Own PowerShell module architecture work as developer productivity and workflow reliability engineering, not checklist execution.

Prioritize the smallest practical change or recommendation that reduces friction, preserves safety, and improves day-to-day delivery speed.

Working mode:
1. Map the workflow boundary and identify the concrete pain/failure point.
2. Distinguish evidence-backed root causes from symptoms.
3. Implement or recommend the smallest coherent intervention.
4. Validate one normal path, one failure path, and one integration edge.

Focus on:
- module layout, command discoverability, and coherent public API boundaries
- cmdlet contract quality: Verb-Noun naming, parameters, and pipeline behavior
- error model consistency and operator-friendly diagnostics
- packaging, versioning, and publication safety for module consumers
- script signing and trust posture where enterprise distribution applies
- cross-version/cross-platform behavior where PowerShell editions differ
- help/documentation fidelity with implemented command behavior

Quality checks:
- verify command contracts are stable for existing automation users
- confirm pipeline input/output behavior is explicit and testable
- check module manifest/version updates for upgrade compatibility
- ensure error handling provides actionable operator guidance
- call out signing/publication checks needed in target environments

Return:
- exact workflow/tool boundary analyzed or changed
- primary friction/failure source and supporting evidence
- smallest safe change/recommendation and key tradeoffs
- validations performed and remaining environment-level checks
- residual risk and prioritized follow-up actions

Do not redesign the entire module API for localized issues unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «DevOps и инфраструктура» →

Сначала — powershell-module-architect от других авторов.

powershell-module-architect VoltAgent Community Субагент powershell-module-architect для Claude Code проектирует и перерабатывает модули PowerShell. Он подключается к задачам по профилям, упаковке кода и совместимости между версиями. CX Codex 183установок powershell-ui-architect VoltAgent Community Субагент powershell-ui-architect проектирует графические интерфейсы на WinForms и WPF или текстовые TUI для PowerShell-скриптов с разделением интерфейса и бизнес-логики. CX Codex 218установок powershell-master JosiahSiegel Скилл powershell-master для Claude Code и Codex: подсказывает синтаксис PowerShell, модули PSGallery, шаблоны CI/CD и практики безопасности при написании и отладке .ps1-скриптов. CX Codex +1 1 200установок powershell-windows davila7 Скилл powershell-windows определяет правила надёжных скриптов PowerShell под Windows: обязательные скобки для командлетов, отказ от Unicode и глубину JSON. Спасает от типичных синтаксических ошибок. CX Codex +1 169установок powershell официальный github Заставляет его писать PowerShell-скрипты по гайдлайнам Microsoft: cmdlet с формата Verb-Noun, полные имена команд вместо алиасов, [switch] для флагов, обработка ошибок через SupportsShouldProcess. CX Codex +1 ★ 41 430звёзд репо write-script-powershell windmill-labs Скилл write-script-powershell для Claude Code задаёт правила создания PowerShell-скриптов в Windmill: локального тестирования, обновления метаданных и безопасного деплоя. CX Codex +1 1установок powershell-7-expert VoltAgent Community Субагент powershell-7-expert пишет кроссплатформенные сценарии PowerShell 7+ и автоматизирует инфраструктуру Azure, Entra и GitHub Actions. Помогает перевести старые скрипты на синтаксис .NET 6/7. CX Codex 256установок

Из того же набора176

Весь набор →
slack-expert Субагент slack-expert для Codex помогает разрабатывать интеграции со Slack: ботов, обработчики событий и рабочие процессы. Он подключается к задачам, где важны интерактивность и поведение платформы. CX Codex ★ 6 505звёзд репо refactoring-specialist Субагент refactoring-specialist проводит низкорисковый структурный рефакторинг кода без изменения его поведения, улучшая читаемость и модульность. CX Codex ★ 6 505звёзд репо readme-generator Субагент readme-generator для Codex собирает README по реальным файлам репозитория и проверяет команды, настройки и примеры. Готовит документацию без выдуманных инструкций. CX Codex ★ 6 505звёзд репо powershell-ui-architect Субагент powershell-ui-architect для Codex проектирует интерфейсы на PowerShell для терминалов, форм, WPF и административных инструментов. Разбирает сбои и неудобства в интерактивных сценариях. CX Codex ★ 6 505звёзд репо mcp-developer Субагент mcp-developer для Codex разбирает MCP-серверы и клиенты, схемы инструментов и интеграции. Проверяет совместимость протокола и обработку ошибок. CX Codex ★ 6 505звёзд репо legacy-modernizer Субагент legacy-modernizer для Codex планирует переход на современные технологии без потери функциональности. Обновляет архитектуру или зависимости при высоком риске нарушить работу приложения. CX Codex ★ 6 505звёзд репо git-workflow-manager Субагент git-workflow-manager помогает выстроить стратегию веток, процесс слияния и правила релизов. Субагент подбирает точечные улучшения вместо радикальной перестройки репозитория. CX Codex ★ 6 505звёзд репо dx-optimizer Субагент dx-optimizer ищет трения в настройке, локальной разработке и цикле обратной связи. Он предлагает небольшие изменения с проверкой обычного и сбойного сценария. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой