workflow-tdd-plan-plan: Скилл для автоматизации TDD

--- name: workflow-tdd-plan-plan description: Унифицированный навык TDD, объединяющий 6-фазное планирование TDD с генерацией цепочек задач Red-Green-Refactor и 4-фазную верификацию TDD с отчетами о соответствии. Активируется при "workflow-tdd-plan", "workflow-tdd-verify". allowed-tools: Skill, Agent, AskUserQuestion, TaskCreate, TaskUpdate, TaskList, Read, Write, Edit, Bash, Glob, Grep --- <purpose> Унифицированный навык TDD, объединяющий планирование TDD (генерация цепочек задач Red-Green-Refactor со структурой разработки с тестами) и верификацию TDD (проверка соответствия с отчетами о качестве). Создает IMPL_PLAN.md, JSON-файлы задач с внутренними циклами TDD и TDD_COMPLIANCE_REPORT.md. Активируется при "workflow-tdd-plan" (режим планирования) или "workflow-tdd-verify" (режим верификации). </purpose> <process> ## 1. Обзор архитектуры ``` ┌──────────────────────────────────────────────────────────────────┐ │ Оркестратор рабочего процесса TDD (SKILL.md) │ │ → Маршрутизация по режиму: plan | verify │ │ → Чистый координатор: Выполнение фаз, разбор выходных данных, передача контекста │ └──────────────────┬───────────────────────────────┘ │ ┌───────────────────────┴───────────────────────┐ ↓ ↓ ┌─────────────┐ ┌───────────┐ │ Режим планирования │ │ Режим верификации │ │ (по умолчанию) │ │ │ │ Фаза 1-6 │ │ Фаза 7 │ └──────┬──────┘ └───────────┘ │ ┌─────┼─────┬─────┬─────┬─────┐ ↓ ↓ ↓ ↓ ↓ ↓ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ │ 1 │ │ 2 │ │ 3 │ │ 4 │ │ 5 │ │ 6 │ │Обн│ │Конт│ │Анал│ │Разр│ │Ген│ │Валид│ └───┘ └───┘ └───┘ └───┘ └─┬─┘ └───┘ ↓ ┌───────────┐ │ Подтверждение │─── Верификация ──→ Фаза 7 │ (выбор) │─── Выполнение ─→ Skill("workflow-execute") └───────────┘─── Просмотр ──→ Отображение статуса сессии в строке ``` ## 2. Ключевые принципы проектирования 1. **Чистый оркестратор**: SKILL.md только маршрутизирует и координирует; детали выполнения находятся в файлах фаз. 2. **Постепенная загрузка фаз**: Читайте документацию фаз ТОЛЬКО тогда, когда эта фаза собирается выполняться. 3. **Многорежимная маршрутизация**: Один навык обрабатывает режимы планирования/верификации путем определения режима. 4. **Модель прикрепления задач**: Подзадачи ПРИКРЕПЛЯЮТСЯ, выполняются последовательно, а затем СКРЫВАЮТСЯ. 5. **Автоматическое продолжение**: После завершения каждой фазы автоматически выполняйте следующую ожидающую фазу. 6. **Закон TDD**: НЕТ ПРОДУКТИВНОГО КОДА БЕЗ ПЕРЕДУМЫВАЮЩЕГОГО ТЕСТА - обеспечивается структурой задачи. ## 3. Интерактивный сбор предпочтений Перед переходом к выполнению фазы соберите предпочтения рабочего процесса с помощью AskUserQuestion: ```javascript // ★ Унифицированная проверка auto mode: -y/--yes передается из $ARGUMENTS или ccw const autoYes = /b(-y|--yes)b/.test($ARGUMENTS) if (autoYes) { // Автоматический режим: пропуск всех вопросов, использование значений по умолчанию workflowPreferences = { autoYes: true } } else { const prefResponse = AskUserQuestion({ questions: [ { question: "Пропустить все этапы подтверждения (автоматический режим)?", header: "Auto Mode", multiSelect: false, options: [ { label: "Интерактивный (рекомендуется)", description: "Интерактивный режим, включающий этапы подтверждения" }, { label: "Авто", description: "Пропустить все подтверждения, автоматическое выполнение" } ] } ] }) workflowPreferences = { autoYes: prefResponse.autoMode === 'Auto' } } ``` **workflowPreferences** передается в фазу выполнения в качестве переменной контекста, на которую ссылаются как `workflowPreferences.autoYes` внутри фаз. ## 4. Определение режима ```javascript const args = $ARGUMENTS const mode = detectMode(args) function detectMode(args) { // Режим определяется триггером навыка if (skillName === 'workflow-tdd-verify') return 'verify' return 'plan' // по умолчанию: workflow-tdd-plan } ``` ## 5. Компактное восстановление (постоянство фазы) Многофазное планирование TDD (фазы 1-6/7) охватывает длительные разговоры. Использует **двойную страховку**: TodoWrite отслеживает активную фазу, чтобы защитить ее от сжатия, а sentinel - как запасной вариант. > **⚠️ КОМПАКТНАЯ ДИРЕКТИВА**: Контекст сжатия ДОЛЖЕН проверять статус TodoWrite. > Фаза, помеченная как `in_progress`, является активной фазой выполнения - сохраняйте ее ПОЛНОЕ содержимое. > Сжимайте только фазы, помеченные как `completed` или `pending`. ## 6. Поток выполнения — Режим планирования (по умолчанию) ``` Разбор входных данных: └─ Преобразование пользовательского ввода в структурированный формат TDD (ЦЕЛЬ/ОБЛАСТЬ/КОНТЕКСТ/ФОКУС ТЕСТА) Фаза 1: Обнаружение сессии └─ Read("phases/01-session-discovery.md") └─ Вывод: sessionId (WFS-xxx) Фаза 2: Сбор контекста └─ Read("phases/02-context-gathering.md") ├─ Задачи, прикрепленные: Анализ структуры → Определение интеграции → Генерация пакета └─ Вывод: contextPath + conflictRisk Фаза 3: Анализ охвата тестами └─ Read("phases/03-test-coverage-analysis.md") ├─ Задачи, прикрепленные: Обнаружение фреймворка → Анализ охвата → Определение пробелов └─ Вывод: testContextPath Фаза 4: Разрешение конфликтов (опционально: conflictRisk ≥ medium) └─ Решение (проверка conflictRisk): ├─ conflictRisk ≥ medium → Read("phases/04-conflict-resolution.md") │ ├─ Задачи, прикрепленные: Обнаружение конфликтов → Анализ журналов → Применение стратегий │ └─ Вывод: conflict-resolution.json └─ conflictRisk < medium → Перейти к фазе 5 Фаза 5: Генерация задач TDD └─ Read("phases/05-tdd-task-generation.md") ├─ Задачи, прикрепленные: Обнаружение → Планирование → Вывод └─ Вывод: IMPL_PLAN.md, IMPL-*.json, TODO_LIST.md Фаза 6: Проверка структуры TDD └─ Read("phases/06-tdd-structure-validation.md") └─ Вывод: Отчет о проверке + Шлюз подтверждения плана Подтверждение плана (Решение пользователя): └─ Решение (выбор пользователя): ├─ "Проверить соответствие TDD" (Рекомендуется) → Перейти к фазе 7 (tdd-verify) ├─ "Начать выполнение" → Skill(skill="workflow-execute") └─ "Просто просмотр статуса" → Отобразить статус сессии в строке ``` ## 7. Ключевые принципы проектирования 1. **Чистый оркестратор**: SKILL.md только маршрутизирует и координирует; детали выполнения находятся в файлах фаз. 2. **Постепенная загрузка фаз**: Читайте документацию фаз ТОЛЬКО тогда, когда эта фаза собирается выполняться. 3. **Многорежимная маршрутизация**: Один навык обрабатывает режимы планирования/верификации путем определения режима. 4. **Модель прикрепления задач**: Подзадачи ПРИКРЕПЛЯЮТСЯ, выполняются последовательно, а затем СКРЫВАЮТСЯ. 5. **Автоматическое продолжение**: После завершения каждой фазы автоматически выполняйте следующую ожидающую фазу. 6. **Закон TDD**: НЕТ ПРОДУКТИВНОГО КОДА БЕЗ ПЕРЕДУМЫВАЮЩЕГО ТЕСТА - обеспечивается структурой задачи. ## 8. Интерактивный сбор предпочтений Перед переходом к выполнению фазы соберите предпочтения рабочего процесса с помощью AskUserQuestion: ```javascript // ★ Унифицированная проверка auto mode: -y/--yes передается из $ARGUMENTS или ccw const autoYes = /b(-y|--yes)b/.test($ARGUMENTS) if (autoYes) { // Автоматический режим: пропуск всех вопросов, использование значений по умолчанию workflowPreferences = { autoYes: true } } else { const prefResponse = AskUserQuestion({ questions: [ { question: "Пропустить все этапы подтверждения (автоматический режим)?", header: "Auto Mode", multiSelect: false, options: [ { label: "Интерактивный (рекомендуется)", description: "Интерактивный режим, включающий этапы подтверждения" }, { label: "Авто", description: "Пропустить все подтверждения, автоматическое выполнение" } ] } ] }) workflowPreferences = { autoYes: prefResponse.autoMode === 'Auto' } } ``` **workflowPreferences** передается в фазу выполнения в качестве переменной контекста, на которую ссылаются как `workflowPreferences.autoYes` внутри фаз. ## 9. Определение режима ```javascript const args = $ARGUMENTS const mode = detectMode(args) function detectMode(args) { // Режим определяется триггером навыка if (skillName === 'workflow-tdd-verify') return 'verify' return 'plan' // по умолчанию: workflow-tdd-plan } ``` ## 10. Компактное восстановление (постоянство фазы) Многофазное планирование TDD (фазы 1-6/7) охватывает длительные разговоры. Использует **двойную страховку**: TodoWrite отслеживает активную фазу, чтобы защитить ее от сжатия, а sentinel - как запасной вариант. > **⚠️ КОМПАКТНАЯ ДИРЕКТИВА**: Контекст сжатия ДОЛЖЕН проверять статус TodoWrite. > Фаза, помеченная как `in_progress`, является активной фазой выполнения - сохраняйте ее ПОЛНОЕ содержимое. > Сжимайте только фазы, помеченные как `completed` или `pending`. ## 11. Поток выполнения — Режим планирования (по умолчанию) ``` Разбор входных данных: └─ Преобразование пользовательского ввода в структурированный формат TDD (ЦЕЛЬ/ОБЛАСТЬ/КОНТЕКСТ/ФОКУС ТЕСТА) Фаза 1: Обнаружение сессии └─ Read("phases/01-session-discovery.md") └─ Вывод: sessionId (WFS-xxx) Фаза 2: Сбор контекста └─ Read("phases/02-context-gathering.md") ├─ Задачи, прикрепленные: Анализ структуры → Определение интеграции → Генерация пакета └─ Вывод: contextPath + conflictRisk Фаза 3: Анализ охвата тестами └─ Read("phases/03-test-coverage-analysis.md") ├─ Задачи, прикрепленные: Обнаружение фреймворка → Анализ охвата → Определение пробелов └─ Вывод: testContextPath Фаза 4: Разрешение конфликтов (опционально: conflictRisk ≥ medium) └─ Решение (проверка conflictRisk): ├─ conflictRisk ≥ medium → Read("phases/04-conflict-resolution.md") │ ├─ Задачи, прикрепленные: Обнаружение конфликтов → Анализ журналов → Применение стратегий │ └─ Вывод: conflict-resolution.json └─ conflictRisk < medium → Перейти к фазе 5 Фаза 5: Генерация задач TDD └─ Read("phases/05-tdd-task-generation.md") ├─ Задачи, прикрепленные: Обнаружение → Планирование → Вывод └─ Вывод: IMPL_PLAN.md, IMPL-*.json, TODO_LIST.md Фаза 6: Проверка структуры TDD └─ Read("phases/06-tdd-structure-validation.md") └─ Вывод: Отчет о проверке + Шлюз подтверждения плана Подтверждение плана (Решение пользователя): └─ Решение (выбор пользователя): ├─ "Проверить соответствие TDD" (Рекомендуется) → Перейти к фазе 7 (tdd-verify) ├─ "Начать выполнение" → Skill(skill="workflow-execute") └─ "Просто просмотр статуса" → Отобразить статус сессии в строке ``` ## 12. Ключевые принципы проектирования 1. **Чистый оркестратор**: SKILL.md только маршрутизирует и координирует; детали выполнения находятся в файлах фаз. 2. **Постепенная загрузка фаз**: Читайте документацию фаз ТОЛЬКО тогда, когда эта фаза собирается выполняться. 3. **Многорежимная маршрутизация**: Один навык обрабатывает режимы планирования/верификации путем определения режима. 4. **Модель прикрепления задач**: Подзадачи ПРИКРЕПЛЯЮТСЯ, выполняются последовательно, а затем СКРЫВАЮТСЯ. 5. **Автоматическое продолжение**: После завершения каждой фазы автоматически выполняйте следующую ожидающую фазу. 6. **Закон TDD**: НЕТ ПРОДУКТИВНОГО КОДА БЕЗ ПЕРЕДУМЫВАЮЩЕГО ТЕСТА - обеспечивается структурой задачи. ## 13. Интерактивный сбор предпочтений Перед переходом к выполнению фазы соберите предпочтения рабочего процесса с помощью AskUserQuestion: ```javascript // ★ Унифицированная проверка auto mode: -y/--yes передается из $ARGUMENTS или ccw const autoYes = /b(-y|--yes)b/.test($ARGUMENTS) if (autoYes) { // Автоматический режим: пропуск всех вопросов, использование значений по умолчанию workflowPreferences = { autoYes: true } } else { const prefResponse = AskUserQuestion({ questions: [ { question: "Пропустить все этапы подтверждения (автоматический режим)?", header: "Auto Mode", multiSelect: false, options: [ { label: "Интерактивный (рекомендуется)", description: "Интерактивный режим, включающий этапы подтверждения" }, { label: "Авто", description: "Пропустить все подтверждения, автоматическое выполнение" } ] } ] }) workflowPreferences = { autoYes: prefResponse.autoMode === 'Auto' } } ``` **workflowPreferences** передается в фазу выполнения в качестве переменной контекста, на которую ссылаются как `workflowPreferences.autoYes` внутри фаз. ## 14. Определение режима ```javascript const args = $ARGUMENTS const mode = detectMode(args) function detectMode(args) { // Режим определяется триггером навыка if (skillName === 'workflow-tdd-verify') return 'verify' return 'plan' // по умолчанию: workflow-tdd-plan } ``` ## 15. Компактное восстановление (постоянство фазы)