name: wiki-faq
description: Создание и поддержка FAQ-страниц в вики: быстрые ответы на основе данных из каталога raw/ и существующих wiki-страниц, без gap analysis.
Wiki FAQ
Создаёт короткие FAQ-страницы — прямые ответы на вопросы со ссылками на вики. Агент работает с данными из raw/ и src/content/docs/.
Pre-condition
- Read
src/content/docs/index.md
- Read relevant wiki pages
- Read related
faq/ pages to avoid duplication
- If a
raw/ source file is provided — read it fully and synthesize
Process
- Answer concisely — 3-5 предложений основной мысли, без gap analysis
- Add how-to steps — если вопрос процедурный (ordered list)
- Add comparison table — если вопрос сравнительный
- Link to wiki — 2-5 ссылок на релевантные страницы
- Create page in
faq/ with frontmatter:
title = вопрос (например, «Как установить WordPress?»)
description = ответ в одно предложение
- Content: answer → steps/table → links → «Материалы и источники»
- Do NOT add
# H1 heading — Starlight renders title as H1
- Update
index.md — add entry in FAQ section
- Append
log.md: ## [YYYY-MM-DD] faq | <question>
FAQ Page Format
---
title: "Вопрос?"
description: "Короткий ответ в одно предложение."
---
## Краткий ответ
2-4 предложения сути. Без gap analysis, без «что покрыто».
## Как сделать (если how-to)
1. Шаг 1
2. Шаг 2
3. Шаг 3
## Сравнение (если comparison)
| Критерий | Вариант А | Вариант Б |
|---|---|---|
| ... | ... | ... |
## Материалы и источники
- [Страница вики](../path/to/page.md)
- [Оригинальная статья](https://...)
Quality Bar
- Ru-RU
- Коротко: страница не длиннее 80 строк
- Прямой ответ, без gap analysis
- Ссылки на wiki-страницы обязательны
- Frontmatter обязателен (
title, description)
- Не дублировать существующие faq-страницы
Done Criteria
- FAQ page created in
faq/
index.md updated
log.md appended