resolve: постановку текстом взяли полноправным входом

Задачу часто нужно решить прямо по описанию в разговоре, без файла в каталоге — так её берёт и opsx:propose. Скилл вход текстом объявлял, но прорабатывала его одна разведка: у решения и обслуживания шаг «прочитать задачу» читал разделы записи, шаг закрытия закрывал запись, признак обслуживания опирался на объявленный автором тип, а критерии приходили «от проекта». Форм постановки теперь две, и они равноправны. Отпадают ровно те шаги, у которых пропал предмет: ready гонять нечего, закрывать нечего. Ни один шаг с предметом не выпал — гейт, ревью, синк, чекпоинт и коммит идут как обычно, а сценарий, метку и глубину форма не выбирает. Взамен пропавшего — названное вслух первой репликой: как понята постановка, каким типом её считаешь и где проводишь границу. Человек, написавший текст, сидит в этом же разговоре и поправляет одной фразой; названный после работы тип не признак, а объяснение готового диффа. По сценариям: решение добирает недостающие критерии приёмки на чекпоинте и считает их данными только после ответа; обслуживание объявляет их отсутствие строкой (чекпоинта у него нет) и само называет границы, которых текст не дал; разведка увязана с общим правилом, а её шаг закрытия отпал с оговоркой про единственный след — записанный ответ. Записи в каталог скилл по-прежнему не заводит: ни перед работой, ни задним числом ради закрытия. Похожую строку беклога не разыскивает. Перечень осей пополнен формой постановки: по ней ветвятся готовность, источник типа и наличие закрытия.
2026-08-13 19:20:25 +03:00
parent 6251157d8d
commit 94fa66b262
6 changed files with 136 additions and 15 deletions
@@ -1,6 +1,6 @@
 ---
 name: code-resolve
-description: "Взять одну задачу и довести её до закрытия. Одна точка входа, три сценария, и выбирает сценарий сам скилл, прочитав постановку. Способ известен и меняется поведение — сценарий решения: цикл Spec Driven Development (opsx propose → разметка → ревью дизайна → чекпоинт с объяснением человеческим языком → opsx apply → ревью кода → archive → синк документации → коммит → закрытие). Способ известен, а спека не меняется (тип chore: тулчейн, зависимости, сборка, гит-хуки, перенос, чистка) — сценарий обслуживания: правка → гейт со сверкой состава проверок → ревью фиксированным планом без change (autotests, operations, плюс conventions, если тронут код) → синк документации → коммит → закрытие; планового стопа нет, change не заводится. Нашлась дельта-спека — задача оказалась шире своего типа: стоп с объяснением простым языком и двумя решениями человека, переформулировать запись в fix или feature и решать её процессом того типа следующим прогоном либо прекратить работу. Способа нет, постановка мутная, тип research — сценарий разведки: вопрос и рамки → чтение документов, кода и внешних источников (можно opsx:explore) → чекпоинт вариантов: 2–4 способа решить, цена каждого, что становится невозможным, рекомендация → ответ уезжает в документы канона, исход — в задачи → вычитка написанного → коммит → закрытие. Разведка кода не пишет и change не заводит, а выбранный способ реализуется следующим прогоном. На входе путь к файлу задачи, её слаг или просто текст. Использовать, когда просят взять, сделать или решить задачу, обновить зависимости или сборку, разобраться, изучить, сравнить подходы, проработать сырую идею, ответить на вопрос из беклога."
+description: "Взять одну задачу и довести её до закрытия. Одна точка входа, три сценария, и выбирает сценарий сам скилл, прочитав постановку. Способ известен и меняется поведение — сценарий решения: цикл Spec Driven Development (opsx propose → разметка → ревью дизайна → чекпоинт с объяснением человеческим языком → opsx apply → ревью кода → archive → синк документации → коммит → закрытие). Способ известен, а спека не меняется (тип chore: тулчейн, зависимости, сборка, гит-хуки, перенос, чистка) — сценарий обслуживания: правка → гейт со сверкой состава проверок → ревью фиксированным планом без change (autotests, operations, плюс conventions, если тронут код) → синк документации → коммит → закрытие; планового стопа нет, change не заводится. Нашлась дельта-спека — задача оказалась шире своего типа: стоп с объяснением простым языком и двумя решениями человека, переформулировать запись в fix или feature и решать её процессом того типа следующим прогоном либо прекратить работу. Способа нет, постановка мутная, тип research — сценарий разведки: вопрос и рамки → чтение документов, кода и внешних источников (можно opsx:explore) → чекпоинт вариантов: 2–4 способа решить, цена каждого, что становится невозможным, рекомендация → ответ уезжает в документы канона, исход — в задачи → вычитка написанного → коммит → закрытие. Разведка кода не пишет и change не заводит, а выбранный способ реализуется следующим прогоном. На входе путь к файлу задачи, её слаг или просто текст постановки: размеченная запись не обязательна — текст берётся так же, как его берёт opsx:propose, и текстом идут все три сценария. Использовать, когда просят взять, сделать или решить задачу — хоть записью из каталога, хоть описанием прямо в разговоре, — обновить зависимости или сборку, разобраться, изучить, сравнить подходы, проработать сырую идею, ответить на вопрос из беклога."
 ---

 # Работа над одной задачей
