Заметки встречи
Создаёт структурированный Markdown-файл встречи с повесткой, решениями и действиями.
Что делает скрипт
Скрипт принимает тему, дату, участников и пункты повестки, а затем формирует готовый каркас заметок. В файле есть блоки для решений, вопросов и таблицы действий с ответственными и сроками. Существующий файл не перезаписывается без флага force.
Быстрый старт
python meeting_notes.py --title "Планирование спринта" --attendees "Анна,Иван"
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python meeting_notes.py --title "Планирование спринта" --attendees "Анна,Иван"python meeting_notes.py --title "Разбор инцидента" --agenda "Факты,Причины,Действия" --output meetings/incident.mdpython meeting_notes.py --title "Встреча" --date 2026-11-10 --force
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
meeting_notes.py
#!/usr/bin/env python3
"""Каркас заметок встречи в Markdown."""
from __future__ import annotations
import argparse
import re
from datetime import date
from pathlib import Path
def slugify(value: str) -> str:
value = value.strip().lower()
value = re.sub(r"[^a-z0-9а-яё]+", "-", value, flags=re.IGNORECASE)
return value.strip("-") or "meeting"
def build_notes(args: argparse.Namespace, day: date) -> str:
attendees = [item.strip() for item in args.attendees.split(",") if item.strip()]
agenda = [item.strip() for item in args.agenda.split(",") if item.strip()]
lines = [
f"# {args.title}",
"",
f"Дата: {day.isoformat()}",
f"Ведущий: {args.facilitator}",
"",
"## Участники",
"",
]
if attendees:
lines.extend(f"- {name}" for name in attendees)
else:
lines.append("- ")
lines.extend([
"",
"## Повестка",
"",
])
if agenda:
for index, item in enumerate(agenda, start=1):
lines.append(f"{index}. {item}")
else:
lines.append("1. ")
lines.extend([
"",
"## Контекст",
"",
"",
"## Обсуждение",
"",
"",
"## Решения",
"",
"- ",
"",
"## Открытые вопросы",
"",
"- ",
"",
"## Действия",
"",
"| Действие | Ответственный | Срок |",
"|---|---|---|",
"| | | |",
"",
"## Следующая встреча",
"",
"- Дата: ",
"- Вопросы: ",
"",
])
return "\n".join(lines)
def main() -> int:
parser = argparse.ArgumentParser(description="Заметки встречи")
parser.add_argument("--title", required=True)
parser.add_argument("--date", dest="day", default=date.today().isoformat())
parser.add_argument("--attendees", default="")
parser.add_argument("--agenda", default="")
parser.add_argument("--facilitator", default="")
parser.add_argument("--output", type=Path)
parser.add_argument("--force", action="store_true")
args = parser.parse_args()
try:
day = date.fromisoformat(args.day)
except ValueError:
parser.error("Дата указывается в формате YYYY-MM-DD")
if not args.title.strip():
parser.error("Название встречи пустое")
output = args.output.expanduser() if args.output else Path("meetings") / f"{day.isoformat()}-{slugify(args.title)}.md"
if output.exists() and not args.force:
parser.error(f"Файл уже существует: {output}. Добавьте --force.")
output.parent.mkdir(parents=True, exist_ok=True)
output.write_text(build_notes(args, day), encoding="utf-8")
print(f"Заметки сохранены: {output}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.