Английский |

Навык для агентов кодирования, который превращает отчет о дизайне базы данных FileMaker в план миграции.

FileMaker экспортирует DDR как один большой XML-файл на файл базы данных. 300 МБ DDR — это десятки миллионов токенов, что гораздо больше, чем вписывается в контекст агента. Таким образом, навык сначала разбивает DDR на один текстовый файл на объект: каждый сценарий, таблица, макет, отношения, список ценностей, пользовательская функция, меню, учетная запись и набор привилегий. Агент читает каждый из этих файлов, классифицирует его и пишет план из того, что они говорят. Каждое утверждение в плане указывает на объектный файл.

Примеры миграции

Миграционные проекты, использующие этот навык.

• migrate-karbonfm: миграция KarbonFM, CRM FileMaker с открытым исходным кодом, в настольное приложение для macOS, Windows и Linux.

Что нужно

Кодирующий агент, который загружает навыки (Claude Code, Codex или аналогичные)

• Python 3. Никаких пакетов. Полный экспорт DDR XML: один XML-файл на файл FileMaker, плюс Summary.xml, если он у вас есть

DDR - это клиентские данные, и взорванные файлы несут все значения точно так же, как и DDR. Держите обе версии вне контроля.

##Установка

Клонируйте репо в папку навыков вашего агента.

migrate-filemaker

English | 日本語

A skill for coding agents that turns a FileMaker Database Design Report into a migration plan.

FileMaker exports a DDR as one large XML file per database file. A 300 MB DDR is tens of millions of tokens, far more than fits in an agent’s context. So the skill first breaks the DDR into one text file per object: every script, table, layout, relationship, value list, custom function, menu, account and privilege set. The agent reads every one of those files, classifies it, and writes the plan from what they say. Every claim in the plan points at an object file.

Migration examples

Migration projects that use this skill.

• migrate-karbonfm: migration of KarbonFM, an open-source FileMaker CRM, to a desktop app for macOS, Windows and Linux.

What you need

• A coding agent that loads skills (Claude Code, Codex, or similar)
• Python 3. No packages.
• The full DDR XML export: one XML file per FileMaker file, plus Summary.xml if you have it

The DDR is client data, and the exploded files carry every value exactly as the DDR has it. Keep both out of version control.

Install

Clone the repo into your agent’s skills folder. Then ask for $migrate-filemaker, or tell the agent to load SKILL.md.

How it works

1. Extract. explode_ddr.py writes one text file per object, an index.tsv of all of them, a LEGEND.md for the codes, and an unresolved.tsv of references to deleted or missing targets. It stops if any calculation or attribute check fails.
2. Inventory. Count what is there and how the files connect.
3. Read every object. Nine explorers (scripts, tables, layouts, graph, security, value lists, menus, custom functions, file settings) each read their kind and write one CSV row per object. catalog_contract.py verify proves nothing was skipped.
4. Ask. List what the DDR cannot answer: goals, users, identity, integrations, which behaviors to keep.
5. Plan. Write the schema, API, UI, business logic, authorization, data migration and cutover documents from the templates.

The skill records what the FileMaker solution does. It does not judge whether that logic is right.

What an object file looks like

A script reads the way Script Workspace shows it, with the ids a search needs. // marks a disabled step.

# script 12: Go Home
# file: Orders.fmp12