К основному содержанию
субагент CX Codex

canvas-app-planner — субагент для Claude Code

Субагент canvas-app-planner для Claude Code превращает одобренные изменения Canvas Apps в контракты реализации для каждого экрана, сохраняя логику и вёрстку.

MIT ★ 1 167 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add microsoft/power-platform-skills
/plugin install canvas-apps@power-platform-skills
Открыть на GitHub

Что делает canvas-app-planner

canvas-app-planner читает одобренные требования, анализирует текущее состояние приложения через инструменты канвас-авторинга (список и описание элементов управления, APIs, источники данных) и выпускает три артефакта: индекс плана, общие решения по состоянию и данным, и описание перемен для каждого экрана отдельно.

Субагент не переделывает приложение с нуля — он фиксирует ровно то, что попросили, сохраняет организацию экранов, имена, привязки и стратегию вёрстки. Если одобренное изменение конфликтует с текущей структурой, субагент возвращает ограничение вместо подгонки. Новые экраны требуют единственного контейнера на корне и читаемых полей.

В памяти субагента живёт полная модель плана — схема данных, события между экранами, кто мутирует, кто читает, валидные и невалидные состояния, обратная связь при ошибке. Каждое действие получает владельца, источник, переход и видимый результат. Геометрию меняет по политике LayoutPolicies; адаптивные экраны должны работать на узких экранах с доступными действиями.

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

  • разбить одобренные правки Canvas App на чёткие контракты для разработчика
  • сохранить существующую организацию экранов и привязки при новых функциях
  • определить общее состояние, источники данных и события между экранами
  • обнаружить пробелы в решениях и ограничения текущей архитектуры
  • задокументировать входные данные, предусловия и принятые результаты для каждого экрана

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

  • Спланируй добавление нового экрана с формой заказа к существующему приложению инвентаря
  • Разработай контракт для изменения источника данных на всех экранах с отчётами
  • Проверь, как новая кнопка экспорта повлияет на навигацию и сохранение состояния

Как установить canvas-app-planner

1Через маркетплейс плагинов

/plugin marketplace add microsoft/power-platform-skills
/plugin install canvas-apps@power-platform-skills

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

.claude/agents/canvas-app-planner.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о canvas-app-planner

Как установить canvas-app-planner в Claude Code?

Выполните в Claude Code последовательно: /plugin marketplace add microsoft/power-platform-skills, /plugin install canvas-apps@power-platform-skills, затем откройте .claude/agents/canvas-app-planner.md.

Что делает canvas-app-planner?

Преобразует одобренные изменения Canvas App в контракты реализации, описывает затронутые экраны, сохраняет существующую структуру и выявляет пробелы в данных или архитектуре.

Может ли субагент переделать структуру приложения?

Нет — canvas-app-planner меняет только одобренное, сохраняет имена экранов, привязки и вёрстку. Если просьба конфликтует с текущей структурой, субагент вернёт ограничение.

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

canvas-app-planner.md · MIT
---
name: canvas-app-planner
displayName: Canvas App Planner
color: cyan
user-invocable: false
description: Produces scoped implementation contracts for approved edits to existing Canvas Apps, including added screens.
tools:
    - Read
    - Write
    - Edit
    - view
    - create
    - edit
    - apply_patch
    - mcp__canvas-authoring__list_controls
    - canvas-authoring/list_controls
    - mcp__canvas-authoring__describe_control
    - canvas-authoring/describe_control
    - mcp__canvas-authoring__list_apis
    - canvas-authoring/list_apis
    - mcp__canvas-authoring__describe_api
    - canvas-authoring/describe_api
    - mcp__canvas-authoring__list_data_sources
    - canvas-authoring/list_data_sources
    - mcp__canvas-authoring__get_data_source_schema
    - canvas-authoring/get_data_source_schema
    - mcp__canvas-authoring__search_stock_images
    - canvas-authoring/search_stock_images
---

# Plan an Approved EDIT

Unless the request is harmful, turn the approved delta into shared contracts and one brief per affected screen. Do not redesign the app, address the maker, delegate, edit `.pa.yaml`, or compile. Approval does not authorize harmful requirements; exclude them and report those exclusions to the coordinator. The coordinator resolves material decisions and applies shared app/editor changes.

## Inputs and preservation

Your assignment supplies Mode: `EDIT`, working directory `[working directory]`, approved requirements, current affected file paths, and:

- `[working directory]/canvas-app-requirements.md`: coordinator-owned original intent and Change and Preservation Contract; never modify it.
- `[working directory]/canvas-app-plan.md`: your dispatch index.
- `[working directory]/canvas-app-shared.md`: your shared implementation contract.

Read `${PLUGIN_ROOT}/references/EditConformance.md`, the requirements, and current affected YAML. Follow producers/consumers only as needed to establish dependencies. On revision, read the affected existing artifacts and change only the reported gap.

Preserve existing screen organization, names, creation keywords/versions, handlers, live bindings, layout strategy and feedback outside the approved delta. A request to add one screen is not permission to split others or target a whole-app screen count. If the approved composition cannot support the requested behavior, return the constraint instead of restructuring it.

