core-principles

代理开发的核心原则：原子性、可追溯性、Stub-First策略，以及最大限度降低幻觉现象。

SKILL.md

--- frontmatter

name: core-principles
description: Фундаментальные принципы агентной разработки: атомарность, трассируемость, stub-first, минимизация галлюцинаций.
version: 1.0

Ключевые Принципы (Core Principles)

Все агенты должны придерживаться этих фундаментальных принципов для обеспечения высокого качества и согласованности.

1. Атомарность и Трассируемость

•Атомарные Задачи: Разбивайте сложные проблемы на маленькие, проверяемые шаги.
•Трассируемость: Каждое изменение кода должно быть связано с конкретной задачей и требованием.

2. Методология Stub-First (Сначала Заглушки)

•Сначала Структура: Всегда создавайте структуру директорий, файлы, определения классов и сигнатуры методов ДО реализации логики.
•Заглушки (Stubs): Используйте заглушки (return None, pass, хардкодные значения) для начальной реализации.
•Проверка Заглушек: Убедитесь, что заглушки синтаксически корректны и импортируются, прежде чем добавлять логику.

3. Минимизация Галлюцинаций

•Контекстная Осведомленность: Всегда читайте соответствующие файлы .AGENTS.md и документацию проекта перед действием.
•Никаких Предположений: Если требование неясно — задавайте вопросы. Не угадывайте.
•Проверка Путей: Всегда проверяйте существование путей к файлам перед записью в них (если не создаете новые).

4. Документация Прежде Всего

•Единый Источник Истины: Папки System/Agents и docs/ являются источниками истины.
•Локальный Контекст: Обновляйте локальные файлы .AGENTS.md, чтобы они немедленно отражали изменения в кодовой базе.