port-spec — скилл для Claude Code: что делает и как установить
Скилл port-spec для Claude Code переносит полную письменную спецификацию в код или артефакт хранилища. Он включается при реализации спецификации или сборке по брифу.
MIT ★ 26 обновлён 2026-11-16
npx skills add wrg32786/aigent-os --skill port-spec -a claude-codeЧто делает port-spec
port-spec переносит письменную спецификацию в работающий код, конфигурацию или артефакт хранилища. Он подходит для схем, моделей данных, контрактов API и структуры заметок. Перед изменениями скилл читает целевые файлы и ищет связанные типы, импорты и зависимости.
Работа идёт строго в пределах брифа. Если требование неоднозначно, скилл задаёт один уточняющий вопрос; если задача выходит за границы спецификации, останавливается и сообщает, что осталось. После каждой работы он выдаёт отчёт с изменёнными и нетронутыми файлами, замеченными проблемами, неопределённостью, компромиссами и остановленной частью задачи.
Какие задачи решает
- перенести схему данных из спецификации в код
- реализовать контракт API по письменному брифу
- создать артефакт хранилища по описанной структуре
- обозначить работу, оставшуюся за пределами спецификации
Примеры запросов агенту
- Перенеси эту спецификацию в код проекта.
- Реализуй контракт API по этому брифу.
- Создай артефакт хранилища по описанной структуре.
Как установить port-spec
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill port-spec -a claude-code2Вручную: положить файлы
~/.claude/skills/port-spec/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/port-spec/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill port-spec -a codex2Вручную: положить файлы
.agents/skills/port-spec/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill port-spec -a cursor2Вручную: положить файлы
.cursor/skills/port-spec/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wrg32786/aigent-os skills/port-spec2Вручную: положить файлы
.github/skills/port-spec/SKILL.md1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill port-spec -a gemini-cli2Командой платформы
gemini skills install https://github.com/wrg32786/aigent-os --path skills/port-specВручную: положить файлы
.devin/skills/port-spec/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill port-spec -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о port-spec
Как установить port-spec в Claude Code?
Выполни npx skills add wrg32786/aigent-os --skill port-spec -a claude-code. Файл скилла находится по пути ~/.claude/skills/port-spec/SKILL.md.
Что делает port-spec?
Он переносит полную письменную спецификацию в код, конфигурацию или артефакт хранилища. Перед записью читает целевые файлы и связанные участки проекта, а после работы выдаёт отчёт о сделанных изменениях и оставшихся вопросах.
Как port-spec поступает с неоднозначностями и выходом за рамки брифа?
При неоднозначности он задаёт один уточняющий вопрос. Если работа выходит за границы спецификации, скилл останавливается и сообщает, что осталось сделать.
Исходный текст
SKILL.md · MIT
--- name: port-spec agent: lyra description: "Turn a complete written specification into working code or a vault artifact. Use when implementing a spec, building from a brief, or porting a spec to code." allowed-tools: Read, Write, Edit, Bash, Grep, Glob, Agent user-invocable: true triggers: - port this spec - implement this spec - build from spec - port spec - implement from brief - execute this brief - build this - port to code --- # Port Spec You are Lyra executing a bounded port from a written specification to a working artifact. ## What this skill does Take a complete specification (schema, data model, API contract, vault note structure, or component design) and port it into working code, config, or a vault artifact. No strategy. No scope expansion. Build what the spec says, return what changed. ## Protocol ### Step 1: Confirm scope (one sentence) Read back the spec in one sentence. Example: "Porting the User schema from the spec into a TypeScript interface at `src/types/user.ts`." If anything is ambiguous, ask ONE focused question. Then build without further interruption. ### Step 2: Read the target Before writing a single line: - Read the target file(s) if they exist - Grep for related types, imports, or dependencies - Understand what's already there ### Step 3: Build Execute the port exactly as specified. Stay within scope. If the work expands beyond the brief, STOP and surface it — do not build unilaterally. ### Step 4: Return honesty ledger ``` ## Honesty Ledger **Changed:** <list of files modified or created> **Untouched:** <files read but not changed> **Noticed-not-fixed:** <issues seen but out of scope> **Residual uncertainty:** <anything you had to guess> **Tradeoffs:** <decisions made where alternatives exist> **Stopped-short:** <scope boundary hit — what's left> ``` ## Constraints - Read before writing. Always. - One clarifying question allowed, then ship. - Scope creep surfaces back to the composer — never expands unilaterally. - Honesty ledger is non-negotiable on every delivery.
© wrg32786 · MIT · wrg32786/aigent-os