Навыки troubleshooting-motoko-migrations

📦

troubleshooting-motoko-migrations

Name: troubleshooting-motoko-migrations
Author: caffeinelabs

v0.1.5 Ревизия содержимого r1 Безопасно ⚙️ Внешние команды

Troubleshoot Motoko Migration Failures

Motoko migration errors can conflict with current source code and put deployed state at risk. This reference explains diagnostics and forward-only repairs while preserving migration history.

Поддерживает: Claude Codex Code(CC)

🥈 82 Серебро

Maintain this Skill? Claim it 🥈 82 Серебро

Установить с помощью моего Агента

Скопируйте этот запрос в своего Агента. Он содержит каноническую страницу Skill и манифест.

Запрос агента

Review the Skillstore skill "troubleshooting-motoko-migrations" from https://skillstore.io/skills/caffeinelabs-troubleshooting-motoko-migrations.md and its manifest at https://skillstore.io/api/skills/caffeinelabs-troubleshooting-motoko-migrations/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Ваш Агент по-прежнему должен показать план и запросить все подтверждения, требуемые политикой безопасности.

Ресурсы для AI-агентов

Используйте эти ссылки, когда AI-агенту, crawler или script нужен чистый контекст вместо полной страницы.

Markdown-детали GET /skills/caffeinelabs-troubleshooting-motoko-migrations.md Подписанный manifest GET /api/skills/caffeinelabs-troubleshooting-motoko-migrations/manifest Подписанный lockfile GET /api/skills/caffeinelabs-troubleshooting-motoko-migrations/lockfile

Протестировать

Использование «troubleshooting-motoko-migrations». A write to an applied migration failed while adding a stable field.

Ожидаемый результат:

The read-only file represents deployed history and must remain unchanged.
Express the field addition in a new migration that transforms the current state.
Confirm the new migration supplies the field before deployment.

Использование «troubleshooting-motoko-migrations». The first migration in a converted project has a non-empty OldActor.

Ожидаемый результат:

A non-empty baseline is expected when state predates the enhanced migration chain.
Preserve the conversion baseline and existing values rather than replacing them with an empty state.
Compare the baseline with the deployed stable signature if diagnostics remain unexplained.

Использование «troubleshooting-motoko-migrations». The build and checker pass, but installation fails with IC0505 on a long migration chain.

Ожидаемый результат:

The diagnostic may indicate that stable-type history exceeds the platform custom-section limit.
Successful build checks alone do not establish that the artifact can be installed.
Stop adding migrations and report the platform limit rather than deleting history or retrying the same artifact.

Аудит безопасности

Безопасно

v1 • 02.10.2026 Открыть версионный отчет

All 37 static findings are false positives: 35 match Markdown backticks, and two misclassify canister installation diagnostics as system reconnaissance. The reference discourages permission bypasses, migration history rewrites, and unsafe configuration changes. No evidence found of prompt injection, credential collection, exfiltration, or malicious execution.

Просканировано файлов

135

Проанализировано строк

Пункты проверки

Ложные срабатывания проигнорированы

Факторы риска

Последний завершенный статический и семантический аудит не обнаружил подтвержденных проблем безопасности. Это не доказывает отсутствие побочных эффектов у навыка.

Аудитор:: codex

Поделиться и цитировать этот отчет

Делитесь версионным отчетом об оценке, нейтральным значком, встраиваемой карточкой и цитатами. Skillstore публикует доказательства, не решая, безопасен ли этот Skill.

Открыть версионный отчет

Копировать ссылку на отчёт

https://skillstore.io/skills/caffeinelabs-troubleshooting-motoko-migrations/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Значок Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/caffeinelabs-troubleshooting-motoko-migrations/security.svg)](https://skillstore.io/skills/caffeinelabs-troubleshooting-motoko-migrations?utm_source=security_passport_badge)

Значок HTML

<a href="https://skillstore.io/skills/caffeinelabs-troubleshooting-motoko-migrations?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/caffeinelabs-troubleshooting-motoko-migrations/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Встраиваемая карточка

<iframe src="https://skillstore.io/embed/skills/caffeinelabs-troubleshooting-motoko-migrations.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Академические ссылки (APA · BibTeX · CFF)

Цитата APA

