外观
Agent 任务路由
从 llms.txt 或本页选择任务;取对应 Markdown 获取详细步骤。 pluginctl 只打包一个 skill:skills/pluginctl/SKILL.md,内部路由到 package、publish、manage。
| 用户任务 | 路由与命令 |
|---|---|
| 检查或生成包 | 包格式,check / pack / verify |
| 创建并发布 | 发布,auth / publish |
| 查询、下载 | 下载,list / show / download |
| 审核、转让、停用 | 管理,review / manage / namespace-transfer |
| 结果未知、恢复 | 自动化,status / 原 journal |
输入与完成条件
注册名使用 namespace/name,不转换大小写或分隔符;先申请并获批 namespace。 Agent Plugin manifest 使用 name 段,Runtime Components 与 Preset 使用完整注册名。 修改前先读取 current revision 和权限。所有 mutation 使用原 command ID;publish 使用受保护 journal。 不要把 accepted 当作已完成,也不要为 unknown 创建新 ID。 公开交付完成需要 published、可见/启用以及实际下载原字节三种独立事实。
使用机器输出
sh
pluginctl list --distribution https://packages.example/ --authority <authority-uuid> --json
pluginctl show --name my-team/my-plugin --distribution https://packages.example/ --authority <authority-uuid> --jsonstdout 为 JSON,stderr 为诊断,非零退出即失败;解析契约字段,不从日志猜状态。