notion-tasks — скилл для Claude Code: задачи Notion и установка
Скилл notion-tasks помогает находить задачи и спринты команды Oak AI в Notion, фильтровать их по статусу и проверять приоритеты.
MIT 1 установок ★ 35 обновлён 2026-10-28
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a claude-codeЧто делает notion-tasks
Скилл ищет текущий спринт, затем связанные с ним задачи; можно также отобрать задачи со статусом «In progress», «Ready» или «Ready for review». Он помогает понять, кто ведёт задачу и на каком она этапе. Для запросов доступны инструменты Notion API.
Чтобы связать запросы с базами, нужны их ID в config.local.md; пример формата лежит в config.local.md.example. Фильтр filter_properties сокращает объём ответа, а для него можно задать размер страницы от 50 до 100. Без ID баз в config.local.md скилл не сможет адресовать нужные данные Notion.
Скилл также поясняет статусы: например, Blocked означает, что работе мешают зависимости, а Ready for review — что код ждёт проверки. Эти значения помогают отличить задачи, которые можно брать в работу, от тех, которым сначала нужна оценка или планирование.
Какие задачи решает
- найти задачи текущего спринта
- отобрать задачи по статусу
- проверить, кто отвечает за задачу
- разобраться в значении статуса задачи
Примеры запросов агенту
- Найди задачи текущего спринта и покажи их статусы.
- Покажи задачи со статусом
Ready for reviewи ответственных за них. - Объясни, какие задачи в бэклоге ещё требуют планирования.
Как установить notion-tasks
1Через Skills CLI (Vercel)
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a claude-code2Вручную: положить файлы
~/.claude/skills/notion-tasks/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/notion-tasks/
1Через Skills CLI (Vercel)
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a codex2Вручную: положить файлы
.agents/skills/notion-tasks/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a cursor2Вручную: положить файлы
.cursor/skills/notion-tasks/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oaknational/oak-ai-lesson-assistant .claude/skills/notion-tasks2Вручную: положить файлы
.github/skills/notion-tasks/SKILL.md1Через Skills CLI (Vercel)
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a gemini-cli2Командой платформы
gemini skills install https://github.com/oaknational/oak-ai-lesson-assistant --path .claude/skills/notion-tasksВручную: положить файлы
.devin/skills/notion-tasks/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о notion-tasks
Как установить notion-tasks в Claude Code?
Выполните npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a claude-code. Файл скилла находится по пути ~/.claude/skills/notion-tasks/SKILL.md.
Что делает notion-tasks?
Он помогает запрашивать задачи и спринты Oak AI в Notion, фильтровать задачи по статусу и разбираться в приоритетах команды.
Что нужно подготовить для работы notion-tasks?
ID баз Notion нужно добавить в config.local.md. Для формата можно свериться с config.local.md.example.
Исходный текст
SKILL.md · MIT
---
name: notion-tasks
description: Query and manage Oak AI squad tasks and sprints in Notion. Use when checking current sprint, finding tasks by status, updating task information, or understanding team priorities and workload.
allowed-tools: mcp__notionApi__API-post-database-query, mcp__notionApi__API-retrieve-a-page, mcp__notionApi__API-get-block-children
---
# Notion Task Management
## Setup
Database IDs are stored in `config.local.md` (not checked into git). See `config.local.md.example` for the required format.
## Finding Current Sprint Tasks
1. **Find current sprint**: Query sprints database with filter:
```json
{ "property": "Sprint status", "status": { "equals": "Current" } }
```
2. **Get sprint ID** from the result (e.g., `13d26cc4-e1b1-8108-9fb3-d74429e520c6`)
3. **Query tasks** with filter:
```json
{ "property": "Sprint", "relation": { "contains": "SPRINT_ID" } }
```
## Efficient Querying with filter_properties
- **Essential fields**: `["title", "pPPj", "FH@y", "RIV<", "pIdo"]`
- These map to: Task, Status, Who, Type, ID
- **Use filter_properties**: Reduces response size significantly
- **Page size**: Can use 50-100 when filtering properties
**Example query:**
```json
{
"database_id": "TASKS_DB_ID",
"filter": {
"property": "Sprint",
"relation": { "contains": "SPRINT_ID" }
},
"filter_properties": ["title", "pPPj", "FH@y", "RIV<", "pIdo"],
"page_size": 50
}
```
## Common Task Filters
- **In progress**: `{"property": "Status", "status": {"equals": "In progress"}}`
- **Ready tasks**: `{"property": "Status", "status": {"equals": "Ready"}}`
- **Ready for review**: `{"property": "Status", "status": {"equals": "Ready for review"}}`
- **Current sprint tasks**: First get current sprint ID, then filter by Sprint relation
## Task Status Meanings
- **Ready**: Available to pick up and start development
- **Backlog**: Not ready for development yet, needs planning/refinement
- **Candidate**: Being evaluated, not ready for development
- **Triage**: Needs assessment before development
- **In progress**: Currently being worked on
- **Ready for review**: Code complete, awaiting review
- **Merged**: Code merged to main branch
- **Done**: Task completed
- **Blocked**: Cannot proceed due to dependencies
© oaknational · MIT · oaknational/oak-ai-lesson-assistant