Перейти к содержимому

Паттерн верификации шагов

Назначение

Гарантирует, что каждый шаг workflow действительно завершён перед переходом к следующему. Предотвращает пропуск незавершённой работы и требует доказательств выполнения.

Структура

[execute-step] → [verify-step] → verified=yes → [next-step]
→ verified=no → [retry-or-escalate]

Реализация

Нода выполнения

{
"type": "agent-directive",
"id": "execute-step",
"directive": "Implement {{current_step_name}}:\n{{current_step_action}}",
"completionCondition": "Step implementation complete",
"inputSchema": {
"type": "object",
"properties": {
"implementation_summary": { "type": "string" }
},
"required": ["implementation_summary"]
},
"connections": { "success": "verify-step" }
}

Нода верификации

{
"type": "agent-directive",
"id": "verify-step",
"completionCondition": "The real artifact checked against the expected result and the evidence or remaining gap reported",
"directive": "Verify step {{current_step_name}} completed:\n- Expected: {{expected_output}}\n- Check actual result matches expected\n- Provide evidence",
"inputSchema": {
"type": "object",
"properties": {
"step_verified": { "type": "string", "enum": ["yes", "no"] },
"verification_evidence": { "type": "string" }
},
"required": ["step_verified", "verification_evidence"]
},
"connections": { "success": "check-verification" }
}

Поле verification_evidence записывает обоснование, но строка сама по себе ничего не доказывает. Читатель проверяет относящийся к утверждению артефакт или результат действия.

Нода проверки

{
"type": "condition",
"id": "check-verification",
"cases": [
{
"when": {
"operator": "eq",
"left": { "contextPath": "verify-step.step_verified" },
"right": "yes"
},
"output": "verified"
}
],
"connections": {
"verified": "proceed-to-next",
"default": "handle-failure"
}
}

Требования к доказательствам

Укажите, что считается доказательством:

{
"directive": "Select evidence for the property actually changed: observed focused test/API results for behavior, the stored artifact for representation, viewed screenshots for appearance, and reasoned primary-source review for meaning and architecture. Report unavailable checks and limitations honestly; do not run unrelated checks to fill a list."
}

Свидетельство соответствует роду утверждения

Утверждение о факте — команда выполнилась, тест прошёл, ссылка открывается, файл содержит этот текст — подтверждается выводом инструмента или самим артефактом. Утверждение-суждение — структура связна, довод держится, результат годится своему читателю — подтверждается самим рассуждением, и ничем другим из доступного.

Смешение этих двух родов даёт сбой в обе стороны. Координата, предъявленная вместо суждения, — номер строки, сетка покрытия, доказательство прочтения, балл из десяти — это адрес, а не оценка: она говорит, где смотреть, но не о том, годится ли увиденное, и остаётся зелёной при плохой работе. Суждение, предъявленное вместо факта, — мнение там, где есть проверка.

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

Шаг, гейт которого выполним только числом, число и получит. Если существенное свойство качественное, назовите, как оно судится, вместо того, что оно должно превысить, — см. Фиксированная оценка семантического качества.

Контекстные переменные шага

Храните метаданные шага в контексте:

{
"variableRegistry": {
"current_step_index": { "type": "number", "description": "Номер текущего шага", "default": 1 },
"current_step_name": {
"type": "string",
"description": "Название текущего шага",
"default": "Step 1"
},
"current_step_action": {
"type": "string",
"description": "Что делает текущий шаг",
"default": "Implement feature X"
},
"expected_output": {
"type": "string",
"description": "Ожидаемый результат текущего шага",
"default": "Feature X works with tests passing"
}
}
}

Используйте expression ноды для обновления:

{
"type": "expression",
"id": "increment-step",
"expressions": ["current_step_index = current_step_index + 1"],
"connections": { "default": "load-next-step" }
}

Реальный пример

Пример предполагает объявленные метаданные шага и существующие целевые ноды в содержащем workflow:

{
"id": "verify-step-implementation",
"type": "agent-directive",
"completionCondition": "Actual step artifact checked against the expected outcome and remaining gaps recorded",
"connections": { "success": "check-verification" },
"directive": "Verify step {{current_step_index}} ({{current_step_name}}) implementation.\n\nExpected outcome: {{expected_output}}\n\nVerification checklist:\n- Functionality works as expected\n- Tests pass (if applicable)\n- No regressions introduced\n\nProvide concrete evidence for each claim.",
"inputSchema": {
"properties": {
"step_verified": { "type": "string", "enum": ["yes", "no"] },
"verification_evidence": { "type": "string" },
"issues_found": { "type": "string" }
},
"required": ["step_verified", "verification_evidence"]
}
}

Обработка неудачной верификации

При неудаче — повторная попытка или эскалация:

{
"type": "condition",
"id": "check-retry-limit",
"cases": [
{
"when": {
"operator": "lt",
"left": { "contextPath": "current_iteration" },
"right": 3
},
"output": "under-limit"
}
],
"connections": {
"under-limit": "fix-and-retry",
"default": "escalate-to-user"
}
}

Связанные паттерны