Przejdź do głównej zawartości

Dokumentacja silnika w klonie

Od v1.116.0 dokumentacja silnika leży w repozytorium strony w wersji jej silnika (.sc-engine.json) i jest ułożona pod agenta AI:

  • AGENTS.md (i AGENTS.en.md) to krótki indeks: pięć zasad, mapa „zadanie → strona” i lista przed zgłoszeniem. Indeks stoi w bloku między <!-- BEGIN:sc-engine --> i <!-- END:sc-engine -->. Ten blok przepisuje upgrade, więc go nie zmieniaj — hook odmówi commita (SC-E102). Własne notatki dla siebie albo dla agenta pisz nad blokiem albo pod nim: upgrade ich nie rusza, a hook, sc push i sc submit je przepuszczają. CLAUDE.md dalej jest dowiązaniem do AGENTS.md.
  • .sc/docs/ — strony „jedno zadanie na stronę”: sekcja edytowalna, nowa podstrona, reguły pól, pole obrazka, języki, moduł strony, sklep, baner zgody… Każda zaczyna się od „Zanim zaczniesz” i listy kontrolnej, ma kod do skopiowania i lustro angielskie (<strona>.en.md). Katalog należy do silnika: zmiana w nim zatrzymuje hook (SC-E101), a upgrade go przepisuje.
  • Identyfikatory odmów. Hook własności, sc push, sc submit i bramka kontraktu kończą każdą odmowę znacznikiem w postaci [SC-E210 → .sc/docs/errors/SC-E210.md]. Strona błędu mówi, co się stało i jak to naprawić. 1xx to granica własności, 2xx — kontrakt platformy.
  • W sc mcp: docs_search szuka po stronach klonu (także po identyfikatorze błędu), docs_page zwraca całą stronę, po polsku albo po angielsku. Narzędzia nie łączą się z siecią i nie uruchamiają kodu klonu. Klon sprzed v1.116.0 nie ma .sc/docs/ — dostaniesz wtedy informację, że jego dokumentacja jest w AGENTS.md.