@@ -114,7 +114,13 @@ description: "Взять одну задачу и довести её до за
 Ничего из этого не задано — попроси у вызывающего и остановись; сам в беклог не
 лезь и приоритеты не интерпретируй: что делать дальше, решает не этот скилл.

-**Запись из каталога сперва проверяется на готовность, и проверяет её машина.**
+**Форм постановки две, и обе полноправны:** запись каталога задач и текст,
+переданный вызовом. Форма — не сценарий: развилка ниже у них общая, и текст
+принимают все три сценария.
+
+### Запись из каталога
+
+**Запись сперва проверяется на готовность, и проверяет её машина.**
 Вызови Skill `av-dev:task-track` и попроси прогнать `ready <слаг>`: он смотрит
 тип, пустой ли раздел вопросов и собраны ли разделы схемы типа. Судить это глазами нельзя — ровно тот случай, где машина дешевле и точнее,
 а цена ошибки отложенная: недостающие критерии приёмки обнаружатся на приёмке,
@@ -127,9 +133,43 @@ description: "Взять одну задачу и довести её до за
 **Отказ `ready` сценарий не выбирает.** Запись `research` без раздела «Вопрос»
 (сырьё) — отказ и здесь: у неё нет вопроса, и разведывать нечего.

-Каталога задач в проекте нет или задача пришла текстом — прогонять
-нечего. Тогда прочитай постановку сам и скажи строкой, что готовность машиной не
-проверялась; работу при этом не останавливай.
+Каталога задач в проекте нет — прогонять нечего, и постановка приходит текстом
+по построению: дальше по разделу ниже.
+
+### Постановка текстом
+
+**Текст — вход, а не урезанный режим.** Ровно так берёт постановку
+`opsx:propose`: предложение делается из фразы человека, а не из заранее
+размеченной записи. Требовать записи там, где работа уместилась в разговор,
+значит заводить учёт ради учёта — след у прогона остаётся и без неё: коммит, а у
+решения ещё и заархивированный change.
+
+**Первой репликой покажи, как ты понял постановку** — рядом с названным
+сценарием, одной-двумя фразами: что считаешь предметом работы и где проводишь
+границу. Запись толкуется по разделам, текст — молча, и расходится он с замыслом
+ровно там, где его никто не показал. Человек, написавший текст, сидит в этом же
+разговоре и поправляет одной фразой; автора записи, написанной месяц назад,
+рядом нет, и потому текстовая постановка проверяется дешевле, а не хуже.
+
+Что несёт запись и чем это заменяется, когда её нет:
+
+| Что несёт запись | Чем заменяется у текста |
+| --- | --- |
+| готовность, проверенную машиной | читаешь постановку сам и говоришь строкой, что `ready` не гонялся |
+| тип, объявленный автором | тип называешь ты — вслух, первой репликой, вместе со сценарием |
+| критерии приёмки с оракулами | те, что есть в тексте; недостающие [решение](references/solve.md) добирает на чекпоинте, [обслуживание](references/maintain.md) объявляет строкой отсутствующими |
+| адрес, куда ляжет ответ разведки | назначаешь сам и по канону, а не по удобству — [research.md](references/research.md), шаг 1 |
+| закрытие как след работы | закрывать нечего, и шаг закрытия отпадает вместе с записью |
+
+**Записи в каталог этот скилл не заводит — ни перед работой, ни задним числом
+ради закрытия.** Граница «беклогом не владеет» действует и здесь. Работа не
+уместилась в прогон, её надо ставить в очередь или из неё выросла пачка — скажи
+это строкой и предложи `av-dev:task-track`: заводит он и по своим правилам.
+
+**Похожую запись в беклоге не ищешь.** Человек назвал работу текстом — значит,
+предмет прогона этот текст, а не строка индекса, которая на него похожа.
+Наткнулся на такую строку по ходу — скажи о ней строкой доклада и не закрывай:
+закрытие записи это приёмка, и поручали её не тебе.

 ## Развилка: какой сценарий

@@ -211,14 +251,18 @@ description: "Взять одну задачу и довести её до за
 ```mermaid
 flowchart TD
    in["вход: файл, слаг или текст"]
+    form{"форма постановки"}
    ready["ready: готовность записи<br/>av-dev:task-track"]
+    plain["понимание, тип и границы —<br/>первой репликой; ready не гонится,<br/>закрывать потом нечего"]
    fork{"есть очевидный<br/>способ решения?"}
    fork2{"меняется ли<br/>спека?"}
    solve["сценарий решения<br/>references/solve.md<br/>код, ревью, архив, коммит"]
    main["сценарий обслуживания<br/>references/maintain.md<br/>правка, ревью, синк, коммит"]
    res["сценарий разведки<br/>references/research.md<br/>ответ в документы и задачи"]

-    in --> ready --> fork
+    in --> form
+    form -->|"запись каталога"| ready --> fork
+    form -->|"текст"| plain --> fork
    fork -->|"да"| fork2
    fork -->|"нет"| res
    fork2 -->|"да"| solve
@@ -348,6 +392,8 @@ change, у второго — сверенный состав гейта и си
  он;
 - **исход** одним из четырёх слов своего сценария и, если он не благополучный,
  чем ограничен результат;
+- **постановка пришла текстом** — сказать это прямо: как она понята, что `ready`
+  не гонялся и что закрывать было нечего;
 - что сделано, какие вопросы записаны и куда;
 - чего проверить или узнать **не удалось**.