К основному содержанию
скилл CX Codex

psi — скилл для Claude Code: планирование и установка

psi ведёт разработку через план, спецификацию и реализацию с тестами. Скилл запускается только по прямой просьбе или по упоминанию в AGENTS.md.

MIT 144 установок ★ 22 обновлён 2026-03-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add siviter-xyz/dot-agent --skill psi -a claude-code
Открыть на GitHub

Что делает psi

psi делит работу на этапы Plan, Spec и Implement. План и исследование сохраняются в ~/.dot-agent/, а спецификации пополняют docs/, файлы README.md и AGENTS.md. Этапы можно запускать отдельно, но каждый должен поддерживать документацию в актуальном состоянии.

При реализации скилл предлагает сначала подготовить тесты для документации и пользовательских сценариев, затем проверить типы, тесты и линтер перед коммитом. Связанные изменения группируются в атомарные коммиты, документы обновляются по мере изменения кода. Автоматически psi не запускается: для работы нужно явно попросить об этом или упомянуть скилл в AGENTS.md.

Какие задачи решает

  • составить план изменения и сохранить исследование отдельно от репозитория
  • описать API, модели данных и пользовательские сценарии в документации
  • начать реализацию с тестов для документации и пользовательских сценариев
  • проверить типы, тесты и линтер перед коммитом

Примеры запросов агенту

  • Используй скилл psi, чтобы спланировать добавление экспорта данных.
  • Запусти этап Spec в psi и опиши новый API в документации.
  • Примени этап Implement из psi: сначала подготовь тесты, затем внеси изменения.

Как установить psi

1Через Skills CLI (Vercel)

npx skills add siviter-xyz/dot-agent --skill psi -a claude-code

2Вручную: положить файлы

~/.claude/skills/psi/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/psi/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о psi

Как установить psi в Claude Code?

Выполните npx skills add siviter-xyz/dot-agent --skill psi -a claude-code. Файл скилла появится по пути ~/.claude/skills/psi/SKILL.md.

Что делает скилл psi?

Он организует разработку по этапам Plan, Spec и Implement: сохраняет планы отдельно, добавляет спецификации в документацию и ведёт реализацию через тесты.

Запускается ли psi автоматически?

Нет. Используйте его, только если пользователь попросил об этом напрямую или скилл упомянут в проектном AGENTS.md.

Исходный текст

SKILL.md · MIT
---
name: psi
description: Plan-spec-implement workflow for structured development. Only use when explicitly directed by user or when mentioned in project AGENTS.md file. Generates ephemeral plans in ~/.dot-agent/, applies specs to project docs, then implements test-first.
license: MIT
---

# PSI - Plan Spec Implement

Structured workflow for planning, specifying, and implementing changes with documentation-first approach.

## When to Use

**Only use when:**
- Explicitly directed by the user
- Mentioned in project `AGENTS.md` file

**Do not use automatically** - this is an opt-in workflow, not a default.

## Core Workflow

**Plan → Spec → Implement**

Phases are **independent** - you can start with any phase, but all must ensure documentation stays up-to-date.

## Key Principles

1. **Ephemeral planning** - Plans stored in `~/.dot-agent/` (not committed)
2. **Documentation-first** - Specs applied to project docs/READMEs/AGENTS.md
3. **Test-first implementation** - Tests for docs/user journeys before code
4. **Design/review embedded** - Design and review integrated into Plan/Spec phases
5. **Phase independence** - Each phase can work standalone, all update docs

## Phase Overview

### Plan Phase
- Generates detailed plans in `~/.dot-agent/repo/YYYY-MM-work-name.plan.md`
- Research stored in `~/.dot-agent/working-dir/repo/YYYY-MM-work-name.research.md`
- Embeds design considerations
- Includes review before proceeding

### Spec Phase
- Generates specs for: API schemas, interfaces, DTOs, database models, config, env vars, architecture, user journeys, package structure, tech choices
- Embeds design considerations
- Reviews specs before applying
- Applies to: `docs/`, README.md files, AGENTS.md files

### Implement Phase
- Test-first: tests for docs/user journeys before code
- CI verification: verify types, tests, lint pass before committing
- Atomic commits: group related changes with tests
- Updates docs, README.md, AGENTS.md as code evolves
- Can work independently if specs exist in docs

## Research Management

Detects phrases like:
- "looking at your research" → Loads research file
- "refine your research" → Updates research file, narrows focus

## Documentation Structure

- **README.md**: Aim for < 1000 lines (not hard rule), can be longer if needed
- **AGENTS.md**: < 200 lines, inline at root/packages/modules/code level
- **docs/**: Architecture, roadmap, tech-choices, setup/, user-journeys/, design/

## References

For detailed protocols, see:
- `references/plan-phase.md` - Plan generation with embedded design/review
- `references/spec-phase.md` - Spec generation and application
- `references/implement-phase.md` - Test-first implementation
- `references/review-protocol.md` - Reviewing plans/specs/design
- `references/research-management.md` - Research file handling
- `references/docs-structure.md` - Documentation organization rules
- `references/file-paths.md` - Storage paths and conventions

© siviter-xyz · MIT · siviter-xyz/dot-agent

Похожие скиллы

Каталог скиллов SKILL.md →
find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок grill-me Matt Pocock Скилл grill-me проводит жёсткое интервью по плану или дизайну, чтобы найти пробелы и уточнить решения. Подойдёт перед началом разработки. CX Codex +1 1 424 476установок grill-with-docs Matt Pocock Скилл grill-with-docs проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. CX Codex +1 1 219 756установок

Из того же набора11

Весь набор →
software-engineer Скилл software-engineer задаёт агенту правила стиля кода, документации и рабочего процесса: без лишних комментариев, без самовольных git-коммитов, с вопросами при неясностях. CX Codex +1 637установок python Задаёт единый стиль Python: типизация, внедрение зависимостей, структура тестов и модулей. Держит код в одном порядке при правках в существующем проекте. CX Codex +1 353установок create-agents-md Скилл create-agents-md помогает составить файл AGENTS.md с точечными правилами для репозитория. Пригодится при настройке стиля кода, команд сборки и ограничений для ИИ-агентов. CX Codex +1 306установок typescript Скилл typescript для Claude Code задаёт стандарты написания и изменения кода на TypeScript. Активируется при работе с файлами TypeScript и TypeScript React. CX Codex +1 239установок cli-building Скилл cli-building задаёт правила создания консольных утилит: асинхронный ввод-вывод, модульная композиция команд и форматирование терминального вывода с учётом NO_COLOR. CX Codex +1 201установок semantic-git Скилл semantic-git для Claude Code группирует связанные изменения в атомарные коммиты и оформляет сообщения в Conventional Commits. Готовит изменения к коммиту. CX Codex +1 201установок debugging Скилл debugging для Claude Code пошагово ищет первопричину сбоев и ошибок в коде. Помогает локализовать баг и подготовить минимальное исправление. CX Codex +1 151установок media-processing Скилл media-processing для Claude Code автоматизирует пакетную обработку медиа: сжатие видео, ресайз картинок и конвертацию аудио через FFmpeg и ImageMagick. CX Codex +1 151установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой