Repository navigation
01 Usage.ru
- Откройте
PROMPT.ru.md. - Скопируйте всё ниже YAML-заголовка — заголовок нужен сопровождающим, а не агенту.
- Вставьте в поле системного промпта агента или в файл правил, который читает рантайм.
Больше ничего не требуется. Промпт не называет инструментов, поэтому отсутствующая возможность деградирует явно (M6): агент говорит, какой возможности нет, вместо того чтобы делать вид, что сработало.
python tools/prompt_lint.py # код 0 = документ структурно полон
python tools/prompt_lint.py --json # те же находки машинно-читаемо
python tools/experience.py selftest # хранилище отклоняет то, что обещает отклонятьЗамерено на свежем клоне:
PASS: 0 error(s), 0 warning(s)
13/13 experience checks passed
Линтер — структурные ворота, а не суждение о содержании: он доказывает, что каждый модуль есть, что у
него есть строка **Check:**, что у него есть русский двойник и что перекрёстные ссылки разрешаются.
Суждение о содержании — в docs/QA.ru.md репозитория.
## Answer
<сам результат, без предисловия>
## Evidence
- утверждение — путь:строка / URL / вывод команды
## Assumptions
- допущение — что изменится, если оно неверно
## Open questions
- что определить не удалось и почему это важно
## Reused experience
- id записи — вердикт применимости (match | adapted | rejected) — что адаптировано
## Next step
<одно действие, с командой>
gate 12/12Раздел ## Reused experience появляется только когда хранилище действительно дало использованную
запись; строка ворот — всегда.
| Проверка | Провал, когда |
|---|---|
| тема названа одним предложением | ответ разбирает соседнюю, более лёгкую задачу |
| строка ворот присутствует | ответ выглядит проверяемым, но им не является |
| у каждого допущения названо последствие | «наверное, нормально» без цены ошибки |
| то, что вне рамок, записано | половина запроса молча выброшена |
- Дайте агенту написать карточку задачи (M1). Если он не может назвать тему одним предложением — он не понял запрос; остановите его здесь, это дешевле, чем читать три страницы не той работы.
- Дайте написать карточку домена (M2). Набор навыков, подходящий любому проекту, универсален и бесполезен; спрашивайте конкретно про факты из строки «надо проверить».
- Посмотрите на первую проверку (M5). Она должна сравнивать результат с ожиданием, записанным до действия, а не подгонять ожидание после.
- Прочитайте строку ворот, затем результат.
Разрешён не более одного уточняющего вопроса, и только если пробел блокирует всё продвижение
(M1, правило 3). Остальные пробелы уходят в Unknowns и в ## Assumptions.
Идентификаторы модулей — это интерфейс, а не украшение:
| Симптом | Что сказать |
|---|---|
| правдоподобный ответ без источников | «M3 и M4: где журнал контекста и какие утверждения помечены?» |
| работа начата без понимания запроса | «M1: сначала карточка задачи» |
| уверенность в коде, который никто не читал | «M4, правило 3: проверить не смог — допустимый ответ» |
| необратимое действие сделано тихо | «M6, правила 2–3: сначала песочница либо вопрос» |
| строка ворот отсутствует | «M8: прогони ворота и сообщи их одной строкой» |
| ту же работу собираются делать заново | «M13: поищи в хранилище до планирования» |
Удаление, перезапись, миграция, публикация, отправка: промпт требует воспроизведения в песочнице с приманкой, которая обязана выжить, сухого прогона там, где инструмент его даёт, и явного согласия (M6). Если агент это пропустил, ответ не «в основном правильный» — он не принят, как бы ни выглядело остальное.
Дальше: Карта модулей — что именно проверяет каждый модуль, либо Установка, чтобы поставить команду в палитру.
репозиторий · релизы · MIT