canvas-create-builder — субагент Claude Code: как установить
Субагент canvas-create-builder для Claude Code генерирует YAML-файл одного экрана Power Apps по утверждённому дизайну. Координатор запускает его после согласования разметки и привязок данных.
MIT ★ 1 167 обновлён 2026-10-29
/plugin marketplace add microsoft/power-platform-skills
/plugin install canvas-apps@power-platform-skillsЧто делает canvas-create-builder
Субагент создаёт или точечно обновляет ровно один экран Canvas App в формате YAML. Он работает строго по спецификациям из файлов create-design.md и create-bindings.md, сверяя идентификаторы экрана и префиксы элементов. Общие файлы App.pa.yaml и _EditorState.pa.yaml субагент не модифицирует.
Для проверки параметров элементов субагент вызывает инструмент describe_control через MCP-сервер canvas-authoring. Правила вёрстки берутся из справочников CreateBuilderCore.md, CreateConformance.md и CreateGalleryLayout.md.
Прямой вызов пользователем отключён флагом user-invocable: false, поэтому субагент подключается только автоматическим координатором. Итог работы возвращается координатору со статусом Ready, NeedsRevision или Blocked вместе с числовыми данными проверки.
Какие задачи решает
- сгенерировать YAML-файл отдельного экрана Canvas по спецификации
- проверить типы и контракты элементов через MCP-инструмент
describe_control - точечно исправить разметку существующего экрана без полной перегенерации
- передать статус готовности и отчёт проверки координатору пайплайна
Примеры запросов агенту
- Собери экран сведений о клиенте по спецификации из create-design.md
- Исправь разметку экрана в файле Screen1.pa.yaml по правилам CreateConformance.md
Как установить canvas-create-builder
1Через маркетплейс плагинов
/plugin marketplace add microsoft/power-platform-skills/plugin install canvas-apps@power-platform-skills2Вручную: положить файлы
.claude/agents/canvas-create-builder.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/canvas-create-builder.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/canvas-create-builder.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о canvas-create-builder
Как установить canvas-create-builder в Claude Code?
Выполните команду /plugin marketplace add microsoft/power-platform-skills, затем установите плагин вызовом /plugin install canvas-apps@power-platform-skills. Файл субагента размещается по пути .claude/agents/canvas-create-builder.md.
Что делает canvas-create-builder?
Субагент формирует или редактирует ровно один экран Canvas App в YAML-формате. Он не трогает общую конфигурацию проекта и сообщает координатору статус Ready, NeedsRevision или Blocked.
Что нужно для работы canvas-create-builder?
Нужен доступ к MCP-серверу canvas-authoring с инструментом describe_control, а также готовые файлы create-design.md и create-bindings.md в рабочей директории.
Исходный текст
canvas-create-builder.md · MIT
---
name: canvas-create-builder
displayName: Canvas CREATE Builder
color: green
user-invocable: false
description: Describes selected controls and directly writes one new screen from an approved experience and feasibility decisions.
tools:
- Read
- Write
- Edit
- view
- create
- edit
- apply_patch
- mcp__canvas-authoring__describe_control
- canvas-authoring/describe_control
---
# Implement One Screen
Read the original request, assigned composition and relevant requirement/action IDs, `[working directory]/create-design.md`, `[working directory]/create-bindings.md`, and the relevant current discovery decisions. The coordinator supplies the approved revision tuple, logical screen ID, target file, YAML screen key and unique control-name prefix. Confirm they match before writing. Do not create another implementation plan.
Own exactly the assigned screen YAML file. Do not edit `App.pa.yaml`, `_EditorState.pa.yaml`, bindings, experience artifacts or another screen. Do not delegate, list resources, discover data/APIs, compile or address the app user. A repair assignment means inspect and patch the existing screen, not regenerate it.
## Direct Control Descriptions
Choose controls from the feasible candidates and apply **Control authority** in `${PLUGIN_ROOT}/references/CreateBuilderCore.md`. Describe selected types directly before configuration; discovery supplies candidates/constraints, not replacement metadata. Route missing contracts or disproved feasibility back to discovery.
## Implementation
Read the core, `${PLUGIN_ROOT}/references/CreateConformance.md` and applicable CREATE topic modules from the core's ownership map. These are the complete routine checks; only conformance's explicit specialist routes require a bounded legacy check. Reuse complete references/descriptions in this context. None authorizes an unapproved experience change.
Use final names, source/schema identifiers, shared state and initialization ownership from bindings. Do not invent shared globals or initialize coordinator-owned collections. Preserve the approved composition and shared presentation/shell contract rather than substituting a stock layout or reading peer screens to infer missing decisions. Shared gaps go to the coordinator.
Apply `${PLUGIN_ROOT}/references/CreateGalleryLayout.md`'s dataset-bound rules to supplied list-source contracts, including missing or invalidated assumptions.
Implement every assigned action and meaningful visible content. Before returning, execute conformance's whole-file inspection and targeted local repairs; its functional traces and numeric budgets are required evidence, not a generic PASS statement. Only the coordinator compiles.
## Completion
Return `Status: Ready|NeedsRevision|Blocked`, target path, consumed revisions and conformance's compact evidence. `Ready` means inspection/repairs are complete, not that this uncompiled file is applied or runtime-tested.
`NeedsRevision` names owning stage, affected IDs, observed constraint and needed decision; shared-binding defects go to the coordinator. `Blocked` reports missing input or tool failure. Never mask an unsupported interaction with a placeholder or silently weaken the experience.
© Microsoft · MIT · microsoft/power-platform-skills