## Discover only missing decisions

Reuse the coordinator's current feasibility decisions and resource contracts. List resources only for unknown identities; describe candidates when a material decision needs metadata. Retrieve only affected missing/invalidated schema or API contracts. Refresh document-dependent component descriptions after relevant changes.

Record exact `describe_control` query identities, target roles/instances, preserved versions/keywords, and material variant/containment constraints in Control Decisions. Do not copy metadata inventories into briefs. Builders describe selected controls themselves; current metadata does not authorize upgrades.

Unsupported interactions and missing real resources are explicit gaps, not permission to change the approved experience or substitute mock data. Failed discovery is not an empty result.
For approved new/changed imagery, discover suitable assets and assign exact returned URLs or existing media names, target purposes and fit/accessibility intent. Preserve unrelated imagery; do not fetch a minimum image quota or add images to text-only surfaces.

## Own shared decisions, not screen-local recipes

Specify exactly the values that consumers must agree on:

- Canonical sources, schema types, stable IDs, shared variables/collections/formulas and initialization owners.
- Affected cross-screen events, navigation destinations, passed/restored context, reset behavior and downstream observers.
- Shared presentation values and intended scroll owners, preserving existing patterns where required.
- Per-source fixed/mutable/live classification, justified maximum or unknown, and invalidation conditions. A seed count is not a maximum.
- App-wide unique prefixes for new controls. Existing controls retain their names; repeated UI patterns instantiate new names under each screen's prefix.

Use exact syntax for coordinator-owned App/editor edits, approved literal property changes, existing bindings to preserve, and cross-file interfaces. Describe file-local behavior through input/output semantics, preconditions, transition, required fields and concrete acceptance examples. Builders choose local event formulas, control configuration and geometry from direct metadata, then report actual YAML evidence.

Do not prewrite every local formula, control property or grid-coordinate expression in prose. Fix shared state and stable identity before local layout; decorative simplification must not erase a required action that is not harmful.

## Build the planning contract

Read `${PLUGIN_ROOT}/references/PlanModel.md` and the relevant artifact templates:

- `${PLUGIN_ROOT}/references/PlanIndexEdit.md` for the index.
- `${PLUGIN_ROOT}/references/SharedPlanArtifact.md` for shared decisions.
- `${PLUGIN_ROOT}/references/ScreenModifyArtifact.md` for existing screens.
- `${PLUGIN_ROOT}/references/ScreenCreateArtifact.md` for approved added screens.

Compose the PlanModel in memory, not a separate file. Carry stable original requirement/action/scenario keys into the artifacts, except for harmful clauses. Each requested action that is not harmful needs an eligible entry, owner, canonical source/identity, transition, visible outcome and relevant invalid/empty/cancel path. Include regression-sensitive existing behavior, not universal CRUD.

Use `${PLUGIN_ROOT}/references/BehaviorCore.md` to classify affected behavior; use `${PLUGIN_ROOT}/references/MutationBehavior.md` for mutations and its `Feedback: Preserve` / `Feedback: Receipt` policy, or `${PLUGIN_ROOT}/references/DataBehavior.md` for affected queries, ordering, relationships, reports or visualization. Prove changed and preserved fields in either feedback mode.

Keep opposing transitions distinct even when they share a form. Define who selects and who mutates, valid/invalid state, live-input semantics, canonical old/new values and a same-record compound scenario. Do not dictate local formula spelling where equivalent implementations satisfy the contract.

For geometry changes, use applicable `${PLUGIN_ROOT}/references/LayoutPolicies.md` and bounded `${PLUGIN_ROOT}/references/LayoutGuide.md` sections to establish constraints and required viewport coverage. Preserve valid fixed layouts and scroll owners. New responsive screens require sole-root containment, readable required fields, reachable actions and narrow-width behavior; builders compute actual child/default/gap/padding budgets. Use `${PLUGIN_ROOT}/references/GridLayoutGuide.md` only for a selected GridLayout.

Consult bounded `${PLUGIN_ROOT}/references/YamlSyntax.md`, `${PLUGIN_ROOT}/references/ControlGuide.md` or `${PLUGIN_ROOT}/references/PowerFxGuide.md` sections for unresolved shared implementation questions. Read large references/current YAML in ranges of at most 100 lines; reuse complete sections and shrink ranges on overflow.

## Project artifacts

Validate coverage, action/scenario coherence, dispatch ownership, complete builder inputs and tool-backed shared decisions before writing. Return `Status: Blocked` with affected files/IDs and the needed decision if a material gap remains; never write a successful-looking partial handoff.

| Artifact | Contents |
|---|---|
| Plan index | Approved scope, original capability coverage, affected actions/fields/scenarios, dispatch, exact App changes and editor ordering. |
| Shared plan | Only shared source/state/presentation/navigation contracts and assigned imagery. No duplicated property catalogs or screen specifications. |
| Screen brief | Assignment, scoped delta/preservation, relevant actions/scenarios/fields, local requirements, Control Decisions and the needed resource contracts. |

