Understanding Spec-Driven-Development: Kiro, Spec-Kit, and Tessl
Спецификация, а не код, становится главным артефактом: разработка начинается с написания спецификации, которая затем используется для генерации кода. Это позволяет ускорить разработку, особенно с помощью AI, и повысить качество за счёт чётких требований. Однако есть риск, что спецификация устареет при изменении кода, что требует синхронизации. В целом, подход обещает повысить эффективность, но требует тщательного управления.
Комментарии (15)
- Обсуждение вращается вокруг "spec-anchored" подхода: от использования спецификаций как единственного источника правды до практических вопросов, таких как разделение труда между человеком и ИИ, и как спецификация может эволюционировать в процессе разработки.
- Участники делятся опытом использования таких инструментов как SpecKit и Plotly Studio, подчеркивая, что спецификация должна быть лаконичной, но исчерпывающей, чтобы быть полезной.
- Обсуждается, как спецификация может быть использована для управления проектом, но также вызывает тревогу, что без должного контроля она может стать неактуальной или чрезмерно сложной.
- Поднимается вопрос о том, как спецификация должна эволюционировать вместе с проектом, и как она должна отражать реальные условия и требования, даже если эти требования еще не полностью ясны.
- Заключается, что хотя инструменты могут и должны быть использованы для автоматизации части работы, важно оставить пространство для человеческого суждения и творчества, и что спецификация сама по себе не должна быть чрезмерно сложной или непрактичной.
Oq: Terminal OpenAPI Spec Viewer
oq — консольный просмотрщик OpenAPI-спецификаций.
Быстро открывает swagger.json|yaml в терминале, показывает эндпоинты, параметры, примеры ответов.
Установка: go install github.com/plutov/oq@latest.
Использование: oq spec.yaml.
Комментарии (12)
- Утилита «oq» — терминальный просмотрщик OpenAPI-спецификаций, упрощающий навигацию по большим YAML/JSON.
- Пользователи практикуют spec-driven development: спецификация = единый источник правды, из неё генерируют типизированный клиент и сервер.
- Название «oq» уже занято другим проектом (homebrew-установка ставит не тот пакет); автор пока не переименовывает, предлагает брать бинарь с GitHub-релизов.
- Поддержка OpenAPI 3.1 заявлена, но реализована поверх библиотеки kin-openapi, которая 3.1 пока не умеет; для простого листинга маршрутов и компонентов это работает.
- В планах — добавить возможность делать реальные HTTP-запросы прямо из viewer.