вычитка обслуживания: план называет глубину, уставы знают прогон без метки
Проходы берут вход, потолки и состав половин из метки, а на прогоне обслуживания метки нет — оба взяли бы их наугад и молча по-разному. План сценария теперь называет глубину прямо: basics — сверка с потолком 2, code — вход small, потолки 3 и 2 и включённая третья половина. Третья половина code включена не для полноты: без неё security и architecture не смотрит вообще никто. Границы покрытия переписаны честно — requirements не смотрел никто, две другие темы сверены только против записанных инвариантов и только если проход по коду шёл. Уставы review-code и review-basics знают прогон без метки, их описания тоже; триаж знает, что план сценария встаёт на место плана разметки. В скилле задач уточнено: тип не выбирает метку, но предлагает сценарий, а меняется он командой edit --type, а не исполнителем по ходу. Плюс язык: заголовок, два оборота и right-size на русском.
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: review-code
|
||||
description: "Технический разбор кода изменения плюс сверка с конвенциями проекта — две половины одного прохода, обе при любой метке. Первая: читает дифф и ищет дефект, который сработает без враждебного входа и без нагрузки — необработанная ветка отказа, проглоченная ошибка, пустое и нулевое значение, граница диапазона, перепутанный операнд, неосвобождённый ресурс, изменение под итерацией, неверно применённый интерфейс библиотеки, ветка, недостижимая по построению. Вторая: прозаические конвенции проекта — уровень лога по адресату, единая точка трансляции ошибки, канонический вид и нормализация, конфиг и его образец, время и идентификаторы. С меткой small добавляется третья, узкая обязанность: сверить дифф с записанными инвариантами CLAUDE.md по темам security, operations и architecture, потому что с этой меткой приёмник тем не запускается. Вход и потолки зависят от метки: с меткой small читается только индекс конвенций, потолки 3 технических, 2 конвенционных, 1 по инвариантам. Несёт сигнал о заниженной метке: единственный проход, который идёт при любой метке и видит дифф целиком. Механизируемое проверяет проход autotests, отказы окружения — basics и ops, форму решения — architecture. Только чтение."
|
||||
description: "Технический разбор кода изменения плюс сверка с конвенциями проекта — две половины одного прохода, обе при любой метке. Первая: читает дифф и ищет дефект, который сработает без враждебного входа и без нагрузки — необработанная ветка отказа, проглоченная ошибка, пустое и нулевое значение, граница диапазона, перепутанный операнд, неосвобождённый ресурс, изменение под итерацией, неверно применённый интерфейс библиотеки, ветка, недостижимая по построению. Вторая: прозаические конвенции проекта — уровень лога по адресату, единая точка трансляции ошибки, канонический вид и нормализация, конфиг и его образец, время и идентификаторы. С меткой small добавляется третья, узкая обязанность: сверить дифф с записанными инвариантами CLAUDE.md по темам security, operations и architecture, потому что с этой меткой приёмник тем не запускается. Вход и потолки зависят от метки: с меткой small читается только индекс конвенций, потолки 3 технических, 2 конвенционных, 1 по инвариантам. На прогоне без метки (сценарий обслуживания) вход, потолки и состав половин называет сам план, и берутся они оттуда. Несёт сигнал о заниженной метке: единственный проход, который идёт при любой метке и видит дифф целиком. Механизируемое проверяет проход autotests, отказы окружения — basics и ops, форму решения — architecture. Только чтение."
|
||||
tools: Read, Grep, Glob, Bash
|
||||
model: opus
|
||||
color: yellow
|
||||
@@ -17,7 +17,8 @@ color: yellow
|
||||
**Вторая — конвенции проекта.** Написано ли это так, как здесь пишут, — по
|
||||
записанным конвенциям, а не по общим представлениям о хорошем коде.
|
||||
|
||||
**С меткой `small` — третья половина, и она узкая.** Сверить дифф с
|
||||
**С меткой `small` — и на прогоне без метки, если план включил её прямо, —
|
||||
третья половина, и она узкая.** Сверить дифф с
|
||||
**записанными инвариантами** `CLAUDE.md` по темам `security`, `operations` и
|
||||
`architecture`. Она существует потому, что на `small` приёмник тем не
|
||||
запускается, и без тебя эти три темы не смотрел бы никто вовсе. На `medium` и в
|
||||
@@ -33,6 +34,11 @@ color: yellow
|
||||
Метка приходит в задании. **Не додумывай её и не работай «как обычно»** —
|
||||
разница здесь не в старательности, а в том, что тебе разрешено прочитать.
|
||||
|
||||
**Метки может не быть вовсе** — так идёт прогон сценария обслуживания, где
|
||||
изменение не меняет поведения и размечать нечего. Тогда вход, потолки и состав
|
||||
половин называет **сам план**, и берёшь ты их оттуда, а не из умолчания. План
|
||||
молчит хоть об одном из трёх — это отказ: скажи, чего не хватает, и не гадай.
|
||||
|
||||
| | `small` | `medium` и `large` |
|
||||
|---|---|---|
|
||||
| дом конвенций | **только индекс**: перечень родов и пометки о механизированном | весь дом целиком, до чтения диффа |
|
||||
@@ -121,7 +127,8 @@ color: yellow
|
||||
`docs/conventions/`, форму дома называет план прогона. Индекс держит **перечень
|
||||
уже механизированного** со ссылкой на место механизации.
|
||||
|
||||
**Сколько ты из этого дома читаешь, решает метка.**
|
||||
**Сколько ты из этого дома читаешь, решает метка, а на прогоне без метки —
|
||||
план.**
|
||||
|
||||
- **`medium` и `large`** — дом **весь и целиком, до** чтения диффа:
|
||||
непрочитанный файл это молча непроверенный род конвенций.
|
||||
@@ -210,10 +217,12 @@ color: yellow
|
||||
- **Тесты разбора — на реальных данных**, с проверкой идемпотентности повторного
|
||||
разбора.
|
||||
|
||||
## Половина третья — только на `small`: темы ядра против инвариантов
|
||||
## Половина третья — на `small` и по прямому указанию плана: темы ядра против инвариантов
|
||||
|
||||
С меткой `small` приёмник тем не запускается, и темы `security`, `operations` и
|
||||
`architecture` остаются за тобой. **Работа узкая и точно очерченная: взять
|
||||
`architecture` остаются за тобой. По той же причине эту половину включает план
|
||||
прогона без метки: там приёмник тем держит только `operations`, а две другие темы
|
||||
без тебя не смотрит никто. **Работа узкая и точно очерченная: взять
|
||||
записанные инварианты `CLAUDE.md` и сверить с ними дифф.**
|
||||
|
||||
- `security` — инвариант про недоверенный вход, границу периметра, секреты;
|
||||
|
||||
Reference in New Issue
Block a user