核心概念
Tools、Skills 与 Commands
选择正确的能力单元，避免把执行、方法和用户入口混在一起。
Tool：执行与授权单元
Tool 接收结构化输入，返回结构化输出。每个 Tool 都单独声明：
- 输入与输出 Schema；
- 风险与副作用；
- 网络范围；
- 超时、单 Run 调用上限和并发方式；
- 默认禁用、允许或需要确认。
Tool 是平台进行验证、授权、审计和结果展示的最小单位。
Skill：按需加载的方法
Skill 是一份带名称和描述的 Markdown 指令。Runtime 先用简短描述做匹配，只在相关请求中加载完整正文，而不是把全部 Skill 塞进每次上下文。
---
name: meeting-summary
description: Turn raw meeting notes into decisions, owners, and follow-ups.
---
先列出决定，再列出行动项。每个行动项必须有负责人，或者标记为未分配。Manifest 中的 id、Skill frontmatter 的 name 和目录命名应保持一致。
Command：显式用户入口
Command 是一个具名的提示模板，适合“整理会议纪要”这类主动入口。Alpha 已能解析并在 Plugin 详情中展示 Command，但还没有接入聊天里的用户触发入口。
因此当前测试应由自然语言触发 Tool/Skill，不要把 Command 当作已完成的交互能力。
如何选择
| 需求 | 使用 |
|---|---|
| 调外部 API、读写状态、计算结构化结果 | Tool |
| 教 Agent 遵循某种专业流程 | Skill |
| 给用户一个明确可点的任务入口 | Command |
| 把它们作为一个产品安装、配置和展示 | Plugin |
同一个 Plugin 可以组合多种贡献，但不要为了“看起来完整”加入没有真实用途的能力。