运行你的第一个工厂

从内置目录安装一个打包工厂,并在不编写任何配置的情况下完整运行它。

它是什么

打包工厂是拥有 @you/goal 这类规范名称的完整已发布工作流。你只需提供请求;图、工作单元、评审步骤和参数约定都由工厂提供。二进制文件中随附了 15 个,覆盖目标推进、评审循环、并行扇出、锦标赛式比选、深度研究和文本转语音。

何时使用

安装完成后、动手写自己的东西之前,先运行一个。打包运行能证明安装可用、提供方已配置好,并让你在必须自己编写之前先看清一次工厂运行的形态。

步骤

把一个打包工厂安装到具名工厂根目录,确认它已就位,然后带上请求运行它。@you/goal 是最佳的第一选择:它会持久化进度,并持续推进目标,直到执行方判定完成或受阻。

从内置目录安装一个打包工厂

you init --package @you/goal

确认它已落到全局具名工厂根目录

you factory list --dir ~/.you-agent-factory/factories

带上请求运行它

you run --named @you/goal "Summarise this repository"
调用输入有三种方式传给工厂:命令后的位置文本、管道传入的标准输入,或工厂声明的具名参数。要传一段无需转义引号的长请求,管道最省事。
echo "Summarise this repository" | you run --named @you/goal

只打印最终结果,不流式输出进度

you run --named @you/goal --output primary "Summarise this repository"

观察运行过程

普通运行不会启动 HTTP 监听器——它以批处理模式执行,工作稳定后即退出。想看图的流转时,请显式要求内置仪表盘:监听器只绑定回环地址,生命周期与本次运行完全一致,就绪后打开一次浏览器。
you run --named @you/goal --with-site "Summarise this repository"
如果你希望在运行期间开放 HTTP API 但不打开浏览器窗口,就使用服务器参数而不启用仪表盘。无论哪种方式,监听器都会在运行结束时消失。
you run --named @you/goal --with-server "Summarise this repository"

列出该运行中主机上的会话

you session list

试试别的工厂

每个打包工厂都声明自己的参数,因此同样这两条命令适用于整个目录。@you/review 产出候选成果并反复进行独立评审直至通过;@you/quorum 并行执行多份独立评估并合并;@you/spawn 规划确切数量的任务并并发执行。
you init --package @you/review
you run --named @you/review "Draft the release notes"
每个打包工厂都公布了自己的参数名、默认值和实际示例。在猜参数之前先读它们。

常见陷阱

打包工厂同样需要一个提供方来驱动它的工作单元。如果运行几乎立刻结束且没有输出,通常原因是没有配置默认提供方,而不是工厂本身有问题。另外,调用输入是必需的:既没有位置文本也没有管道输入的具名运行没有可处理的内容。

下一步

当某个打包工厂做的事已经接近你的需求但还不够时,下一步就是自己写一个——或者把整个目录交给智能体,让它来挑选。

标签