Приложение B. Совместимость с Qwen Code

Второй том описывает production-процессы вокруг Qwen Code. Часть этих процессов встроена в Qwen Code, а часть нужно реализовать в проекте как пользовательские команды, навыки (skills), хуки (hooks), MCP-серверы или обычные скрипты. Это приложение фиксирует границу, чтобы читатель не принимал проектируемый процесс за штатную CLI-команду.

Каноническая шкала

Во втором томе используется три уровня зрелости. Это не оценка качества идеи, а граница ожиданий от читателя.

Связь с четырьмя слоями такая: встроенные возможности Qwen Code относятся к Стандарту; пользовательские команды и проектные скрипты — к Рекомендации; внешний оркестратор — к Фронтиру. Если пример использует Kubernetes, Grafana, PagerDuty или отдельный исполнитель файлового арбитража, это фронтирный слой учебной модели, а не обязательное требование к прохождению тома.

Встроенный слой Qwen Code

Используйте эти возможности как есть:

• /plan — режим планирования без правок и shell-выполнения.
• /review — встроенное ревью кода с детерминированными проверками и параллельными ревью-агентами.
• /skills — просмотр и явный запуск навыков.
• /memory, /remember, /forget — управление памятью и QWEN.md (/dream как явная команда консолидации может появиться в более поздних версиях; если в вашем релизе её нет, оформляйте консолидацию как пользовательскую команду).
• /mcp и qwen mcp add — подключение MCP-серверов.
• @path — добавление файла или каталога в контекст.
• !command — shell-команды внутри интерактивной сессии.
• qwen -p "..." — безголовый (headless) запуск для CI, пакетных проверок и скриптов.

Пользовательские команды

Если вы хотите команды /specify, /tasks, /validate, /constitution или похожие, создайте их явно:

.qwen/
  commands/
    sdd/
      specify.md
      tasks.md
      validate.md
      constitution.md

Тогда команды будут вызываться как /sdd:specify, /sdd:tasks, /sdd:validate, /sdd:constitution. Внутри Markdown-файла хранится подсказка с {{args}}, ссылками на @specs/... и правилами остановки.

Аналогично оформляется и /clarify: в первом томе эта команда использовалась как шаг уточнения требований до планирования, но она не встроена в Qwen Code. Во втором томе под тот же сценарий заведите проектную пользовательскую команду (например, .qwen/commands/sdd/clarify.md), которая вызывается как /sdd:clarify. Поведение и контракт остановки задавайте в подсказке, чтобы шаг /clarify из первого тома воспроизводился без неявных допущений.

Проектные скрипты

Проверки, которые должны быть воспроизводимыми без модели, оформляйте как обычные скрипты:

scripts/
  spec_ci/
    check_coverage.py
    validate_schema.py
  stress_mutator/
    mutate_specs.py
    fake_validator.py
    immunity_score.py
  tribunal/
    run_duel.py
    check_invariants.py

write_judgment.py
  budget/
    compile.py
    simulate.py
    inspect.py

Qwen Code может помочь написать и запустить такие скрипты, но зелёный статус должен зависеть от кода проверки, а не от убедительности ответа модели.

Хуки

Для ограждений (guardrails) используйте официальные события Qwen Code: PreToolUse, PostToolUse, UserPromptSubmit, SessionStart, Stop, SubagentStop, Notification, PreCompact и другие. В тексте второго тома используйте именно эти имена, а не свободные варианты вроде pretooluse. Точный список событий и формат конфигурации сверяйте с актуальной документацией Qwen Code (см. ссылки в конце приложения).

MCP и внешние API

Production API не должны становиться неограниченными shell-командами. Для Grafana, PagerDuty, Kubernetes, Jira или внутреннего API лучше сделать MCP-сервер с разрешительным списком (allowlist) инструментов:

• только-чтение для triage и проверки;
• отдельные пишущие инструменты для безопасных действий;
• явные условия подтверждения и отката;
• запрет на передачу секретов в подсказках, следах и QWEN.md.

Термины второго тома

| Верификатор (Verifier) — голосует | /review, отдельная Qwen-сессия, под-агент или проектный скрипт | | Имплементор (Implementor) — голосует | Qwen Code в режиме default/auto-edit после утверждённого плана | | Safety — голосует с veto при critical_risk | отдельная Qwen-сессия с safety_review или проектный скрипт, проверяющий blast radius и условия отката | | Координатор (Coordinator) — non-voting protocolist | человек, задача CI или внешний оркестратор | | Файловый арбитраж (tribunal) | не встроенная команда; комбинация /review, скриптов, отчётов и правил в validation.md | | Шлюз спецификации (Spec CI) | GitHub Actions или локальные скрипты, которые могут использовать qwen -p только как вспомогательный слой | | Хранитель бюджета (budget keeper) | внешний сервис или скрипт; Qwen Code сам не управляет суточной квотой ярусов |

Справочные ссылки

README прикладного тома оставлен короткой картой маршрута, поэтому внешние источники собраны здесь.

• Qwen Code commands: https://qwenlm.github.io/qwen-code-docs/en/users/features/commands/
• Qwen Code headless mode: https://qwenlm.github.io/qwen-code-docs/en/users/features/headless/

• Qwen Code hooks: https://qwenlm.github.io/qwen-code-docs/en/users/features/hooks/
• Qwen Code skills: https://qwenlm.github.io/qwen-code-docs/en/users/features/skills/
• Qwen Code memory: https://qwenlm.github.io/qwen-code-docs/en/users/features/memory/
• Qwen Code MCP: https://qwenlm.github.io/qwen-code-docs/en/users/features/mcp/
• Qwen Code approval mode: https://qwenlm.github.io/qwen-code-docs/en/users/features/approval-mode/
• Qwen Code code review: https://qwenlm.github.io/qwen-code-docs/en/users/features/code-review/
• GitHub Spec Kit: https://github.com/github/spec-kit
• AWS Kiro documentation overview: https://aws.amazon.com/documentation-overview/kiro/
• OWASP Top 10 for LLM Applications: https://owasp.org/www-project-top-10-for-large-language-model-applications/
• Google SRE book: https://sre.google/sre-book/
• Goodhart's law: https://en.wikipedia.org/wiki/Goodhart%27s_law