| name | wiki-ingest |
| description | Use when adding a new source (file or URL) into the WP Knowledge wiki with synthesis, cross-linking, index updates, and log bookkeeping. |
Wiki Ingest
Compile a new source into the persistent wiki. База знаний сфокусирована на WordPress open-source. Источники с WordPress.com требуют адаптации.
WordPress.com → Open-Source Adaptation
При ingest источников с wordpress.com/support:
- Адаптировать: планы/цены → self-hosted стоимость; managed хостинг → самостоятельное управление; .com-фичи → opensource-аналоги
- Пометить .com-only: AI Website Builder, Express Design Service, onboarding sessions — явно указать «⚠️ Только WordPress.com»
- Сохранять: концепции WordPress, плагины/темы из .org, технические руководства, WooCommerce
- Уточнять через web_search: если не уверен в opensource-эквиваленте
Pre-condition
- ⚠️ Всегда
summarize для URL: summarize "URL" --extract --format md. Не используй web_fetch или browser.
- Read
src/content/docs/index.md first.
- Read related existing pages before writing.
- Confirm source location:
- Local:
raw/YYYY/MMDD/filename.{md,pdf} — date-organized, immutable
- URL: fetch with
summarize "URL" --extract --format md (primary), fallback to web_fetch or skills/jina-ai/extract.mjs
- If source is a URL, extract and save it to
raw/YYYY/MMDD/ (using current date), then ingest from that local copy.
Process
- Read the source fully.
- Adapt .com → open-source — если источник с WordPress.com, адаптируй контент (см. секцию выше). Используй web_search для уточнения opensource-эквивалентов.
- Present key takeaways to user before writing:
- 3-5 main points.
- What to emphasize/de-emphasize.
- Potential contradictions with existing pages.
- Create or update relevant pages in the correct category folder.
- Add or update cross-references in both directions.
- Update
src/content/docs/index.md entries.
- Append
src/content/docs/log.md:
## [YYYY-MM-DD] ingest | <source title>
- Report all touched files.
Placement Heuristic
- Core concepts ->
how-to/
- FAQ/comparisons ->
faq/
- Plugin-specific ->
plugins/
- Theme-specific ->
themes/
- Security ->
security/
- Performance ->
performance/
- Reusable recipes ->
snippets/
If none fit, propose a new category before creating it.
Quality Bar
- Wiki content in ru-RU.
- No copy-paste dumps from source; synthesize.
- Every new page has frontmatter (
title, description).
- Do NOT start pages with an
# H1 heading; Starlight renders frontmatter title as H1. Start content from ##.
- «Материалы и источники» обязательны: каждая страница заканчивается ссылкой на оригинальный URL. Внешние ссылки автоматически получают
target="_blank" при сборке — в исходниках пиши обычный markdown: [текст](https://...).
- Ссылки всегда с
.md: все относительные ссылки на wiki-страницы пиши с расширением .md (напр. [text](./page.md)). Для index-файлов: ./category/index.md. НИКОГДА не пиши без .md или с / в конце. Плагин remarkStripMdLinks сам уберёт расширения при сборке.
- Backlink pass is mandatory.
Done Criteria
- Pages created/updated.
- Cross-links reconciled.
index.md updated.log.md appended.
