agent-product-design — скилл для Claude Code: дизайн ИИ-продуктов
Скилл agent-product-design для Claude Code проектирует ИИ-агентов и интерактивные прототипы. Помогает превратить требование в рабочий сценарий с планом, проверками и контролем человека.
MIT ★ 6 467 обновлён 2026-11-16
npx skills add mdiri-ai/SoduWork --skill agent-product-design -a claude-codeЧто делает agent-product-design
Скилл превращает требования к ИИ-помощнику или агенту в описание продукта и кликабельный прототип. Он готовит requirements.md с пользователями, сценариями и критериями приёмки, agent-design.md с границами агента, инструментами и правами, а также prototype.html и заключение, связывающее критерии с видимыми результатами.
В прототипе описывается цикл задачи: планирование, выполнение шагов, запрос разрешения на контрольных этапах, проверка результата и передача материалов с подтверждениями. Нужно показать обычное завершение, нехватку данных или запрос доступа, а также сбой с повторной попыткой или передачей человеку. Для автономного HTML-прототипа взаимодействия моделируются локально; удалённые модели, CDN и рабочие корпоративные системы не вызываются.
Какие задачи решает
- описать требования и критерии приёмки для ИИ-агента
- показать пользователю план и текущий ход работы агента
- спроектировать запрос разрешения перед важным действием
- продемонстрировать сбой, повторный запуск и передачу задачи человеку
- связать критерии приёмки с элементами прототипа
Примеры запросов агенту
- Спроектируй ИИ-помощника для обработки заявок и опиши его границы, инструменты и контрольные этапы.
- Собери кликабельный HTML-прототип агента с обычным сценарием, запросом разрешения и обработкой сбоя.
- Подготовь критерии приёмки и покажи, где каждый из них виден в прототипе.
Как установить agent-product-design
1Через Skills CLI (Vercel)
npx skills add mdiri-ai/SoduWork --skill agent-product-design -a claude-code2Вручную: положить файлы
~/.claude/skills/agent-product-design/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/agent-product-design/
1Через Skills CLI (Vercel)
npx skills add mdiri-ai/SoduWork --skill agent-product-design -a codex2Вручную: положить файлы
.agents/skills/agent-product-design/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mdiri-ai/SoduWork --skill agent-product-design -a cursor2Вручную: положить файлы
.cursor/skills/agent-product-design/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mdiri-ai/SoduWork skills/agent-product-design2Вручную: положить файлы
.github/skills/agent-product-design/SKILL.md1Через Skills CLI (Vercel)
npx skills add mdiri-ai/SoduWork --skill agent-product-design -a gemini-cli2Командой платформы
gemini skills install https://github.com/mdiri-ai/SoduWork --path skills/agent-product-designВручную: положить файлы
.devin/skills/agent-product-design/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об agent-product-design
Как установить agent-product-design в Claude Code?
Выполни npx skills add mdiri-ai/SoduWork --skill agent-product-design -a claude-code. Файл скилла находится по пути ~/.claude/skills/agent-product-design/SKILL.md.
Что делает agent-product-design?
Он помогает спроектировать ИИ-агента или рабочий процесс с участием человека: описывает требования, поведение агента и критерии проверки, затем задаёт структуру кликабельного прототипа.
Какие состояния должен показывать прототип agent-product-design?
Как минимум обычное завершение задачи, нехватку информации или запрос разрешения, а также сбой с повторной попыткой либо передачей человеку. Для автономного HTML-прототипа взаимодействия должны работать локально.
Исходный текст
SKILL.md · MIT
--- name: agent-product-design description: Design enterprise agent products and interactive prototypes that make goals, plans, tool use, evidence, permissions, human gates, recovery, and final delivery understandable and controllable. Use when turning a requirement into an AI assistant, autonomous agent, human-AI workflow, agent workspace, or clickable agent-product prototype. --- # Agent Product Design Design the work system, not a chatbot shell. Make the user understand what the agent is doing, why it is allowed to do it, what evidence proves completion, and where a human remains in control. ## Deliverables Produce these artifacts: 1. requirements.md — users, jobs, scope, scenarios, information architecture, exceptional states, and testable acceptance criteria. 2. agent-design.md — the agent contract, autonomy, tools, memory, gates, evidence, recovery, and evaluation. 3. prototype.html — a self-contained clickable prototype that demonstrates the core work loop. 4. A review conclusion that maps every acceptance criterion to visible evidence. Do not substitute a feature list, dashboard, static landing page, or chat mockup for an agent product. ## Work from outcome to interaction ### 1. Define the work State: - Who requests the work and who receives the result. - The business outcome, not merely the requested screen. - Inputs, attachments, systems, constraints, and sensitive data. - The completion standard and evidence a reviewer can inspect. - What remains outside the first deliverable. If the input is incomplete, choose the smallest reversible assumption and record it. Do not invent integrations, credentials, data, or production capability. ### 2. Define the agent contract For each agent role, specify: - Mission and boundaries. - Inputs and normalized working context. - Plan and progress representation. - Allowed tools, data sources, Skills, and MCP connections. - Permission mode: read-only, confirm before change, or pre-authorized action. - Memory scope and retention. - Human gates and escalation conditions. - Evidence captured for each consequential action. - Retry, resume, cancellation, and rollback behavior. - Final deliverable and quality evaluation. Prefer MCP or APIs, then browser automation, then computer control. Never imply a tool exists when it is not configured. ### 3. Design the visible work loop Use one coherent lifecycle: 1. Understand the request. 2. Form or update a plan. 3. Execute visible steps. 4. Ask for permission only at real gates. 5. Verify against completion criteria. 6. Deliver results and evidence. 7. Capture feedback for future improvement. The primary surface is the current task or conversation. Keep secondary details progressive: - Show short narrative updates at meaningful stage changes. - Collapse commands, reads, writes, and browser actions into compact activity rows. - Let users inspect details without flooding the main conversation. - Keep the active plan and current step visible. - Present files as direct links and runnable web results in a preview surface. - Separate evidence from marketing claims. ### 4. Prototype real states The prototype must include deterministic local interactions for at least: - A normal end-to-end completion. - Missing information or a permission gate. - Tool or validation failure followed by retry or human takeover. Also cover loading, empty, paused, cancelled, and completed states where relevant. A button must change meaningful state; decorative controls do not count as interaction. For a self-contained HTML prototype, simulate the agent locally with an explicit state machine. Label external integrations as prototype simulations. Do not call remote models, CDNs, or live enterprise systems. ### 5. Establish a product-specific visual system Use the actual domain, users, artifacts, vocabulary, and risk level to choose layout, type, color, density, and motion. Avoid generic AI gradients, oversized empty cards, decorative robot imagery, and a dashboard made from interchangeable tiles. Give the product one clear visual signature. Keep body text readable, controls consistent, keyboard focus visible, contrast sufficient, and motion respectful of reduced-motion preferences. Check desktop and narrow layouts. ## Quality gate Reject the result if any statement is true: - The product is only a chat box with canned replies. - Users cannot see the active goal, plan, progress, or completion standard. - Tool use is hidden or dumped as unstructured logs. - Permissions and human gates are absent or decorative. - Results lack inspectable files, evidence, or validation. - Failure, retry, resume, and handoff are not represented. - The prototype claims real integrations it does not have. - The main scenario cannot be completed by clicking through the prototype. - The visual design could be reused unchanged for an unrelated product. Before delivery, run the main, gate, and failure paths; inspect the rendered page; and map every acceptance criterion to an observable state or artifact.
© mdiri-ai · MIT · mdiri-ai/SoduWork