caffeinelabs. (2026). troubleshooting-motoko-migrations security audit report (audit version 1) [Author version 0.1.5]. Skillstore. https://skillstore.io/skills/caffeinelabs-troubleshooting-motoko-migrations/audits/1

Цитата BibTeX

@techreport{caffeinelabs-caffeinelabs-troubleshooting-motoko-migrations-2026,
  author = {caffeinelabs},
  title = {troubleshooting-motoko-migrations security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/caffeinelabs-troubleshooting-motoko-migrations/audits/1},
  note = {Author version 0.1.5}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "troubleshooting-motoko-migrations security audit report (audit version 1)"
version: "0.1.5"
type: report
authors:
  - name: "caffeinelabs"
date-released: "2026-10-02"
url: "https://skillstore.io/skills/caffeinelabs-troubleshooting-motoko-migrations/audits/1"
identifiers:
  - type: other
    value: "skillstore:caffeinelabs-troubleshooting-motoko-migrations:audit:1"
    description: "Skillstore immutable audit report identifier"

Оценка Skillstore

Почему такая оценка Достоверность доказательств: Средний

Архитектура

100

Сопровождаемость

Контент

Сообщество

100

Соответствие спецификации

Что вы можете построить

Explain Unexpected Compatibility Errors

Trace checker fields absent from current source to the deployed stable signature and identify the appropriate pending migration changes.

Review a Converted Project Baseline

Review a non-empty first migration baseline and preserve legacy state when maintaining a converted or forked project.

Investigate Installation Failures

Assess IC0505 installation errors, chain growth, and protected configuration without bypassing platform controls.

Попробуйте эти промпты

Understand a Diagnostic

Explain this Motoko migration diagnostic: [diagnostic]. Identify likely causes, needed evidence, and safe next steps without changing files.

Handle a Frozen Migration

A write failed on this migration: [filename]. Review [deployment history] and [requested state change]. Distinguish pending from applied changes and propose a forward-only repair.

Review a Legacy Conversion

Review [first migration], [current actor declarations], and [deployed stable signature] for a converted project. Explain the baseline and flag assumptions before proposing changes.

Investigate a Chain Mismatch

Compare [diagnostics], [migration chain], [mops configuration], and [deployed stable signature]. Assess history consistency and installation risks. Preserve protected configuration and produce an escalation report for unresolved mismatches.

Лучшие практики

Compare diagnostics with the deployed stable signature, not only local source or version history.
Preserve applied migration identities and consolidate related unapplied changes into one pending migration.
Keep actor bodies static and stable types lean; escalate unexplained signature mismatches before deployment.

Избегать

Editing, renaming, deleting, or changing permissions on frozen applied migrations to bypass a failure.
Replacing a converted baseline with empty state or reseeding fields that contain live data.
Relaxing protected configuration, removing the chain, or treating successful build checks as proof of installability.

Часто задаваемые вопросы

When should I use this skill?

Use it for unexplained migration diagnostics, frozen files, converted baselines, or requests to remove the migration chain.

Does it automatically repair or deploy a canister?

No. It provides reference guidance and diagnostic reasoning, not bundled repair scripts or deployment automation.

Why does the checker mention fields absent from current source?

The checker compares against the deployed stable signature, which can contain fields from an earlier version.

Can I edit an already-applied migration?

No. Applied migrations are tracked by module name and skipped on later upgrades. Express further changes through a new migration.

Can an enhanced migration project return to legacy persistence?

The reference describes no supported downgrade path. Preserve the chain and use a forward-only migration to achieve the requested state changes.

Does a successful build and check guarantee installation?

No. Chain history can exceed installation limits even when builds and checks pass. Investigate IC0505 and escalate platform limits.

Сведения для разработчиков

Автор

caffeinelabs

Лицензия

MIT

Версия автора

v0.1.5

Ревизия Skillstore

Репозиторий

https://github.com/caffeinelabs/skills/tree/9e40da604ff8f08f291943f935445c78fd8a36f8/skills/troubleshooting-motoko-migrations

Ссылка

a127f0a133fc1587fa1a973bd2251d5de5be4f4e

Актуальность поддержки

02.10.2026

Использование

0 загрузок · 0 просмотров

Структура файлов

📄 SKILL.md