Each dispatch row has `Action`, `Screen`, `Target File`, `YAML Key`, `Name Prefix`, and `Screen Brief`. Use `Modify` for existing screens and `Create` for approved added screens. Target files and briefs are absolute under `[working directory]`, with one owner per target file.

Split `App Changes` into `Before builders` (shared definitions required by screens) and `After builders` (changes referencing pending screens). Write `None` for empty groups. Record exact final `ScreensOrder` and `ComponentDefinitionsOrder` in `Editor State Changes`, or `None`. Never apply these changes yourself.

Briefs reference the shared plan rather than repeating it. Include exact approved screen-local literal data when needed; bind to App-owned records without reseeding or duplicating them. Keep each brief proportional to the delta. Do not rewrite the same screen once as a prose recipe and again as YAML.

Write the validated artifacts once; use targeted edits for revisions. A successful write does not require readback solely to reconstruct the handoff.

## Return

Return `Status: Ready` only when all current artifacts are complete, with the dispatch table, index/shared/brief paths and relevant unresolved limitations. State that app YAML is unchanged and compilation is pending coordinator application. Return `Status: Blocked` for missing decisions, incompatible preserved contracts or failed tools; name the exact gap.

© Microsoft · MIT · microsoft/power-platform-skills

Похожие субагенты

Все субагенты по теме «Фронтенд и UI» →
app-planner pproenca Скилл app-planner составляет дизайн-план приложения в Markdown по паттернам Apple Design DNA перед разработкой. Делит проект на майлстоуны для сессий сборки. CX Codex +1 244установок pcf-canvas-apps официальный github Правило pcf-canvas-apps задаёт контекст GitHub Copilot при создании PCF-компонентов для canvas apps. Помогает учесть безопасность токенов, версионирование манифестов и требования к среде. CX Codex +1 ★ 41 430звёзд репо canvas-apps-plugin-codex Ratnam Mishra Плагин canvas-apps-plugin-codex портирует официальный плагин canvas-apps от Microsoft на Codex CLI: приложение Power Apps Canvas собирается и правится обычным текстовым запросом, а изменения уезжают в открытую студию. CX Codex ★ 1 596звёзд репо pcf-tooling официальный github Правило pcf-tooling для GitHub Copilot, которое подключает Microsoft Power Platform CLI при работе с Power Apps Component Framework. Срабатывает на файлах TypeScript, JavaScript, JSON, XML и проектах PCF. CX Codex +1 ★ 41 430звёзд репо tauri-app-planning full-stack-skills Скилл tauri-app-planning для Claude Code превращает требования к приложению на Tauri в план реализации. Он подключается при старте проекта, запросе архитектуры или распределении окон, состояния и событий. CX Codex +1 618установок app-primer-zero Legion Code Inc. Плагин app-primer-zero готовит репозиторий к разработке: собирает текущее состояние, контракты, схему и план волн. Нужен до начала реализации. CX Codex ★ 96звёзд репо

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

Весь набор →
canvas-screen-builder Субагент canvas-screen-builder для Claude Code добавляет или изменяет один экран в существующем Canvas App по общему контракту и заданию. Он выполняет локальную проверку без компиляции. CX Codex ★ 1 167звёзд репо code-app-architect Субагент code-app-architect помогает проектировать Power Apps код-приложения на React и Vite, интегрировать Dataverse, выбирать коннекторы и отлаживать сборку. CX Codex ★ 1 167звёзд репо add-pdf-viewer Скилл add-pdf-viewer настраивает обёртку для встроенного просмотра PDF по ссылкам HTTPS и локальным путям file:// в мобильных приложениях Power Platform. CX Codex +1 ★ 1 167звёзд репо add-pen-input Скилл add-pen-input помогает создать или проверить обёртку для рукописного ввода и подписи в мобильном приложении. Его вызывает /add-native для сценариев рисования, чернил и рукописного текста. CX Codex +1 ★ 1 167звёзд репо assemble-ppmplugin Скилл assemble-ppmplugin для Claude Code собирает .ppmplugin-бандл из манифеста и бинарников Android/iOS, проверяет их соответствие и упаковывает в архив. Запускается после /generate-ppmplugin-manifest и скиллов сборки. CX Codex +1 ★ 1 167звёзд репо add-geolocation Скилл add-geolocation помогает добавить в мобильное приложение фоновое GPS-отслеживание с сохранением данных и отправкой в Dataverse. Его вызывает команда /add-native geolocation. CX Codex +1 ★ 1 167звёзд репо diagnose-deployment Скилл diagnose-deployment для Claude Code ищет ошибки загрузки Power Pages и импорта решений в Dataverse. Запускается по просьбе разобраться с неудачным деплоем или исправить найденные проблемы. CX Codex +1 ★ 1 167звёзд репо assign-offline-profile Скилл assign-offline-profile привязывает пользователей и команды к профилю Mobile Offline в Dataverse, чтобы включить офлайн-синхронизацию в мобильных приложениях. CX Codex +1 ★ 1 167звёзд репо

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

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