plugin-core-builtin-migration
将 MindOS 渲染器插件从“可选插件”升级为“完全内置能力（core builtin）”的通用流程。 当用户要求“把某插件改成内置/核心”“插件不应可关闭”“插件主程序化”或需要将旧入口迁移到 新主流程并保留兼容迁移能力时触发。
npx skills add GeminiLight/MindOS --skill plugin-core-builtin-migration --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Plugin Core Built-in Migration 把单个插件改造成“稳定、默认、不可缺席”的产品能力，并沉淀可复用迁移步骤。 适用场景： - 某插件已经成为核心体验（例如 TODO、CSV、配置、变更中心） - 旧插件入口要退役，但历史数据要可迁移 - 需要避免“某页面漏 import 导致插件空列表”这类注册漂移 --- ## 目标定义（先对齐） 在本项目中，“完全内置”建议同时满足： 1. **注册稳定**：渲染器注册有且仅有一个**客户端根入口**（推荐 `SidebarLayout` / `ShellLayout`） 2. **默认可用**：`manifest.builtin = true` 3. **不可禁用**（如需真正 core）：`manifest.core = true`（`registry` 会强制启用） 4. **可观测可维护**：插件页、设置页、文档、测试一致 5. **历史兼容**：旧入口数据有迁移方案，不丢内容 6. **表层语义清晰**：区分“插件（可管理）”和“应用内建能力（不在插件面板展示）” --- ## 质量闸门（必走） 每次执行本 Skill 时，默认同时应用以下质量视角（按顺序）： 1. **产品设计视角**（`product-designer`） - 检查信息层级、任务路径、主次操作、反馈时机 - 明确“主路径 3 步内可完成”，避免迁移后流程变长 2. **UI/UX 视角**（`ui-design-patterns`） - 检查按钮层级、交互一致性、空状态/错误状态/加载状态 - 禁止无意义下划线链接滥用；主 CTA 与次级 CTA 视觉层级明确 - 深色模式可读性必须通过（按钮文字对比、tag 对比、focus 可见） 3. **实现质量视角** - 迁移逻辑幂等（重复执行不重复导入） - 注册机制单点化（禁止多处散落 import 造成漂移） - 避免仅服务端注册导致客户端 `0/0` 空列表 - 兼容代码失败不阻断主流程（best-effort + 可观测） 4. **验证视角** - 最少通过：core/API 回归测试 + lint - UI 变更至少进行一次人工检查（亮色/暗色） 若任一步不满足，迁移不得判定完成。 --- ## 执行流程（通用） ### Step 1) 盘点现状与边界 先确认插件的四类事实来源： - 代码入口：`packages/web/components/renderers/<plugin>/manifest.ts` - 注册入口：`packages/web/lib/renderers/index.ts`（自动生成） - 使用入口：`resolveRenderer()` 调用链（如 `ViewPageClient`） - 展示入口：插件面板/设置页（优先使用 `
- 目标定义（先对齐）
- 质量闸门（必走）
- 执行流程（通用）
- Step 1) 盘点现状与边界
- Step 2) 升级插件声明
- Step 3) 统一注册机制（防漂移）
- Step 4) 历史兼容迁移（关键）
- Step 5) UI/UX 对齐
- Step 6) 文档与知识同步
- Step 7) 测试与回归
- AgentDiff -> Built-in 的参考映射
- 常见坑位清单
- 交付 Checklist（可复制）
npm --prefix app run test -- __tests__/core/content-changes.test.ts __tests__/api/changes.test.ts
What does the plugin-core-builtin-migration skill do?
将 MindOS 渲染器插件从“可选插件”升级为“完全内置能力（core builtin）”的通用流程。 当用户要求“把某插件改成内置/核心”“插件不应可关闭”“插件主程序化”或需要将旧入口迁移到 新主流程并保留兼容迁移能力时触发。
How do I install it?
Run `npx skills add GeminiLight/MindOS --skill plugin-core-builtin-migration --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From GeminiLight/MindOS, a repository with 657 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.