SkillRun
English

定位对比

MCP 解决调用。SkillRun 解决可执行能力如何变得可靠。

MCP、Agent Skills、SkillRun 处在不同层。SkillRun 不替代 MCP，也不替代 Agent Skills；它让可执行能力在暴露给本地客户端前，先拥有 package、contract、lifecycle 和 evidence。

MCP

调用面

定义 AI client 如何调用工具。它不负责判断一个能力是否被打包、检查、测试、安装或留证。

Agent Skills

作者与发现层

用 SKILL.md 和配套文件教会 Agent 一个工作流。它非常适合知识传递，但 Markdown 本身不是执行合同。

SkillRun

Runtime、contract 与 evidence 层

把 SOP-backed 能力变成 Skill Capsule，提供 Manifest 检查、类型化 action、preflight、artifact、run evidence 和可选 MCP Router 暴露。

每一层各自负责什么

跑通 5 分钟路径

核心职责

MCP 让 client 调用工具

Agent Skills 让 Agent 发现并学习工作流

SkillRun 让可执行 skill 可检查、可运行、可打包、可审计

产物形态

MCP Server 连接与 tool schema

Agent Skills SKILL.md 加 references、scripts、templates、examples

SkillRun .skr package、Manifest、registry entry、switchboard exposure 和 run evidence

执行边界

MCP 只定义协议形状

Agent Skills 依赖 Agent 遵守自然语言说明

SkillRun Manifest hash、permission、schema、preflight、structured envelope 和 fail-closed 检查

团队分发

MCP 每个人仍需要可信 server 或本地配置

Agent Skills 分享上下文容易，治理执行更难

SkillRun Team catalog 和 Desktop Team Library 可复核、计划并显式安装本地 package

它不是什么

MCP 不是 package manager 或 audit log

Agent Skills 单独看不是确定性 runtime

SkillRun 不是 marketplace、OS sandbox 或签名信任体系

我们推荐的团队路径

  1. 01 / Author

    编写 SKILL.md 和 action code，再从声明的 capsule boundary 生成 Manifest。

  2. 02 / Package

    运行 validate 和 pack，让 SOP、schema、permissions、examples 和 source hashes 一起作为 .skr artifact 移动。

  3. 03 / Review

    团队成员先 inspect catalog item，查看 install plan、checksum、warnings 和本地 registry 影响，再决定是否 apply。

  4. 04 / Expose

    只有本地 import 并显式 enable 后，Router 才通过 skillrun router serve --mcp 暴露被选择的能力。

保持叙事诚实的边界

  • SkillRun 不是 MCP-first；MCP 是已启用 Runtime Capsule 的一种调用面。
  • SkillRun 不替代 Agent Skills；当一个工作流需要可执行代码和 evidence 时，它补上运行合同。
  • 团队分发不是 Public Marketplace。当前路径是 local catalog、本地复核、显式安装、显式启用。
  • Checksum verification 证明完整性，不证明 publisher identity、sandbox 或业务信任。
  • SkillRun 不自动安装依赖，也不运行未知远程代码。