# openspec-archiving

Переносит закрытые изменения в архив и встраивает дельты спецификаций в актуальную документацию проекта после релиза.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 установок · ★ 10
- Автор: forztf
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/forztf/open-skilled-sdd/tree/HEAD/skills/openspec-archiving/SKILL.md
- Обновлён: 2025-11-28
- HTML: https://affpapa.org/nevibecode/skills/openspec-archiving

## Что делает

Скилл автоматизирует перенос готовых задач из папки `spec/changes/` в каталог `spec/archive/` с датой в названии. Перед переносом он проверяет наличие маркера `IMPLEMENTED`, статус задач в `tasks.md` и чистоту рабочей копии через `git status`. Без этих проверок архивацию запускать нельзя.

Затем агент разбирает дельты требований по блокам `ADDED`, `MODIFIED` и `REMOVED`. Новые пункты дописываются в конец файлов внутри `spec/specs/`. Изменённые секции перезаписываются целиком, а удалённые сценарии снабжаются комментариями. В конце директория задачи удаляется из активного списка, а структура документации валидируется поиском по заголовкам.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/openspec-archiving/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/openspec-archiving/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/openspec-archiving/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/openspec-archiving/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install forztf/open-skilled-sdd openspec-archiving
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/openspec-archiving/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/forztf/open-skilled-sdd --path skills/openspec-archiving
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/openspec-archiving/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/forztf/open-skilled-sdd/tree/HEAD/skills/openspec-archiving/SKILL.md

## Когда брать
- перенести закрытую задачу из `spec/changes/` в датированный архив
- дописать добавленные требования из дельт в спецификации проекта
- заменить отредактированные блоки требований в актуальных файлах
- задокументировать удаление устаревших сценариев комментариями

## Примеры запросов агенту
- Архивируй завершённое изменение `add-user-auth` и обнови спецификации
- Проверь готовность задачи `payment-gateway` и перенеси её дельты в основные спеки
- Смержи дельты требований из папки изменений в актуальную документацию

## Похожие
- [update-docs](https://affpapa.org/nevibecode/commands/update-docs.md) — команда · 3861 установка
- [openspec-sync-specs](https://affpapa.org/nevibecode/skills/openspec-sync-specs.md) — скилл · 3800 установок
- [spec-workflow](https://affpapa.org/nevibecode/skills/spec-workflow.md) — скилл · 1200 установок
- [spec](https://affpapa.org/nevibecode/skills/spec.md) — скилл · 4100 установок
- [openspec-archive-change](https://affpapa.org/nevibecode/skills/openspec-archive-change.md) — скилл · 4000 установок
- [openspec](https://affpapa.org/nevibecode/skills/openspec.md) — скилл · 840 установок

Из того же набора: [forztf/open-skilled-sdd](https://affpapa.org/nevibecode/by/forztf/open-skilled-sdd.md) — 4 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md