plugin-development

name	plugin-development
description	Madorin 插件开发入口技能。用于统一编排 Native、MCP、Process 三类通道，约束工程规范、外部包 AOT 校验、发布安装与运行时更新流程。触发关键词：插件开发、Native 插件、MCP 插件、Process 插件、进程插件、发布插件、安装插件。
version	7
user-invocable	true

Plugin Development

Structure

• 主技能目录：plugin-development
• 子技能目录：subskills
• 共享脚本目录：scripts
• 子技能可有独立 scripts 和 resources；需要复用时由子技能脚本包装共享脚本

Entry Flow

1. 先判断插件通道：Native（AOT DLL）、Process（任意 exe）、MCP（远程服务）。
2. 读取 subskills/architecture/SKILL.md。
3. 需要外部包时读取 subskills/packages/SKILL.md。
4. 按通道读取对应子技能：
   • Native → subskills/native/SKILL.md
   • Process → subskills/process/SKILL.md
   • MCP → subskills/mcp/SKILL.md
5. Native 或 Process 必须先完成本地调试验证，再进入发布。
6. Native 或 Process 需要发布/安装/更新时读取 subskills/publish-install/SKILL.md；MCP 场景走连接配置，不走插件包安装。

Mandatory Rules

• 所有插件代码默认遵循职责分离和依赖注入。
• 新增外部包前必须先查最新稳定版，再做 AOT 发布探测。
• 运行时安装和更新必须走 skill-plugin-installation，不手工复制文件。
• 更新已加载插件必须调用 sys_list_loaded_plugins → sys_unload_plugin → 安装脚本 → sys_reload_plugin。
• 新开发优先选择 Native（AOT 性能最优）或 MCP（远程服务）；需要完整 JIT 生态时选择 Process 通道。
• C# 插件发布前必须本地调试通过；Native 使用 Netor.Cortana.Plugin.Native.Debugger，Process 使用 Generator 生成的 {PluginClass}Debugger。
• 不要手写 Native/Process 宿主协议、工具路由、消息循环或 plugin.json，这些由框架和 Generator 负责。

Debug Policy

通道	调试方式	最低要求
Native C#	运行脚手架生成的 Debug\*.Debug.csproj，通过 PluginDebugRunner 进入 REPL	dotnet build 成功；REPL 能发现唯一 [Plugin]；每个 [Tool] 至少调用一次
Process C#	dotnet run -- --self-test，使用 {PluginClass}Debugger 强类型调用工具	InitAsync() 成功；每个 [Tool] 至少调用一次；失败时返回非 0 退出码
MCP	连接配置校验和服务可达性验证	配置校验通过；服务能正常响应

Native 调试验证的是开发态托管程序集逻辑；发布前仍必须执行 Native AOT 发布验证。Process 调试器通过内存管道走同一消息循环路径，不要再手工拼协议 JSON。

Default Commands

scripts\setup-dev-environment.ps1
scripts\create-native-plugin.ps1 -Name MyPlugin -Id my_plugin
dotnet run --project Samples\MyPlugin\Debug\MyPlugin.Debug.csproj
scripts\create-process-plugin.ps1 -Name MyPlugin -Id my_plugin
dotnet run --project Samples\MyPlugin -- --self-test
subskills\mcp\scripts\validate-mcp-server-config.ps1 -TransportType stdio -Name github -Command npx -Arguments '-y','@modelcontextprotocol/server-github'
scripts\resolve-package-version.ps1 -PackageId Polly
scripts\test-aot-package.ps1 -PackageId Polly

Dispatch

场景	读取文件
设计/重构/规范问题	subskills/architecture/SKILL.md
Native AOT 插件	subskills/native/SKILL.md
MCP 服务接入	subskills/mcp/SKILL.md
Process 进程插件（JIT/AOT exe）	subskills/process/SKILL.md
第三方包 AOT 评估	subskills/packages/SKILL.md
发布/安装/热更新（Native/Process）	subskills/publish-install/SKILL.md