AIKraft/AI/Войти
AIKraft/Skills/Рабочий процесс по спецификации

Рабочий процесс по спецификации

Use when medium-to-large changes need explicit requirements, technical design, and task planning before implementation, especially for multi-module work, unclear acceptance criteria, or architecture-heavy requests.

TETencent official Дизайн

Что делает навык

Навык организует структурированный рабочий процесс (Spec Workflow) для изменений среднего и крупного масштаба, требуя явных требований, технического проектирования и планирования задач перед началом реализации. Он предотвращает ошибки за счёт поэтапного согласования с пользователем и использования критериев приёмки EARS.

Когда применять

  • Разработка новой функции, кросс-модульной интеграции или изменение архитектуры.
  • Работа с неясными критериями приёмки, требующими их формализации до начала кодинга.
  • Сложные задачи, затрагивающие несколько файлов, пользовательские сценарии, проектирование базы данных или UI.
  • Запросы на создание новой страницы, системы, редизайн или рефакторинг нескольких модулей.

Как работает

  1. Оценить масштаб задачи: если она небольшая и риски низкие, перейти к реализации; иначе начать с фазы требований.
  2. Фаза 1 (Требования): создать specs/<spec_name>/requirements.md с описанием проблемы, пользовательскими историями и критериями приёмки в формате EARS.
  3. Фаза 2 (Проектирование): создать specs/<spec_name>/design.md с архитектурой, выбором технологий, моделями данных и стратегией тестирования.
  4. Фаза 3 (Задачи): создать specs/<spec_name>/tasks.md, разбив дизайн на конкретные исполняемые задачи, связанные с требованиями.
  5. Фаза 4 (Исполнение): начать реализацию только после подтверждения плана пользователем, актуализируя статус задач и сохраняя трассируемость.

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

«Нужно добавить новую страницу регистрации пользователей с валидацией данных и интеграцией с базой данных»
«Реализуй кросс-модульную интеграцию между сервисом заказов и складом, критерии приёмки пока не до конца ясны»
«Сделай редизайн главной страницы и измени архитектуру отображения карточек товаров»

Что понадобится

  • Локальные навыки (Sibling skills) из репозитория CloudBase, доступные по относительным путям (например, ../ui-design/SKILL.md).
  • Отсутствие HTTP-запросов к удалённым файлам; при отсутствии локального файла требуется установка плагина CloudBase.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «spec-workflow» из репозитория: # https://github.com/tencentcloudbase/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r spec-workflow/ ~/.claude/skills/spec-workflow/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.