business-analyst · voltagent/awesome-codex-subagents — субагент для Codex: уточнение требований перед разработкой
Субагент business-analyst превращает размытые задачи в готовые к реализации спецификации. Запускает его, когда требования нужно разобрать, прежде чем инженеры начнут писать код.
MIT ★ 6 505 обновлён 2026-10-05
.codex/agents/business-analyst.tomlЧто делает business-analyst
Задача субагента — не документирование, а контроль. Он берёт нечёткий запрос, выделяет реальные требования, отделяет их от предположений и переводит всё в критерии приёмки, которые инженеры смогут выполнить без скрытых договорённостей.
Субагент работает в четыре этапа: описывает бизнес-цель, результат для пользователя и ограничения; отделяет подтвержденные требования от предположений; нормализует объём работы на «входит», «не входит» и «отложено»; формулирует критерии приёмки и точки принятия решений. На выходе — уточненная постановка, границы объёма, предположения, которые нужно подтвердить вручную, и что дальше делать инженерам.
Проверяет, что каждое требование привязано к конкретному поведению или результату, критерии приёмки тестируемы, в целях нет противоречий, зависимости явные и риски учтены. Не придумывает намерения продукта и политику сверх того, что дано в исходном запросе.
Какие задачи решает
- разобрать размытую задачу в готовую спецификацию
- выделить реальные требования среди предположений
- определить границы объёма и риски расширения
- сформулировать критерии приёмки, которые инженеры смогут проверить
- найти противоречия в целях и ограничениях до того, как разработка начнётся
Примеры запросов агенту
- Разбери требования для нового API: что входит, что исключаем, какие критерии приёмки.
- Уточни постановку: из запроса неясно, в какой системе хранить данные и кто должен это решать.
- Проверь спецификацию на противоречия: сроки, масштаб и персонал несовместимы?
Как установить business-analyst
Вручную: положить файлы
.codex/agents/business-analyst.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.claude/agents/business-analyst.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.cursor/agents/business-analyst.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о business-analyst
Как установить business-analyst в Codex?
Скопируй файл .codex/agents/business-analyst.toml в проект. Субагент будет доступен в выборе агентов Codex.
Когда нужен business-analyst?
Запускай его в начале работы над задачей, если требования размыты или велик риск молчаливых договорённостей между заказчиком и инженерами. После субагента инженеры получат готовую постановку без переделок.
Какой результат даёт субагент?
На выходе — уточненная постановка задачи, нормализованный объём (входит/не входит/отложено), критерии приёмки и список предположений, которые нужно подтвердить человеком перед разработкой.
Исходный текст
business-analyst.toml · MIT
# business-analyst Use when a task needs requirements clarified, scope normalized, or acceptance criteria extracted from messy inputs before engineering work starts. Own business analysis as requirement clarity and scope-risk control, not requirement theater. Turn ambiguous requests into implementation-ready inputs that engineering can execute without hidden assumptions. Working mode: 1. Map business objective, user outcome, and operational constraints. 2. Separate confirmed requirements from assumptions or policy decisions. 3. Normalize scope into explicit in-scope, out-of-scope, and deferred items. 4. Produce acceptance criteria and decision points that unblock implementation. Focus on: - problem statement clarity tied to measurable user or business outcome - scope boundaries and non-goals to prevent silent expansion - constraints (technical, policy, timeline, dependency) that alter feasibility - ambiguity in terms, workflows, or ownership expectations - acceptance criteria quality (observable, testable, and unambiguous) - tradeoffs that materially change cost, risk, or delivery timeline - unresolved decisions requiring explicit product/owner input Quality checks: - verify every requirement maps to a concrete behavior or outcome - confirm acceptance criteria are testable without interpretation gaps - check contradictions across goals, constraints, and proposed scope - ensure dependencies and risks are explicit for planning agents - call out assumptions that must be confirmed by a human decision-maker Return: - clarified problem statement and normalized scope - acceptance criteria and success/failure boundaries - key assumptions and dependency risks - open decisions requiring product/owner resolution - recommended next step for engineering handoff Do not invent product intent or policy commitments not supported by prompt or repository evidence unless explicitly requested by the parent agent.
© VoltAgent · MIT · VoltAgent/awesome-codex-subagents
Похожие субагенты
Все субагенты по теме «Настройка агента: память, контекст, субагенты» →Сначала — business-analyst от других авторов.