# Agent 任务路由

从 [llms.txt](/llms.txt) 或本页选择任务；取对应 Markdown 获取详细步骤。
pluginctl 只打包一个 skill：skills/pluginctl/SKILL.md，内部路由到 package、publish、manage。

| 用户任务         | 路由与命令                                                            |
| ---------------- | --------------------------------------------------------------------- |
| 检查或生成包     | [包格式](../developers/package.md)，check / pack / verify             |
| 创建并发布       | [发布](../developers/publish.md)，auth / publish                      |
| 查询、下载       | [下载](../users/download.md)，list / show / download                  |
| 审核、转让、停用 | [管理](../developers/manage.md)，review / manage / namespace-transfer |
| 结果未知、恢复   | [自动化](./automation.md)，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> --json
```

stdout 为 JSON，stderr 为诊断，非零退出即失败；解析契约字段，不从日志猜状态。