dotnet-doc-skills

Генерирует inline XML-doc комментарии (///) непосредственно в .cs-файлах по рекомендациям Microsoft (summary, param, returns, remarks, exception, typeparam, paramref, value, example, see, seealso, inheritdoc). Язык вывода — РУССКИЙ. Используй этот skill, когда пользователь просит «задокументируй», «добавь XML-комментарии», «напиши документацию к классу/методу», «оформи /// для …», «добавь summary», «doc-cs» — даже если он не упомянул слово «skill». Это НЕ генератор внешних .md-файлов (для этого — doc-md) и НЕ генератор схемы БД (для этого — doc-db).

Реконструирует структуру реляционной БД проекта (Oracle) ИСКЛЮЧИТЕЛЬНО из исходного кода: SQL-строк-литералов в C# (INSERT/UPDATE/SELECT/DELETE с bind-параметрами :p_*), вызовов OracleDbType.* и обращений к DataRow["COL"].ToInt64()/ToStr()/ToDateTime()/ToNullableInt64() в mapping-классах. НЕ читает EF Core, НЕ читает .sql-файлы, НЕ подключается к БД. Результат — файлы *.md в папке documentation/ на РУССКОМ с разделами по каждой таблице: назначение, колонки с типами и описаниями, связи (FK выводятся эвристически по именам и помечаются «предположительно»). Используй skill, когда пользователь говорит «опиши БД», «сделай database.md», «реверсни схему из кода», «какие таблицы используются», «doc-db» — даже если он не использует слово «schema». Это НЕ генератор C#-комментариев (для этого — doc-cs).

Генерирует ОДИН обзорный README.md в корне указанной папки — навигационную карту мульти-проектной папки для будущего claude code и человека. Рекурсивно находит все .cs, определяет проекты (.csproj) и описывает каждый публичный тип кратким абзацем: что класс делает в целом, его логика/роль и зависимости — без сигнатур методов и таблиц параметров. Структура README: проекты → namespace → классы. Язык вывода — РУССКИЙ. Используй, когда пользователь говорит «doc-folder», «сделай README для папки», «опиши проекты в каталоге», «карта кода папки», «обзор классов в папке» — даже без слова «skill». Это НЕ генератор inline /// (для этого — doc-cs), НЕ детальная API-дока по .md на класс (для этого — doc-md) и НЕ схема БД (для этого — doc-db).

Генерирует внешнюю Markdown-документацию для C#/.NET классов: отдельный .md-файл на каждый класс с таблицей свойств, разделом каждого метода (параметры, возвращаемое значение, исключения) и сводным описанием класса в конце. Структура папок documentation/api/ повторяет структуру solution. Ставит гиперссылки на унаследованные типы и на типы из других файлов проекта. Используй, когда пользователь говорит «сгенерируй .md для класса», «создай внешнюю документацию», «сделай markdown-описание», «doc-md». Это НЕ генератор inline XML-doc комментариев (для этого — doc-cs) и НЕ реверс- инжиниринг схемы БД (для этого — doc-db).