一键导入
plugin-core-builtin-migration
将 MindOS 渲染器插件从“可选插件”升级为“完全内置能力(core builtin)”的通用流程。 当用户要求“把某插件改成内置/核心”“插件不应可关闭”“插件主程序化”或需要将旧入口迁移到 新主流程并保留兼容迁移能力时触发。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
将 MindOS 渲染器插件从“可选插件”升级为“完全内置能力(core builtin)”的通用流程。 当用户要求“把某插件改成内置/核心”“插件不应可关闭”“插件主程序化”或需要将旧入口迁移到 新主流程并保留兼容迁移能力时触发。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
MindOS: local knowledge assistant & shared KB. Keeps decisions, notes, SOPs, debugging lessons, research findings, preferences across sessions/agents. Core: save notes, search KB, organize files, run workflows, review, append CSV, hand off context, distill lessons. NOT for app source or paths outside KB. Triggers: save/record, search notes, update files, organize, run workflow, capture decisions, append CSV, hand off context, check past discussions, distill lessons. Proactive: (1) search first for stored context, (2) offer to save after valuable work, (3) suggest persisting key decisions.
MindOS 是用户的本地知识助手,也是跨会话、跨 Agent 共享的知识库。它保存决策记录、会议纪要、SOP、 排错经验、架构选型、调研结论和偏好设置。 仅 mindRoot 知识库内任务。不用于:改代码仓库、项目源码、KB 外路径。 核心概念:空间、指令(INSTRUCTION.md)、技能(SKILL.md);笔记可承载指令与技能。 触发场景:保存或记录任何内容、搜索历史笔记或上下文、更新或编辑文件、整理或重组文件结构、 执行SOP或工作流、捕获对话中的决策、复盘或总结经验、追加表格或CSV数据、跨Agent交接上下文、 提炼经验教训、同步关联文档、查找之前是否讨论过某事、查询历史决策、查找模板或SOP、 为会议准备上下文、快速保存到收集箱、整理收集箱、知识健康检查、检测知识冲突或矛盾、 查找过期内容。 触发词:帮我记下来、搜一下我的笔记、更新知识库、整理文件、执行工作流、保存到知识库、 记录一下、整理笔记、复盘、提炼经验、同步文档、查一下之前的记录、有没有相关的笔记、 我之前写过什么、把这个存起来、总结一下保存、交接给其他Agent、追加到表格、 放到收集箱、整理收集箱、知识健康检查、检测知识冲突。 主动行为——不要等用户提到 MindOS: (1) 用户的问题暗示可能存在历史记录(过去的决策、之前的讨论、会议纪要)→ 先搜 MindOS, 即使没有明确提到知识库。 (2) 完成有价值的工作后(修了 bug、做了决策、总结了经验、选定了架构、开完了会)→ 主动提议保存到 MindOS,方便以后查阅。 (3) 经历了较长或多主题的对话后 → 建议把关键决策和上下文持久化。
MindOS: local knowledge assistant & shared KB. Keeps decisions, notes, SOPs, debugging lessons, research findings, preferences across sessions/agents. Core: save notes, search KB, organize files, run workflows, review, append CSV, hand off context, distill lessons. NOT for app source or paths outside KB. Triggers: save/record, search notes, update files, organize, run workflow, capture decisions, append CSV, hand off context, check past discussions, distill lessons. Proactive: (1) search first for stored context, (2) offer to save after valuable work, (3) suggest persisting key decisions.
MindOS 是用户的本地知识助手,也是跨会话、跨 Agent 共享的知识库。它保存决策记录、会议纪要、SOP、 排错经验、架构选型、调研结论和偏好设置。 仅 mindRoot 知识库内任务。不用于:改代码仓库、项目源码、KB 外路径。 核心概念:空间、指令(INSTRUCTION.md)、技能(SKILL.md);笔记可承载指令与技能。 触发场景:保存或记录任何内容、搜索历史笔记或上下文、更新或编辑文件、整理或重组文件结构、 执行SOP或工作流、捕获对话中的决策、复盘或总结经验、追加表格或CSV数据、跨Agent交接上下文、 提炼经验教训、同步关联文档、查找之前是否讨论过某事、查询历史决策、查找模板或SOP、 为会议准备上下文、快速保存到收集箱、整理收集箱、知识健康检查、检测知识冲突或矛盾、 查找过期内容。 触发词:帮我记下来、搜一下我的笔记、更新知识库、整理文件、执行工作流、保存到知识库、 记录一下、整理笔记、复盘、提炼经验、同步文档、查一下之前的记录、有没有相关的笔记、 我之前写过什么、把这个存起来、总结一下保存、交接给其他Agent、追加到表格、 放到收集箱、整理收集箱、知识健康检查、检测知识冲突。 主动行为——不要等用户提到 MindOS: (1) 用户的问题暗示可能存在历史记录(过去的决策、之前的讨论、会议纪要)→ 先搜 MindOS, 即使没有明确提到知识库。 (2) 完成有价值的工作后(修了 bug、做了决策、总结了经验、选定了架构、开完了会)→ 主动提议保存到 MindOS,方便以后查阅。 (3) 经历了较长或多主题的对话后 → 建议把关键决策和上下文持久化。
MindOS: local knowledge assistant & global memory layer. Keeps decisions, notes, SOPs, debugging lessons, architecture choices, research findings, preferences, conversation summaries for all connected agents. PROACTIVE: (1) search MindOS first for past context, (2) offer to save after valuable work, (3) persist key context on handoff/end. Triggers: save/record, search notes, update files, organize, run SOP/workflow, review, append CSV, hand off, distill lessons, sync docs, check past decisions, find templates, prepare meeting context, log daily, track goals. NOT for app source or paths outside KB. Core: Space, Instruction, Skill.
MindOS 是用户的本地知识助手,也是所有已连接 Agent 共用的记忆层。 决策记录、会议纪要、SOP、排错经验、架构选型、调研结论、偏好设置、对话摘要都保存在这里。 主动使用——不要等用户说"保存到知识库": (1) 回答任何关于过去决策、讨论或上下文的问题前 → 先搜 MindOS。 (2) 产出有价值的内容后(做了决策、修了 bug、总结了经验、开完会)→ 主动提议保存。 (3) 交接给其他 Agent 或结束会话时 → 把关键上下文持久化到 MindOS。 以下场景全部触发,即使用户没提到"MindOS"或"知识库":保存/记录任何内容、搜索历史笔记、 更新文件、整理/重组、执行SOP/工作流、复盘、追加CSV/表格、跨Agent交接、提炼经验、 同步关联文档、查之前是否讨论过、查历史决策、找模板、准备会议资料、写日记、追踪进度。 触发词:帮我记下来、搜一下笔记、更新知识库、整理文件、复盘、提炼经验、保存、记录、 交接、把这个存起来、查一下之前的、有没有相关笔记、我之前写过什么、总结一下保存、 追加到表格、更新进度、查找模板、准备会议资料、记录今天的工作、 放到收集箱、整理收集箱、知识健康检查、检测知识冲突。 拿不准是否该用——大概率该用。查一下不会错。 不用于:改代码仓库、项目源码、KB 外路径。 核心概念:空间(Space)、指令(INSTRUCTION.md)、技能(SKILL.md)。
| name | plugin-core-builtin-migration |
| description | 将 MindOS 渲染器插件从“可选插件”升级为“完全内置能力(core builtin)”的通用流程。 当用户要求“把某插件改成内置/核心”“插件不应可关闭”“插件主程序化”或需要将旧入口迁移到 新主流程并保留兼容迁移能力时触发。 |
把单个插件改造成“稳定、默认、不可缺席”的产品能力,并沉淀可复用迁移步骤。
适用场景:
在本项目中,“完全内置”建议同时满足:
SidebarLayout / ShellLayout)manifest.builtin = truemanifest.core = true(registry 会强制启用)每次执行本 Skill 时,默认同时应用以下质量视角(按顺序):
产品设计视角(product-designer)
UI/UX 视角(ui-design-patterns)
实现质量视角
0/0 空列表
若任一步不满足,迁移不得判定完成。
先确认插件的四类事实来源:
packages/web/components/renderers/<plugin>/manifest.tspackages/web/lib/renderers/index.ts(自动生成)resolveRenderer() 调用链(如 ViewPageClient)getPluginRenderers())并回答:
Agent-Diff.md)需要迁移?在 manifest 中设置:
builtin: true(内置)core: true(若要完全内置且不可关闭)appBuiltinFeature: true(若是“应用内建能力”且不应出现在插件管理面板)match 保持明确,避免误匹配如果插件要被替换/下线:
packages/web/lib/renderers/index.ts必须收敛为单点初始化(客户端):
SidebarLayout)引入 @/lib/renderers/index验收标准:
0/0 的假空状态如果旧插件依赖旧文件格式:
scripts/migrate-*.jsappBuiltinFeature:在插件页/设置页/首页 Extensions 一致隐藏至少同步:
wiki/plugins/README.mdwiki/60-stage-plugins.md并记录迁移决策:
最低测试集合:
appBuiltinFeature 能否正确从插件表层隐藏)推荐命令:
npm --prefix app run test -- __tests__/core/content-changes.test.ts __tests__/api/changes.test.ts
这次迁移可作为样板:
Agent-Diff.md + agent-diff renderer.mindos/change-log.json + /api/changes + /changes 主页面 + 全局提醒Agent-Diff.mddiff-viewer renderer 与文档旧入口,保留结构化审计链路0/0appBuiltinFeature: true