From 8008fb914e1ae02eabe28f942aa8d1124e241dd1 Mon Sep 17 00:00:00 2001
From: Dmitry Dementiev <d.dementiev@concept-software.ru>
Date: Fri, 11 Sep 2026 12:37:03 +0300
Subject: [PATCH] =?UTF-8?q?docs(skills):=20=D0=BE=D0=B1=D0=BD=D0=BE=D0=B2?=
 =?UTF-8?q?=D0=BB=D1=91=D0=BD=20=D0=BD=D0=B0=D0=B2=D1=8B=D0=BA=20=D0=BF?=
 =?UTF-8?q?=D0=B5=D1=80=D0=B5=D0=B4=D0=B0=D1=87=D0=B8=20=D0=BA=D0=BE=D0=BD?=
 =?UTF-8?q?=D1=82=D0=B5=D0=BA=D1=81=D1=82=D0=B0=20=D1=81=D0=B5=D1=81=D1=81?=
 =?UTF-8?q?=D0=B8=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Зачем: новому агенту нужна точка продолжения работы без пересказа существующих артефактов.
- Что: навык переименован в session-handoff; уточнены содержание записки и выбор пути, сохранён вызов из других навыков.
- Проверка: YAML и git diff --check пройдены; quick_validate.py отклоняет сохранённые поля argument-hint и disable-model-invocation.
---
 .../.agents/skills/session-handoff/SKILL.md   | 37 +++++++++++++++++++
 .../skills/session-state-handoff/SKILL.md     | 16 --------
 2 files changed, 37 insertions(+), 16 deletions(-)
 create mode 100644 agents/.agents/skills/session-handoff/SKILL.md
 delete mode 100644 agents/.agents/skills/session-state-handoff/SKILL.md

diff --git a/agents/.agents/skills/session-handoff/SKILL.md b/agents/.agents/skills/session-handoff/SKILL.md
new file mode 100644
index 0000000..f2ea810
--- /dev/null
+++ b/agents/.agents/skills/session-handoff/SKILL.md
@@ -0,0 +1,37 @@
+---
+name: session-handoff
+description: Write a handoff for a fresh session when requested by the user or another skill.
+argument-hint: "What should the next session focus on?"
+disable-model-invocation: false
+---
+
+# Session handoff
+
+Напиши записку, по которой новый агент сможет продолжить работу.
+Если передан аргумент, используй его как фокус следующей сессии.
+
+Сохрани записку по правилам проекта; если путь не задан —
+во временный каталог ОС. Верни путь к записке.
+
+## Содержание
+
+Обеспечь следующему агенту понимание:
+
+- цели пользователя и действующих ограничений;
+- выполненной и оставшейся работы, препятствий;
+- принятых решений и открытых вопросов;
+- следующего действия.
+
+Не дублируй содержание существующих артефактов: спецификаций,
+планов, ADR, задач, коммитов и diff. Ссылайся на них по пути
+или URL. В самой записке сохраняй то, что иначе останется
+только в разговоре: уточнения пользователя, причины решений,
+результаты проверок и незавершённые рассуждения.
+
+Объём и структуру выбирай по задаче.
+
+Если для продолжения нужны навыки, укажи их имена
+и когда их применять.
+
+Исключи секретные значения и ненужные для продолжения персональные данные.
+При необходимости оставь имена переменных и пути к настройкам.
diff --git a/agents/.agents/skills/session-state-handoff/SKILL.md b/agents/.agents/skills/session-state-handoff/SKILL.md
deleted file mode 100644
index d76edb5..0000000
--- a/agents/.agents/skills/session-state-handoff/SKILL.md
+++ /dev/null
@@ -1,16 +0,0 @@
----
-name: session-state-handoff
-description: Keep current session state and possibility of resume after compaction or in fresh session.
-argument-hint: "How to keep current work after interruption?"
-disable-model-invocation: false
----
-
-Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS or where is prescribed in AGENTS.md or other project config.
-
-Include a "suggested skills" section in the document, naming which skills the next agent should call the Skill tool for.
-
-Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
-
-Redact any sensitive information, such as API keys, passwords, or personally identifiable information.
-
-If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.