agentleFS
obviousbreadobviousbread/docs-skills/skills/docs-polozheniya/SKILL.md

docs-polozheniya

Skill0 starsChanged 15 days agoMITView on GitHub

Use when the user needs a standalone regulation for an organizational unit (Положение о структурном подразделении) in .docx format: положение об управлении, отделе or another unit. The document includes its own УТВЕРЖДАЮ block, approval sheet and acquaintance sheet. Works with docs-di for кадровые документы. НЕ использовать для приказов, распоряжений и указаний с преамбулой и словом ПРИКАЗЫВАЮ — это docs-ord.

The file

Files
SKILL.md

docs-polozheniya — Положения о структурных подразделениях

Создает завершенный кадровый документ: гриф УТВЕРЖДАЮ, семь содержательных разделов, блок СОГЛАСОВАНО и лист ознакомления. Отдельный приказ об утверждении не создается, если пользователь прямо его не запросил.

Пользовательский контекст

По умолчанию у всех абзацев, включая заголовки и ячейки таблиц, отключены «Запрет висячих строк», «Не отрывать от следующего», «Не разрывать абзац» и «С новой страницы» (widowControl, keepNext, keepLines, pageBreakBefore = 0).

До работы прочитай ~/.docs-plugin/org_details.md. Если файла нет — предложи запустить docs-init.

Если knowledge_base_path заполнен, прочитай корневые инструкции хранилища и найди итоговые положения, должностные инструкции руководителя и работников подразделения, оргструктуру и правила согласования. Читай столько карточек и связанных материалов, сколько нужно для подтверждения структуры, подчиненности, целей, задач, функций, полномочий и согласующих. Итоговый документ приоритетнее черновиков. Не выдумывай функции, подчиненность, полномочия, ФИО и реквизиты.

References

ФайлКогда читать
references/structure.mdВсегда: структура, содержание и оформление документа
references/approval-rules.mdВсегда: утверждение, согласование и проверка ФИО
references/quality-checklist.mdПосле каждой генерации и при ревью готового положения
references/helpers.mdПри вызове create_polozhenie() или изменении генератора
references/web-search.mdЕсли источников недостаточно или требуется проверить НПА
references/maintenance.mdПри изменении генератора или структуры скилла

Граница ответственности

  • docs-polozheniya: положение о структурном подразделении как самостоятельный кадровый документ.
  • docs-di: должностная инструкция работника.
  • docs-ord: приказ, распоряжение или указание с реквизитами ОРД, преамбулой и распорядительной частью.

Если пользователь просит положение и отдельный приказ о его утверждении, сначала подготовь положение через этот скилл, затем приказ через docs-ord.

Входные данные

Определи из запроса и источников:

  • вид и полное наименование подразделения;
  • место в структуре и непосредственное подчинение;
  • порядок назначения и подчинения руководителя;
  • входящие подразделения, если есть;
  • цели, задачи и функции;
  • специфические права;
  • утверждающего и цепочку согласования.

Если критичных данных не хватает, задай один компактный блок вопросов. Сначала используй доступные документы и пользовательское хранилище.

Источники содержания

Приоритет:

  1. Действующее итоговое положение о том же подразделении.
  2. Подтвержденная оргструктура и локальные правила организации.
  3. ДИ руководителя подразделения.
  4. ДИ работников подразделения.
  5. Положения о смежных подразделениях.
  6. Проверенные внешние источники и НПА.

Функции из ДИ руководителя обобщай до уровня подразделения. Обязанности работников используй для дополнения функций, но не переноси персональные обязанности дословно.

Workflow создания

  1. Прочитай обязательные references и org_details.md.
  2. Собери источники и отдели подтвержденные факты от предложений.
  3. Сформируй проект структуры: иерархия, цели, задачи, функции, права, согласующие.
  4. Покажи пользователю компактное превью и получи подтверждение.
  5. Проверь ФИО и должности по staff_file, итоговым документам или подтверждению пользователя.
  6. Сгенерируй .docx через create_polozhenie().
  7. Пройди quality-checklist.md, проверь содержимое DOCX и визуальный рендер.
  8. Исправь ошибки, повтори проверку и выдай файл с коротким отчетом об источниках.

Режим ревью

Если пользователь передал готовое положение и просит проверить или исправить его:

  1. Не создавай новый документ с нуля без необходимости.
  2. Сверь документ с structure.md, approval-rules.md, org_details.md, оргструктурой и источниками функций.
  3. Раздели замечания на критичные ошибки и рекомендации.
  4. При запросе на исправление сохрани исходное содержание и оформление, меняя только подтвержденные ошибки.

Генерация

Главная точка входа — generate.py:create_polozhenie. Организация загружается из org_details.md, но может быть передана через org для теста или разовой генерации.

from generate import create_polozhenie

create_polozhenie(
    unit_type="отдел",
    unit_name="организационного развития",
    parent_unit_name="Управления организационного развития",
    subordination="начальника Управления организационного развития",
    head_appointment="начальника Управления организационного развития",
    head_reports_to="начальнику Управления организационного развития",
    goals=["Координация организационного развития."],
    tasks=["Подготовка предложений по совершенствованию процессов."],
    functions=["Анализ и актуализация организационных процессов."],
    approvers=[
        {"position": "Руководитель кадрового подразделения", "name": "Фамилия И.О."},
    ],
)

Файловая политика

  • Генератор: skills/docs-polozheniya/generate.py.
  • Выход: {output_dir_polozheniya}/Положение об <подразделении>.docx.
  • Пустой output_dir_polozheniya означает текущую директорию.
  • Существующий файл не перезаписывается: добавляется суффикс 2, 3, ...
  • Не сохраняй реквизиты организации и персональные данные внутри скилла.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.